=== Events Block For The Events Calendar ===
Contributors:coolplugins,narinder-singh,satindersingh,eventscalendaraddons
Donate link:https://paypal.me/CoolPlugins/10USD/
Tags: events list, events block, the events calendar blocks, Gutenberg block, events calendar
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.4.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The Events Block for The Events Calendar lets you showcase your events from The Events Calendar right within the Gutenberg pages.

== Description ==

### Events Block For The Events Calendar

**[Events Block for The Events Calendar](https://coolplugins.net/product/the-events-calendar-gutenberg-blocks/?utm_source=ebec_plugin&utm_medium=readme&utm_campaign=view_plugin&utm_content=top_description)** is a powerful addon that allows you to display your events from The Events Calendar directly inside Gutenberg. Simply search **“events block”** and showcase your events without any coding.

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

This addon fills in the gap by adding the Events Block feature to The Events Calendar, making it compatible with Gutenberg.

🔗**[Check Plugin Demos](https://eventscalendaraddons.com/demos/events-block-for-the-events-calendar/?utm_source=ebec_plugin&utm_medium=readme&utm_campaign=demo&utm_content=check_demos)**

### Key Features

* **Layout Options:** Choose between Minimal or Default layout styles.
* **Category Filters:** Create targeted event listings, such as showing events for specific topics using category filters.
* **Custom Date Format:** Choose how event dates are displayed (e.g., DD/MM/YYYY, MM-DD-YYYY) to match your regional preferences or branding style.
* **Event Display Limit:** Set how many events to show at one time in the widget.
* **Event Order:** Display events in ascending or descending order based on their date.
* **Event Type:** Display only upcoming events, past, or show all events according to your preference.
* **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.
* **Month Headers:** Show month headers for grouped event listings according to your requirements.
* **Customization:** Customize the style of each event element according to your brand.

### More Addons For The Events Calendar

* **[Events Single Page Builder Pro](https://eventscalendaraddons.com/plugin/event-single-page-builder-pro/?utm_source=ebec_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 Shortcodes Pro](https://eventscalendaraddons.com/plugin/events-shortcodes-pro/?utm_source=ebec_plugin&utm_medium=readme&utm_campaign=get_pro&utm_content=ect_more_addons)** - Events Shortcodes Pro For The Events Calendar adds the missing shortcode functionality to The Events Calendar plugin. With this plugin, you can easily display your events on any page or post in a list, grid, carousel, slider, masonry, accordion, or even a timeline format.
* **[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.
* **[Events Widgets Pro](https://eventscalendaraddons.com/plugin/events-widgets-pro/?utm_source=ebec_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.

**Use of 3rd Party Services:** This plugin connects to the Cool Plugins API to display information about related plugins inside the dashboard. It also 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/).

✍ Special THANKS!
Special thanks to the famous The Events Calendar plugin authors and its parent company StellarWP, Inc. for creating an awesome plugin for events management.
All of these addons are not developed by or affiliated with The Events Calendar (by StellarWP) team, these are third-party addons for The Events Calendar and they add extra features inside The Events Calendar free plugin.

== Frequently Asked Questions ==

= What is the Events Block For The Events Calendar plugin? =
The Events Block For The Events Calendar is an addon that allows you to showcase events from The Events Calendar within the Gutenberg page builder on your WordPress site.

= How does this plugin enhance The Events Calendar? =
This plugin adds an Events Block feature to The Events Calendar, making it compatible with Gutenberg. It offers a modern and simple list design for your events.

= What are the main features of this plugin? =
Key features include custom color and date formats, category filter settings, specific date range settings, custom event date formats, and event ordering by time.

= Can I customize the appearance of my events list? =
Yes, you can select custom colors and date formats for your events list to match your website’s design and preferences.
 
= Does the plugin support filtering events by categories? =
Yes, it supports event category filter settings, allowing you to display events based on selected categories.

 = Can I display events within a specific date range? =
Yes, the plugin supports specific date range-based list settings, enabling you to showcase events within a chosen date range.

 = How does the event ordering feature work? =
The plugin allows you to order events based on time, displaying them in chronological order to help you plan and track events more efficiently.
 
= How can I report security bugs? =
You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team helps validate, triage, and handle any security vulnerabilities. [Report a security vulnerability.](https://patchstack.com/database/vdp/events-block-for-the-events-calendar)

== Installation ==

= There are 3 ways to install Events Block For Gutenberg Addon. =
* **Automatically install our plugin via WordPress admin panel:-** Open your WordPress website admin panel and go to **Plugins > Click Add New & search Events Block For Gutenberg**. Here you will find our plugin. Now, click on the install button. After this, you will see an activate button, just activate it to use Events Block inside Gutenberg Created pages.
* **Install via Zip file:-** In this method, first you need to download our plugin from the WordPress plugins directory. Download **Events Block For Gutenberg**. After this, inside your WP-admin panel, click on **Plugins > Add New > Upload Button**. Now choose the plugin zip file that you just downloaded from the WordPress plugins directory & activate it.
* **Install the plugin via FTP:-** In this method, first you need to download the plugin zip file from the WordPress plugins directory. After this, open your FTP manager and **go to > wp-content/plugins folder**. Here you need to upload the extracted version of the Events Block For Gutenberg addon(remember, do not upload the zip file directly here). After this, you can activate the plugin from the **wp-admin > plugins page**.

> Remember this is a design add-on. It will only work if you first install the "The Events Calendar (by StellarWP)" plugin.

== Screenshots ==
1. Events List Block Demo
2. Events List block usage steps inside Gutenberg Block.
3. Events List block search preview

== Changelog == 

= 1.4.5 | Jun 15, 2026 =
- **Improved:** Cleaned up the notice registration logic for better readability.

= 1.4.4 | Jun 09, 2026 =
- **Improved:** Code Improvements & Optimization
- **Tested upto:** The Events Calendar version 6.16.3.

= 1.4.3 | MAR 10, 2026 =
- **Improved:** Dashboard header usability.
- **Tested upto:** The Events Calendar version 6.15.17.1

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

= 1.4.1 | FEB 21, 2026 =
- **Fixed:** Issue with plugins image path.

= Version 1.4 | 21 February, 2026 =
- **Improvements:** Improved dashboard design and usability.
- **Improvements:** Code optimizations and refinements.
- **Fixed:** Issues reported by “Plugin Check” plugin.
- **Tested upto:** The Events Calendar version  6.15.16

= Version 1.3.12 | 10 December, 2025 =
- **Fixed:** IntlDateFormatter missing error in event list layout.
- **Tested upto:** The Events Calendar version  6.15.12.2

= Version 1.3.11 | 18 November, 2025 =
- **Tested upto:** The Events Calendar version  6.15.11

= Version 1.3.10 | 20 September, 2025 =
- **Improved:** Rating div styling.
- **Tested upto:** The Events Calendar version 6.15.4

= Version 1.3.9 | 05 September, 2025 =
- **Fixed:**  Review notice.
- **Tested upto:** The Events Calendar version 6.15.1.1

= Version 1.3.8 | 22 August, 2025 =
- **Fixed:**  Addressed security vulnerabilities.
- **Fixed:**  Minor CSS fixes.
- **Tested upto:** WordPress V6.8.2
- **Tested upto:** The Events Calendar version 6.15.0.1
- **Updated:** UTM Links

= Version 1.3.7 | 13 June, 2025 =
- **Added:** Events addons dashboard.
- **Added:** User opt-in option in plugin.
- **Added:** Month header setting.
- **Added:** Background color style settings in minimal list.
- **Tested upto:** WordPress V6.8.1
- **Tested upto:** The Events Calendar version 6.13.2.1

= Version 1.3.6 | 30 May, 2025 =
- **Fixed:** Minor security fix.
- **Tested:** Tested upto WordPress 6.8.1

= Version 1.3.5 | 06 May, 2025 =
- **Added:** Month translation in the event list.
- **Tested:** Tested upto WordPress 6.8.1

= Version 1.3.4 | 25 February, 2025 =
- **Fixed:** Minor issues.
- **Tested:** Tested upto WordPress V6.7.2 and The Events Calendar V6.10.1.1

= Version 1.3.3 | 29 January, 2025 =
- **Fixed:** 50 + Events loading issue on the editor side.
- **Fixed:** Minor Security Issues.
- **Added:** Arial font family.
- **Tested:** Tested upto WordPress V6.7.1 and The Events Calendar V6.9.1

 = Version 1.3.2 | 19 September, 2024 =
- **Fixed:** Issue of accessing block.json again and again.
- **Fixed:** Minor Security Issues.
- **Tested:** Tested upto WordPress v6.6.2 and The Events Calendar V6.6.4.2

 = Version 1.3.1 | 29 July, 2024 =
- **Fixed:** Minor Bug fixes
- **Tested:** Tested upto WordPress v6.6 and The Events Calendar V6.6

 = Version 1.3.0 | 18 March, 2024 =
- **Added:**
 - Event description setting for short and full content.
 - Added Layout setting.
 - Minimal Layout Added.
- **Fixed:**
 - Fixed date format issue on the editor and front end.
 - Fixed excerpt content issue.
 - Fixed responsive styling issue.
 - Fixed multiple block Google fonts issue.
 - Fixed between date range issue on the editor side.
 - Fixed read more, event venue, and cost styling issues on the frontend.
 - Fixed line height issue on editor and front end.
 - Fixed venue editor issue on the editor side.

= Version 1.2.1 | 13 Feb 2024 =
- **Fixed:** Minor issues.
- **Tested upto:** WordPress 6.4.3 and The Events Calendar Version 6.3.2

= Version 1.2 | 06 Feb 2023 =
- **Fixed:** Major bug
- **Improved:** settings panel
- **Fixed:** minor CSS issues.

= Version 1.1 | 05 September 2022 =
- **Fixed:** Header Modified bug

= Version 1.0 | 15 March 2022  =
- Initial release

== Upgrade Notice ==
= Version 1.3.0 | 18 March, 2024 =
Added: description setting (short/full), layout setting, minimal layout. Fixed: date format, excerpt, responsive styling, Google fonts, date range, read more/venue/cost styling, line height, venue editor.

