=== Events Shortcodes For The Events Calendar ===
Contributors: satindersingh, narinder-singh, coolplugins, eventscalendaraddons
Donate link: https://donate.stripe.com/5kQdR92iBevO75WbPm6c00i
Tags: the events calendar, shortcode, event, calendar, event calendar
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.2
Stable tag: 2.6.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The Events Calendar shortcodes to display upcoming events list or event calendar on any page using shortcode or Gutenberg block.

== 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)** adds shortcode and Gutenberg block support to **[The Events Calendar](https://stellarwp.pxf.io/tec)** plugin. This [events calendar extension](https://eventscalendaraddons.com/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=homepage&utm_content=top_description) helps you display upcoming events on any page using a shortcode or Gutenberg block with modern events calendar designs.

If you are looking for **[The Events Calendar shortcode](https://eventscalendaraddons.com/doc/add-the-events-calendar-shortcode/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=top_description)**, this addon is the best choice. It lets you show events from The Events Calendar plugin in list, timeline, or minimal list layouts. The Pro version also gives you advanced layouts like grid, carousel, slider, and more.

https://youtu.be/uL3ToWGncbM

👉 **View Plugin Demos: (*FREE*)**
 
[Events List](https://eventscalendaraddons.com/shortcode/events-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_list&utm_content=below_video) | [Events Timeline](https://eventscalendaraddons.com/shortcode/events-timeline/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_timeline&utm_content=below_video) | [Events Minimal List](https://eventscalendaraddons.com/shortcode/events-minimal-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_minimal_list&utm_content=below_video)

👉 **View Plugin Demos: (*PRO*)**

[Events Grid](https://eventscalendaraddons.com/shortcode/events-grid/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_grid&utm_content=below_video) | [Events Accordion](https://eventscalendaraddons.com/shortcode/events-accordion/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_accordion&utm_content=below_video) | [Events Masonry](https://eventscalendaraddons.com/shortcode/events-masonry/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_masonry&utm_content=below_video) | [Highlighted Layout](https://eventscalendaraddons.com/shortcode/events-highlighted-layout/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_highlighted&utm_content=below_video)

[Events Carousel](https://eventscalendaraddons.com/shortcode/events-carousel/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_carousel&utm_content=below_video) | [Events Slider](https://eventscalendaraddons.com/shortcode/events-slider/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_slider&utm_content=below_video) | [Events Filter Bar](https://eventscalendaraddons.com/shortcode/filter-bar/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_filterbar&utm_content=below_video) | **[View All Demos](https://eventscalendaraddons.com/demos/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_all&utm_content=below_video)**

### Events Shortcodes Plugin Features

* **The Events Calendar Shortcode & Block**  
Display events anywhere using a dedicated Gutenberg events block or a simple [shortcode for The Events Calendar](https://eventscalendaraddons.com/doc/the-events-calendar-shortcode-attributes/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=features) plugin.  
  * `[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 Event Layouts & Styles**  
Show events in list, timeline, or minimal list layouts. Upgrade to Pro for grid, carousel, slider, accordion, masonry, and more.

* **Date Filters in Shortcode**  
Using the shortcode, you can filter events by date range or event type (upcoming, past, or all events). You can also [choose any date format](https://eventscalendaraddons.com/doc/events-shortcodes-date-format/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=features).

* **Event Category, Sorting & Limit**  
Select event categories inside the shortcode, sort events by date (ASC or DESC), and control the number of events to display.

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

* **[Events Search Filter Bar](https://eventscalendaraddons.com/doc/the-events-calendar-filter-bar-shortcode/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features)**  
Add an advanced filter bar to let users search events by category, venue, or organizer on the frontend.

* **[Advanced Event Layouts](https://eventscalendaraddons.com/doc/events-list-grid-carousel-shortcodes/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features)**  
Access premium event layouts and styles such as Grid, Carousel, Masonry, Accordion, and Calendar.

* **Display Events by Venue, Organizer, or Tag**  
While using the events shortcode, you can apply advanced filters to display specific events list:
  * [List of Events by Venue](https://eventscalendaraddons.com/doc/shortcode-display-events-by-organizer-venue/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features)
  * [List of Events by Organizer](https://eventscalendaraddons.com/doc/shortcode-display-events-by-organizer-venue/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features)
  * [List of Events by Tag](https://eventscalendaraddons.com/shortcode/events-by-tag/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_tag&utm_content=pro_features)
  * [Show Only Featured Events](https://eventscalendaraddons.com/doc/display-featured-events-list-shortcode/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=pro_features)

### Why Use Events Shortcodes with The Events Calendar?

* Show events list on your site using a shortcode with this events calendar extension.
* Perfect for event websites to display upcoming events on the homepage.
* Insert an event calendar inside any blog post using a simple shortcode.
* Upgrade The Events Calendar from a simple display to a modern events calendar.
* Improves your site’s event management and event display in an easy way.

### More Addons For [The Events Calendar](https://stellarwp.pxf.io/tec)

If you are using The Events Calendar plugin, you may also find these addons helpful:

* **[Event Single Page Builder](https://eventscalendaraddons.com/plugin/event-single-page-builder-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons)**  
Create custom single event pages for The Events Calendar according to your website colors, fonts, and layout design.

* **[Event Speakers & Sponsors](https://eventscalendaraddons.com/plugin/events-speakers-and-sponsors/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons)**  
Add speaker and sponsor sections to The Events Calendar single event pages or events list layouts with clean styling.

* **[Events Widgets for Elementor](https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons)**  
Use The Events Calendar Elementor widgets to display events in list, grid, and carousel layouts inside Elementor pages.

* **[Events Calendar Modules for Divi](https://eventscalendaraddons.com/plugin/the-events-calendar-modules-for-divi/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=more_addons)**  
Display The Events Calendar events using dedicated Divi events calendar modules built for Divi builder pages and layouts.

### Other Plugins by [Cool Plugins](https://cooltimeline.com/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=homepage&utm_content=other_plugins)

Cool Plugins also offers other popular WordPress plugins trusted by many users:

* **[Cool Timeline](https://cooltimeline.com/plugin/cool-timeline-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins)**  
Create beautiful vertical or horizontal timelines to show company history, milestones, stories, or events on WordPress websites.

* **[Cool FormKit](https://coolformkit.com/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins)**  
Advanced Elementor form addon to add extra form fields, conditional logic, calculations, and more without coding.

* **[AutoPoly](https://coolplugins.net/product/autopoly-ai-translation-for-polylang/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins)**  
AI-powered Polylang addon to automatically translate WordPress content into multiple languages quickly.

* **[LocoAI](https://locoaddon.com/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=other_plugins)**  
Smart Loco Translate addon to translate WordPress themes and plugins strings faster using AI-based translations.

**Third-Party Services:** To improve user experience this plugin offers optional usage tracking and optional feedback submission on deactivation. Data is sent only after explicit user consent. No hidden tracking is performed, and no frontend visitor or site user data is collected. For more details, please review our [Data Usage Policy](https://my.coolplugins.net/terms/usage-tracking/), [TOS](https://my.coolplugins.net/terms/), and [Privacy Policy](https://my.coolplugins.net/terms/privacy-policy/).This plugin also utilizes the Codestar Framework (licensed under) [GPL]((https://codestarframework.com/license/)) and [Google Fonts](https://developers.google.com/fonts/docs/getting_started) to provide integrated typography options.

**Disclaimer:** Events Shortcodes For The Events Calendar plugin is developed and maintained by the Cool Plugins team and is not affiliated with, endorsed by, or officially connected to The Events Calendar plugin or its parent company, StellarWP. Some links in this plugin and readme file may be affiliate links, which means we may earn a commission at no additional cost to you.

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

== Installation ==

Follow the steps below to install and use **Events Shortcodes** plugin.

### 1. Install Required Plugin

This plugin works only with **[The Events Calendar](https://stellarwp.pxf.io/tec)** plugin.

* Go to **Plugins → Add New** in your WordPress admin.
* Search for **The Events Calendar**.
* Install and activate it first.

### 2. Install Events Shortcodes Plugin

* Go to **Plugins → Add New**.
* Search for **Events Shortcodes for The Events Calendar**.
* Click **Install Now** and then **Activate**.

### 3. Access Plugin Settings

* To manage plugin options and settings, go to:
  **WP Admin → Events Addons → Shortcode Settings**

### 4. [Customize Colors & Fonts](https://eventscalendaraddons.com/doc/events-shortcodes-settings-colors-fonts/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=installation)

To change how events look on the frontend:

* Go to **WP Admin → Events Addons → Shortcode Settings → General Settings**
* Adjust colors, fonts, and styling options.
* These settings apply to events shown using shortcode.

https://youtu.be/RonG0_p2Gok

### 5. Add Custom CSS (Optional)

If you want to add your own styling:

* Go to **WP Admin → Events Addons → Shortcode Settings → Extra Settings**
* Add your custom CSS and save changes.

### 6. Use Shortcode in Any Page or Post

* You can find the shortcode and all available attributes here:
  **WP Admin → Events Addons → Shortcode Settings → Shortcode Attributes**

* **[Default Shortcode Example](https://eventscalendaraddons.com/doc/the-events-calendar-shortcode-attributes/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=installation):**
  `[events-calendar-templates category="all" template="default" style="style-1" date_format="default" start_date="" end_date="" limit="10" order="ASC" hide-venue="no" socialshare="no" time="future"]`

### 7. Use Events Block (Gutenberg Editor)

You can also display events using the Gutenberg block:

* Create or edit a page.
* Click **Add Block (+)** and search for **Events Block**.
* Insert the block into the page.
* Adjust settings from the block panel.
* Publish or update the page and preview it.
 
https://youtu.be/sLGIOmlNPtY

For detailed guides, check the [full documentation of Events Shortcodes](https://eventscalendaraddons.com/docs/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=docs&utm_content=installation) plugin.

== Frequently Asked Questions ==

= What is Events Shortcodes for The Events Calendar plugin? =
Events Shortcodes is an addon for [The Events Calendar](https://stellarwp.pxf.io/tec) plugin that lets you display events anywhere on your website using a shortcode or Gutenberg block. You can show events in list, timeline, or minimal list layouts created using The Events Calendar plugin.

= How do I display events using a shortcode? =
You can display events by adding the shortcode to any page, post, or widget area.

Example shortcode:
`[events-calendar-templates category="all" template="default" style="style-1" limit="10" order="ASC" time="future"]`

You can customize layout, category, date range, sorting, and more using shortcode attributes.

= Can I use Events Shortcodes with the Gutenberg block editor? =
Yes. The plugin includes a dedicated Events Block for Gutenberg.  
Just search for “Events Block” while editing a page and configure event display settings from the block panel.

= What event layouts are available in the free version? =
The free version includes:

* [Events List layout](https://eventscalendaraddons.com/shortcode/events-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_list&utm_content=faq)
* [Events Timeline layout](https://eventscalendaraddons.com/shortcode/events-timeline/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_timeline&utm_content=faq)
* [Events Minimal List layout](https://eventscalendaraddons.com/shortcode/events-minimal-list/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_minimal_list&utm_content=faq)

= What extra layouts are available in the Pro version? =
The Pro version adds advanced event layouts such as:

* Grid
* Carousel
* Slider
* Masonry
* Accordion
* Calendar
* Highlighted layouts

👉 **[View All Demos](https://eventscalendaraddons.com/demos/events-shortcodes-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_all&utm_content=faq)**

= Can I filter events by category, date, or event type? =
Yes. You can filter events using shortcode options like:

* Event category
* Date range
* Upcoming, past, or all events

The Pro version also includes a frontend [Events Filter Bar](https://eventscalendaraddons.com/shortcode/filter-bar/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=demo_filterbar&utm_content=faq) for advanced event searching.

= Can I control event order and number of events displayed? =
Yes. You can:

* Sort events by date (ASC or DESC)
* Limit the number of events shown
* Choose custom date formats

All these options are available inside the shortcode attributes and settings panel.

= Is Events Shortcodes compatible with Elementor and Divi? =
We suggest using dedicated addons for Elementor and Divi builders:

* For Elementor, you can use [Events Widgets for Elementor](https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=faq) addon.

* For Divi, you can use [Events Calendar Modules for Divi](https://eventscalendaraddons.com/plugin/the-events-calendar-modules-for-divi/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=faq).

= 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 List Template - Style 2
3. Events List Template - Style 3
4. Events Minimal List Styles
5. Events Shortcodes Settings Panel
6. The Events Calendar Shortcode Block
7. The Events Calendar Shortcode Generator
8. The Events Calendar Gutenberg Block

== Changelog ==

= 2.6.2 | MAR 10, 2026 =
* Improved: Dashboard header usability.
* Tested up to: The Events Calendar version 6.15.17.1.

= 2.6.1 | FEB 26, 2026 =
* Fixed: Minor styling issues for better UI consistency.
* Improved: Code structure and performance optimization.

= 2.6.0 | FEB 23, 2026 =
* Improvements: Improved dashboard design and usability.
* Improvements: Code optimizations and refinements.
* Fixed: Issues reported by “Plugin Check” plugin.
* Updated: readme file.
* Tested up to: The Events Calendar version 6.15.16.

= 2.5.4 | FEB 11, 2026 =
* Improved: Minor code improvements.

= 2.5.3 | FEB 05, 2026 =
* Improved: Overall code quality and performance.

= 2.5.2 | NOV 18, 2025 =
* Improved: Rating div styling.
* Tested up to: The Events Calendar version 6.15.11.

= 2.5.1 | SEP 18, 2025 =
* Fixed: Google Fonts loading issue in Events Gutenberg block.
* Improved: Other [Events Calendar addons](https://eventscalendaraddons.com/?utm_source=ect_plugin&utm_medium=readme&utm_campaign=homepage&utm_content=changelog) recommendations.
* Tested up to: The Events Calendar version 6.15.4.

= 2.5.0 | SEP 05, 2025 =
* Added: Arial font family support in Events block.
* Added: Month header option for Events Gutenberg block.
* Added: Background color customization in Minimal List layout.
* Added: Month translation support in Events block.
* Fixed: Security vulnerabilities.
* Fixed: Minor CSS issues.
* Fixed: Editor-side loading issue when displaying 50+ events.
* Improved: Overall code structure and performance.

= 2.4.10 | SEP 02, 2025 =
* Updated: Internal plugin links.

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

= 2.4.8 | JUN 24, 2025 =
* Updated: UTM links.
* Updated: Readme file.

= 2.4.7 | JUN 10, 2025 =
* Added: User opt-in option in plugin settings.
* Improved: Minor code improvements.
* Tested up to: The Events Calendar version 6.13.2.1.

= 2.4.6 | APR 18, 2025 =
* Fixed: Plugin settings issue.

= 2.4.5 | APR 17, 2025 =
* Tested up to: WordPress version 6.8.
* Tested up to: The Events Calendar version 6.11.2.

= 2.4.4 | NOV 22, 2024 =
* Added: Events Shortcodes Gutenberg block.
* Fixed: load_plugin_textdomain() issue for proper translations.
* Tested up to: WordPress version 6.7.
* Tested up to: The Events Calendar version 6.8.2.

= 2.4.3 | SEP 18, 2024 =
* Tested up to: WordPress version 6.6.2.
* Tested up to: The Events Calendar version 6.6.4.2.
* Fixed: Minor security issues.

= 2.4.2 | JUL 23, 2024 =
* Tested up to: WordPress version 6.6.
* Tested up to: The Events Calendar version 6.6.0.

= 2.4.1 | MAY 07, 2024 =
* Added: Get Started page to help users learn Events Shortcodes.
* Fixed: Image link issues in Events List styles 2 and 3.
* Fixed: Category slug issue while filtering events in WPBakery Page Builder.
* Updated: Shortcode attributes in plugin settings.

= 2.4.0 | JAN 31, 2024 =
* Improved: Events layouts HTML and CSS.
* Improved: New default values for style settings.

= 2.3.3 | NOV 07, 2023 =
* Fixed: Incorrect string output on frontend.

= 2.3.2 | NOV 06, 2023 =
* Fixed: Minor security vulnerability.
* Fixed: Fatal error with search element in Avada theme.
* Deprecated: Old shortcode generator.

= 2.3.1 | MAR 29, 2023 =
* Improved: Minor text updates.
* Improved: Updated internal links.
* Improved: Admin dashboard code.
* Improved: Feedback form.

= 2.2.6 | MAR 02, 2023 =
* Improved: Minor text updates.
* Improved: Updated internal links.

= 2.2.5 | DEC 05, 2022 =
* Added: “Find Out More” settings option.
* Fixed: Time function parameter issue.

= 2.2.4 | OCT 20, 2022 =
* Added: Google Fonts enable/disable option.

= 2.2.3 | SEP 23, 2022 =
* Fixed: Event title issue with Divi theme.
* Fixed: Event status issue after Events Calendar update.
* Fixed: Google Fonts loading issue.

= 2.2.2 | SEP 23, 2022 =
* Fixed: Translation issues.
* Fixed: Google Fonts loading issue.

= 2.2.1 | APR 14, 2022 =
* Fixed: Minor issues.

= 2.2.0 | APR 08, 2022 =
* Fixed: Security issues.
* Improved: Overall code quality.

= 2.1.0 | APR 07, 2022 =
* Fixed: Security issues.
* Updated: Codestar Framework.
* Improved: Overall plugin code.

= 2.0.0 | APR 05, 2022 =
* Fixed: Major security issues.
* Improved: Overall plugin performance.

= 1.9.2 | OCT 21, 2021 =
* Compatibility: PHP 8 support.
* Improved: Code structure.
* Fixed: Missing fields in shortcode generator.

= 1.9.1 | SEP 29, 2021 =
* Fixed: Minor bugs.
* Improved: Renamed settings framework.

= 1.9.0 | SEP 27, 2021 =
* Added: New Events Shortcode Generator.
* Improved: Minor code improvements.
* Removed: TinyMCE shortcode generator.

= 1.8.2 | SEP 16, 2021 =
* Fixed: Tiny color issue with PHP 5.6.
* Compatibility: PHP 5.6 support.
* Improved: Plugin folder structure.

= 1.8.1 | SEP 13, 2021 =
* Fixed: Typography migration issue.

= 1.8.0 | SEP 03, 2021 =
* Added: New Codestar settings panel.
* Removed: Titan Framework settings panel.
* Fixed: Major security issues.
* Added: Optimized layouts and filters.
* Removed: Unused CSS files.
* Improved: Code structure, CSS, JS, admin notices, and performance.

= 1.7.2 | AUG 25, 2021 =
* Fixed: Major security issue in Titan Framework.
* Removed: Typography preview settings.
* Improved: Code quality.

= 1.7.1 | MAR 09, 2021 =
* Added: Elementor Events addon notice.
* Fixed: Script localization issue.

= 1.7.0 | JAN 06, 2021 =
* Added: Minimal event layouts.
* Added: Three styles for minimal layouts.
* Improved: Shortcode generator and Gutenberg block.

= 1.6.1 | OCT 30, 2020 =
* Added: Validation checks.
* Fixed: Conflict with Gravity Forms.

= 1.6.0 | OCT 23, 2020 =
* Added: Events Addons dashboard.
* Updated: Plugin menu location under Events Addons settings.
* More details available in changelog.txt file inside the plugin folder.

== Upgrade Notice ==

= 2.0.0 =
Major improvements to overall plugin code, security, and performance.