=== Events Shortcodes For The Events Calendar ===
Contributors: narinder-singh, satindersingh, coolplugins
Donate link: https://paypal.me/CoolPlugins/50USD/
Tags: shortcode, the events calendar, event, calendar, coolplugins
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 2.5.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Easily add The Events Calendar shortcode or Gutenberg event block on any page and show upcoming events list.

== Description ==

[Events Shortcodes](https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=top_description) is an addon for The Events Calendar plugin that adds the missing shortcode functionality to The Events Calendar plugin. With this plugin, you can easily display your events on any page or post.

https://www.youtube.com/watch?v=uL3ToWGncbM

Whether you want to display your events in a list, grid, timeline, or minimal list layout, this plugin makes it simple by adding a shortcode. It’s a time-saving tool that allows you to highlight key events in a visually appealing way without needing advanced coding skills.

[Check Plugin Demos](https://eventscalendaraddons.com/demos/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=check_demos) | [Get Pro](https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=get_pro#pricing)

### Free Version Demos
[Events List](https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_list)|[Events Timeline](https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-timeline/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_timeline)|[Events Minimal List](https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-minimal-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=minimal_list)
#Pro Version Demos
[Events Grid](https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-grid/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_grid)|[Events Carousel](https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-carousel/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_carousel)|[Events Slider](https://eventscalendaraddons.com/demos/events-shortcodes-pro/events-slider/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo&utm_content=events_slider)

### Key Features
* **Shortcode Friendly:** Easily generate and customize shortcodes with different parameters. Just copy, paste, and display events anywhere on your site.
    * **Shortcode:**[events-calendar-templates category="all" template="default" style="style-1" date_format="default" start_date="" end_date="" limit="10" order="ASC" hide-venue="no" time="future" socialshare="no"]
* **Multiple Layouts:** The events shortcode plugin offers a variety of layouts, such as List, Minimal, or Timeline layouts. You can select one according to your website’s design.
* **Pre-defined Styles:** You can choose a predefined style for the selected layout according to your preferences.
* **Date Formats:** Easily customize how dates are displayed by choosing from various formats. Whatever format you prefer, it will automatically be applied to the shortcode.
* **Event Type:** Choose how you want your events to be displayed. Show upcoming events to highlight future opportunities, past events to showcase your achievements, or both for a complete overview.
* **Order & Sorting:** You can sort events in ascending or descending order based on their dates to display the oldest or newest events.
* **Number of Events:** Set a limit for how many events you want to display.
* **Filter Events:** Use filters to display particular events by category.
* **Date-Based Event:** Easily show events between specific dates. This means you can choose to showcase events between any dates, whether a particular week, month, or custom time period.
* **Compatibility with Elementor:** Events Shortcode easily integrates with Elementor, allowing you to display your events effortlessly. You can add and customize events on your pages without any complex coding.
* **Fully Responsive:** This plugin is fully responsive, ensuring that your events display perfectly on all screen sizes.

### Upgrade to Pro Features
* **Filter events:** Easily filter events by category, venue, or organizer.
* **Search & filter bar:** Add a search and filter bar for improved navigation.
* **Advanced layouts:** Access layouts such as Grid, Timeline, Carousel, Masonry, Accordion, and Calendar.

[Upgrade to Pro](https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=events_shortcode_pro#pricing)

### More Addons For The Events Calendar
In addition to the Events Shortcodes plugin, there are more addons available to extend the features of The Events Calendar plugin:

* **[Events Single Page Builder Pro](https://eventscalendaraddons.com/plugin/event-single-page-builder-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=epta_more_addons)**- Design stunning single event pages with Elementor using pre-built templates and 20+ customizable widgets.
* **[Events Widgets Pro](https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=ectbe_more_addons)**- Show events list, grid, carousel, and more in Elementor pages using The Events Calendar Elementor Widgets.
* **[Events Calendar Modules for Divi](https://wordpress.org/plugins/events-calendar-modules-for-divi/)**- Display The Events Calendar Events directly inside Divi with Customizable List or Grid Layouts.

**DISCLAIMER:** Events Shortcode For The Events Calendar plugin is developed by the Cool Plugins team and is not affiliated with or developed by the official team of The Events Calendar plugin, which is a part of StellarWP, the software arm of Liquid Web. Some of the links in this content may be affiliate links, which means we may earn a commission at no extra cost to you if you purchase through these links.

### ✍ Special Thanks!
Special thanks to the famous **[The Events Calendar ⇗](https://theeventscalendar.pxf.io/plugin)** plugin authors for creating an awesome plugin for events management.

== Installation ==
* Install the **Events Shortcode** For The Events Calendar plugin by searching for "events shortcodes" in your website's WP-admin dashboard under **Plugins > Add New**. You can also upload the plugin-zip unzipped folder to the **/wp-content/plugins** directory. Note that you must first install the free plugin The Events Calendar to use this plugin's features.
* Activate the plugin by going to **Plugins > Installed Plugins** menu inside your wp-admin dashboard.
* Now, you can easily add the shortcode anywhere on your site and customize the display of your events


Note that you must create/post events using the **The Events Calendar** plugin before displaying your events list through this addon shortcode.

== Frequently Asked Questions ==

= Can I customize the appearance of the events displayed? =
Yes. You can:
* Choose from multiple layouts (List, Timeline, Minimal)
* Select predefined styles
* Adjust date formats, event order, and number of events
* Filter by categories or date range

= What kind of layouts are available in the free version? =
You can display events in:
* List layout
* Minimal layout
* Timeline layout
These layouts are mobile-friendly and designed to match your website's style.

= Can I filter and sort the events? =
Yes. You can:
* Filter events by category or date range
* Display past, upcoming, or all events
* Sort by date using ASC (oldest first) or DESC (newest first)

= What is a plugin shortcode? =
You can display events using this shortcode:[events-calendar-templates category="all" template="default" style="style-1" date_format="default" start_date="" end_date="" limit="10" order="ASC" hide-venue="no" time="future" socialshare="no"]
This shortcode supports multiple parameters to control layout, styling, filtering, and sorting.

= What is the Events Shortcodes plugin? =
Events Shortcodes is an addon for The Events Calendar plugin. It adds shortcode support so you can display events in different layouts on any WordPress page or post.

= Can I use this inside Gutenberg editor? =
Yes, this addon is fully compatible with Gutenberg editors. Simply search for the “Events Calendar Shortcode” block and insert it into your content.

= Will this plugin comply with GDPR? =
Yes, this plugin is GDPR compliant. It doesn’t store or track any visitor data without consent. On plugin deactivation, a feedback form is shown, but it’s optional and does not collect personal data unless the user shares it.

= Is this plugin mobile-friendly? =
Absolutely. The plugin is fully responsive and optimized for all screen sizes, including tablets and smartphones.

= How can I report security bugs? =
You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities [Report a security vulnerability](https://patchstack.com/database/vdp/template-events-calendar).

== Screenshots ==
1. Events List Template Style 1
2. Events Minimal List Styles
3. Events List Template Style 2
4. Events List Template Style 3
5. Events Shortcodes Settings Panel
6. The Events Calendar Shortcode Generator
7. The Events Calendar Gutenberg Block
8. Elementor Page Builder Widget Preview

== Changelog ==

= Version 2.5.2 | November 18, 2025 =
* Improved: Rating div styling.
* Tested upto: The Events Calendar version 6.15.11

= Version 2.5.1 | September 18, 2025 =
* Fixed: Issue with load google fonts on events block.
* Improvement: Other plugins recommendations.
* Tested upto: The Events Calendar version 6.15.4


= Version 2.5.0 | September 05, 2025 =
* Added: Support for Arial font family in the Events block.
* Added: Month header option for the Events block.
* Added: background color customization in the minimal list layout for the Events block..
* Added: month translation in the Events block.
* Fixed: Addressed security vulnerabilities.
* Fixed: Minor CSS fixes.
* Fixed: 50 + Events loading issue on the editor side for the Events block.
* Improvements: Code Improved

= Version 2.4.10 | September 02, 2025 =
* Updated: Internal Links.

= Version 2.4.9 | August 18, 2025 =
* Fixed: Security issues.
* Improved: Minor code improvements.
* Tested upto: WordPress version 6.8.2
* Tested upto: The Events Calendar version 6.14.2

= Version 2.4.8 | June 24, 2025 =
* Updated: UTM Link.
* Updated: Readme.

= Version 2.4.7 | June 10, 2025 =
* Added: User opt-in option in plugin.
* Improved: Minor code improvements.
* Tested The Events Calendar V6.13.2.1.

= Version 2.4.6 | April 18, 2025 =
* Fixed: Settings Issue.
= Version 2.4.5 | April 17, 2025 =
* Tested Upto: Tested upto with WordPress V6.8 and The Events Calendar V6.11.2.

= Version 2.4.4 | November 22, 2024 =
* Added: Events Shortcode Gutenberg Block.
* Fixed: Resolved an issue with the load_plugin_textdomain() function, ensuring correct localization.
* Tested Upto: Tested upto with WordPress V6.7 and The Events Calendar V6.8.2.

= Version 2.4.3 | September 18, 2024 =
* Tested Upto: Tested upto with WordPress V6.6.2 and The Events Calendar V6.6.4.2
* Fixed: Minor Security Issues.

= Version 2.4.2 | July 23, 2024 =
* Tested Upto: Tested upto with WordPress V6.6 and The Events Calendar V6.6.0

= Version 2.4.1 | May 07, 2024 =
* Added: Get started page to know how to use our plugin.
* Fixed: Image link in list style 2 and 3.
* Fixed: Category slug issue while showing events for particular category in WPBakery Page Builder.
* Updated: Shortcode attributes under plugin settings.

= Version 2.4.0 | January 31, 2024 = 
* Improvements: Designs HTML and CSS
* Improvements: New Default value for style settings

= Version 2.3.3 | Nov 07, 2023 =
* Fixed: Wrong string output on frontend.

= Version 2.3.2 | Nov 06, 2023 =
* Fixed: Minor Vulnerability Fix.
* Fixed: Fatal error issue with serch element in Avada Theme.
* Depreciated: Shortcode Generator.

= Version 2.3.1 | Mar 29, 2023 =
* Improved: Minor textual changes.
* Improved: Updated links.
* Improved: Dashboard Code.
* Improved: Feedback Form.

= Version 2.2.6 | Mar 02, 2023 =
* Improved: Minor textual changes.
* Improved: Updated links.

= Version 2.2.5 | Dec 05, 2022 =
* Added: Update Find Out More Settings.
* Fixed: Time function parameter issue.

= Version 2.2.4 | Oct 20, 2022 =
* Added: Google Fonts enable/disable settings.

= Version 2.2.3 | Sep 23, 2022 =
* Fixed: Title issue with Divi theme.
* Fixed: Event status issue after event calendar update.
* Fixed: Google font issue.

= Version 2.2.2 | Sep 23, 2022 =
* Fixed: Translation issue.
* Fixed: Google font issue.
= Version 2.2.1 | Apr 14, 2022 =
* Fixed: Minor issue.

= Version 2.2 | Apr 08, 2022 =
* Fixed: Security issues.
* Improvements: Improved overall code.

= Version 2.1 | Apr 07, 2022 =
* Fixed: Security issues.
* Updated: Codestar Framework.
* Improved: Overall code improvements.

= Version 2.0 | Apr 05, 2022 =
* Fixed: Major security issues.
* Improved: Overall code improvements.

= Version 1.9.2 | Oct 21, 2021 =
* Compatibility: Compatibility with PHP version 8.
* Improvements: Code improved.
* Fixed: Missing shortcode generator fields.

= Version 1.9.1 | Sep 29, 2021 =
* Fixed: Minor bug fixes.
* Improved: Renamed settings framework.

= Version 1.9 | Sep 27, 2021 =
* Added: Integrated new Events Shortcode generator.
* Improved: Minor code improvements.
* Removed: Tinymce shortcode generator.

= Version 1.8.2 | Sep 16, 2021 =
* Fixed: Tiny color issue with php 5.6 version.
* Compatible: Compatible plugin with 5.6 version of PHP.
* Improvements: Improved folder structure.

= Version 1.8.1 | Sep 13, 2021 =
* Fixed: Minor typography migration bug.

= Version 1.8 | Sep 03, 2021 =
* Added: Integrated new settings panel (Codestar).
* Removed: Titan Framework settings panel.
* Fixed: Major security issues.
* Added: Optimized all layouts styles and created different filters.
* Removed: All unused CSS and add layout based loading checks.
* Improved: Improved overall code.
* Improved: Managed shortcode and styles in different filters.
* Improved: Review box and admin notices.
* Improved: Folder structure.
* Improved: Minified CSS and JS.
* Improved: Overall code.

= Version 1.7.2 | Aug 25, 2021 =
* Fixed: Major security issue with settings panel (Titan Framework).
* Removed: Removed typography preview settings.
* Improved: Code improvements.

= Version 1.7.1 | March 9, 2021 =
* Added: New Events addon for Elementor notice.
* Fixed: Minor localize script issue.

= Version 1.7 | JAN 6, 2021 =
* Added: Integrated minimal layouts.
* Added: Added 3 styles in minimal layouts.
* Tweak: Shortcode generator and Gutenberg shortcode block.

= Version 1.6.1 | OCT 30, 2020 =
* Added: Implemented some checks.
* Fixed: Conflict with Gravity form.

= Version 1.6 | OCT 23, 2020 =
* Added: Events Addons Dashboard.
* Updated: Moved plugin settings menu under - Events Addons >> Shortcodes & Template >> Common Settings.
**More:- check changelog.txt file inside plugin folder.**

== Upgrade Notice ==
= 2.2.1 =
Minor Issue