===  Events Slider, Events Carousel, Events Grid and Events Filter Bar for The Events Calendar – Eventful ===
Contributors: ThemeAtelier, faysal61, shshakib2001, tamimaziz
Donate link: https://wpeventful.com/pricing/
Tags: events, events grid, the events calendar, event calendar, event
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 2.1.23
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Display events in sliders, carousels and grids with a filter bar. Eventful is a flexible addon for The Events Calendar with shortcode & block support.
== Description ==
Eventful is an add-on for [The Events Calendar](https://wordpress.org/plugins/the-events-calendar/) that lets you showcase your events using modern, responsive layouts designed for real-world event websites.

Display events in sliders, carousels, grids, or lists with an optional filter bar, and customize the look to match your website — no coding required.

Built specifically for The Events Calendar, Eventful works seamlessly with your existing events and categories while giving you flexible display options that look great on all devices. With support for popular page builders like Elementor and Gutenberg, Eventful makes it easy to highlight upcoming events, workshops, conferences, and community activities in a clean, professional, and engaging way.

**Key Highlights:**
- Works with the free version of The Events Calendar
- Display events in sliders, carousels, grids, and lists
- Mobile-friendly, responsive layouts for all screen sizes
- Easy to configure with a simple and intuitive settings panel
- Shortcode and block support for flexible placement
- Lightweight and performance-optimized

[youtube https://youtu.be/bkQ3CtPX5hY]

**👁️[Live Demo](http://wpeventful.com/lite-version-demo/) | 📖[Documentation](https://wpeventful.com/docs/) | 🚀[Upgrade to Pro!](http://wpeventful.com/pricing/) | 👩🏼‍💻[Support](https://wordpress.org/support/plugin/eventful/) | 🌟[Rate This Plugin](https://wordpress.org/support/plugin/eventful/reviews/#new-post)**

== Key Features ==
* **Multiple Layouts** : Create unlimited events sliders, events carousel, events grids and events minimal layouts across your website
* **Beautiful Event Templates to Start** : 9+ Professionally Pre-designed event templates to setup your event layout quickly.
* **Responsive columns** : customize how many events appear on desktop, tablet, and mobile
* Equalize box height for uniform display
* Set custom margins between events
* Fully responsive and mobile-friendly design
* Works seamlessly with any theme and The Events Calendar plugin
* **Display by** : 
 - Latest, Featured or Specific Event
 - Exclude Specific Event
 - Category or Tag
 - Keyword
* Filter by Categories, Tags.
* Sort by: Title, Event Start Date, ID, Slug, Random
* **Hide Free Events:** Easily exclude events that don’t have a price set.
* **Hide Events Without Featured Images:** Automatically hide events missing a thumbnail for a cleaner layout.
* Ascending / Descending order option
* Advanced Shortcode Generator with 300+ visual customization options
* Effortless shortcode copy-paste for posts, pages, and builders
* Show / Hide elements:
 - Title, image, description, excerpt
 - Venue, organizer, time, date, category
 - Read More button, meta fields, social sharing
* Drag-and-drop content order: image, title, meta, buttons, etc.
* 5 meta separator styles
* Display full content, excerpt with limit, or short content
* Read More button: custom text, style, and color
* Content alignment: Left, Center, Right
* Full typography control: 840+ Google Fonts, font size, spacing, color, and weight
* Unlimited color customization for all elements
* Image control:
 - Set dimensions (width/height)
 - Hard crop and adaptive height
 - Retina-ready support
* 30+ slider/carousel settings including:
 - Speed control
 - Autoplay on/off
 - Stop on hover
 - Loop mode (endless)
 - Multiple items to scroll
 - Touch swipe and mouse drag control
* 1 arrow style and 3 position options
* Pagination color, speed, and style options
* Events Schema SEO Support
* Global color scheme options for easier branding customization.
* Events Showcase and Filter bar Block for Gutenberg editor
* Events Showcase and Filter bar Block Elementor Widget
* Page Builder support: Elementor, Gutenberg, Divi, WPBakery, Brizy, and others
* Multilingual ready: WPML, Polylang
* RTL support
* Multisite compatible
* Accessibility-ready
* SEO optimized and speed-friendly
* Supports all major browsers: Chrome, Firefox, Safari, Edge
* Clean and intuitive admin panel
* No coding required — easy for non-tech users
* Extensive documentation and step-by-step video tutorials
* Friendly and fast developer support

== Why Choose Eventful? ==

Unlike basic event shortcode plugins, Eventful gives you complete design control with rich layout styles, advanced filters, flexible display options, and full builder compatibility—so you can create **event showcases that match your brand and boost engagement.**

Whether you're running a nonprofit, school, church, conference, or local community calendar—Eventful helps you present your events in a way that **looks professional, feels intuitive**, and helps your visitors take action.

== Pro Demo ==
* **[Events Slider](https://wpeventful.com/events-carousel/)**
* **[Events Ticker](https://wpeventful.com/events-ticker-carousel/)**
* **[Multi-row Carousel](https://wpeventful.com/multi-row-carousel/)**
* **[Events Grid](https://wpeventful.com/events-grid/)**
* **[Events Masonry](https://wpeventful.com/events-masonry/)**
* **[Events List](https://wpeventful.com/events-list/)**
* **[Events Filter Bar](https://wpeventful.com/ajax-live-filter/)**
* **[Events Live Search](https://wpeventful.com/ajax-events-search/)**
* **[Events Content Positions](https://wpeventful.com/event-content-positions/)**
* **[Event Templates](https://wpeventful.com/pre-made-event-templates/)**
* **[Events Popup](https://wpeventful.com/event-details-in-popup/)**

## External services
Eventful uses [Appsero](https://appsero.com) SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.

Appsero SDK **does not gather any data by default.** The SDK only starts gathering basic telemetry data **when a user allows it via the admin notice**. We collect the data to ensure a great user experience for all our users.

Integrating Appsero SDK **DOES NOT IMMEDIATELY** start gathering data, **without confirmation from users in any case.**

Learn more about how [Appsero collects and uses this data](https://appsero.com/privacy-policy/).

== OTHER AMAZING PRODUCTS FROM ThemeAtelier ==

➡️ **[ChatHelp - WhatsApp Chat Help Plugin](https://wordpress.org/plugins/chat-help/)** - Add WhatsApp click to chat with floating chat button, chat to order for WooCommerce, and chat forms to convert visitors into customers.

➡️ **[Darkify Dark Mode](https://wordpress.org/plugins/darkify/)** -  Darkify Dark Mode adds dark mode and night mode to WordPress websites and admin dashboards using a fast, lightweight, customizable dark mode toggle.

➡️ **[Domain For Sale](https://wordpress.org/plugins/domain-for-sale/)** - Create professional domain for sale landing pages in WordPress. Accept offers and inquiries, and manage domain sales directly from your dashboard.

➡️ **[Eventful for Elementor – Events Showcase For The Events Calendar and Elementor](https://wordpress.org/plugins/eventful-for-elementor/)** -  Seamlessly showcase events from The Events Calendar in Elementor with customizable widgets and dynamic layouts.

➡️ **[Greet – Video Bubble Warm Welcome Plugin](https://wordpress.org/plugins/greet-bubble/)** - Create engaging video welcome bubbles to greet visitors, boost interaction, and make your WordPress site more memorable.

➡️ **[Better Chat Support for Messenger](https://wordpress.org/plugins/better-chat-support/)** - Add a customizable Messenger chat bubble to your site for instant conversations, smart pre-filled messages, and availability control.


== Installation ==
1. Install and activate [The Events Calendar](https://wordpress.org/plugins/the-events-calendar/)
2. Upload the `eventful` plugin folder to the `/wp-content/plugins/` directory or install it via Plugins > Add New
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Go to **Eventful > Add New Layout** to create your first event showcase
5. Use the generated shortcode or Gutenberg block to display it on your site

== Frequently Asked Questions ==
= What is Eventful – Events Showcase for The Events Calendar? =

Eventful is a WordPress plugin that extends [The Events Calendar](https://wordpress.org/plugins/the-events-calendar/) plugin and allows you to display events in beautiful layouts such as grid, carousel, slider, and list views. It helps you create modern event showcases with filtering and customization options.

= Do I need The Events Calendar plugin to use Eventful? =
Yes. Eventful works as an **addon for The Events Calendar plugin**. You must install and activate [The Events Calendar](https://wordpress.org/plugins/the-events-calendar/) before using Eventful.

= Can I display events in a grid layout? =  
Yes. Eventful allows you to display events in **grid layouts**, making it easy to create modern event showcases for conferences, meetups, webinars, and other events.

= Can I create an event carousel or slider? =  
Yes. Eventful includes **carousel and slider layouts** so you can showcase upcoming events in a dynamic and interactive way.

= Can I display events in a list layout? =
Yes. Eventful includes a minimal **list layout** that allows you to display events in a clean and simple format. This layout is available in the free version and works great for showing upcoming events in an organized list.

= Can visitors filter events by category or tag? =
Yes. Eventful allows visitors to **filter events by categories, tags, venues, organizers, and dates**, helping users find the events they are interested in quickly.

= Does Eventful work with Elementor? =
Yes. Eventful works perfectly with **Elementor**, allowing you to place event showcases anywhere on your page using shortcodes or widgets.

= Can I display events using a shortcode? =
Yes. Eventful provides **shortcodes** so you can easily display event layouts inside posts, pages, or custom sections of your website.

= Does Eventful support Gutenberg block editor? =
Yes. Eventful works with the **WordPress Gutenberg editor** and allows you to embed event showcases within block-based layouts.

= Can I show only upcoming events? =
Yes. Eventful allows you to display **upcoming events, past events, or specific event categories** depending on your configuration.

= Can I customize the event layout design? =
Yes. Eventful provides multiple customization options including layout styles, colors, event metadata display, and filtering options.

= Does Eventful support responsive layouts? =
Yes. All Eventful layouts are **fully responsive** and work perfectly on desktop, tablet, and mobile devices.

= Is Eventful compatible with most WordPress themes? =
Yes. Eventful is built following WordPress coding standards and works with most modern WordPress themes.

= Is there a Pro version of Eventful? =
Yes. [Eventful Pro →](https://wpeventful.com/) includes additional layouts, advanced filtering, more customization options, and enhanced event display features. [Compare Free vs Pro →](https://wpeventful.com/free-vs-pro/)

= Where can I get support for Eventful? =
You can get support through the [WordPress.org support forum](https://wordpress.org/support/plugin/eventful/) for the free version or through our website for [premium support](http://themeatelier.net/create-support-ticket/).

== Screenshots ==
1. Event calendar plugin with carousel layout and live filter – display and filter events beautifully.
2. Event slider for WordPress – showcase featured events with responsive design and modern UI.
3. Event grid with category filter – organize events by type, tags, and date.
4. Minimal event list layouts – clean and professional event listing styles with filter support.
5. Manage event layouts easily – generate shortcodes for grid, carousel, slider, and list views.
6. Powerful event filtering options – filter events by category, tags, date, and keywords.
7. Customize event layout design – control columns, spacing, colors, and card styles.
8. Drag-and-drop event template builder – customize event title, image, meta, and content layout.
9. Pre-made event templates – quickly create event listings with ready-made professional designs.
10. Advanced carousel settings – autoplay, speed control, infinite loop, and responsive behavior.
11. Customize carousel navigation – control arrows, position, icons, and styling for event sliders.
12. Flexible pagination options – choose dots or numbers with full color and dynamic pagination control.
13. Advanced carousel behavior – enable touch swipe, drag support, keyboard navigation, and adaptive height.
14. Event detail page control – choose link behavior, popup options, and target settings for event pages.
15. Full typography control – customize fonts, sizes, spacing, and styles for event titles and content.
16. Customize event colors easily – control buttons, filters, links, and social icon styles.
17. Import and export layouts – easily migrate event layouts and shortcodes between websites.

== Changelog ==
= 2.1.23 - 05 May 2026 =
* Fixed: `add_filter` incorrectly used instead of `add_action` for the `init` hook, preventing post type registration in some edge cases.
* Fixed: `add_shortcode()` called with unsupported extra arguments, causing PHP warnings.
* Fixed: Deprecated `current_time('timestamp')` replaced with `time()` for WordPress 6.x compatibility.
* Fixed: Update script included via a relative path, which could cause activation errors depending on server configuration.
* Fixed: `wp_safe_redirect()` incorrectly wrapped in `exit(wp_kses_post(...))`, causing malformed redirect output.
* Fixed: Double `json_decode()` with `stripslashes()` in the import function, which caused import failures on PHP 8.

= 2.1.22 - 30 April 2026 =
* Added: Events slider layout including pre-made templates.
* Added: Content alignment option.
* Updated: Minor CSS improvements.

= 2.1.21 – 14 April 2026 =
* Fixed: Issue where the Event "Load More" button loaded a duplicate event.

= 2.1.20 – 14 April 2026 =
* Added: Option to hide free events (events without price).
* Added: Option to hide events without featured images.
* Improved: Query filtering for better event visibility control.
* Updated: Minor CSS improvements.

= 2.1.19 – 02 April 2026 =
* Added: Content Display Type, Read More Button Label, and Show/Hide Price options for pre-made templates.
* Added: Title and Content length (by lines) option for custom templates.
* Updated: Minor CSS improvements.

= 2.1.18 - 09 March 2026 =
* Added: Instructional videos to the dashboard.

= 2.1.17 - 05 March 2026 =
* Added: Minimal List Layout.
* Added: Three pre-made templates for the Minimal List Layout.
* Added: Global color scheme options for easier branding customization.

= 2.1.16 - 05 February 2026 =
* Fixed: Issue with Eventful thumbnail meta attributes.

= 2.1.15 - 29 January 2026 =
* Added: New option to determine event status by the event start date.

= 2.1.14 - 16 January 2026 =
* Added: Elementor widget.

= 2.1.13 - 15 January 2026 =
* Added: Gutenberg block.
* Removed: Third-party SDK integration.
* Improved: Internal code structure.

= 2.1.12 - 13 January 2026 =
* Added: Featured image custom size options.

= 2.1.11 - 21 December 2025 =
* Updated: Pre-made templates options.
* Fixed: Export/import issues.
* Tested: WordPress 6.9 compatibility.

= 2.1.10 - 29 November 2025 =
* Fixed: Event loading issue.

= 2.1.9 - 28 November 2025 =
* Added: Pre-made templates option.
* Added: Eventful shortcode duplicate option.
* Fixed: Event SEO schema detection issue.

= 2.1.8 - 20 November 2025 =
* Fixed: Taxonomy filter issue.

= 2.1.7 - 17 November 2025 =
* Added: Tools export/import option.
* Improved: SEO schema implementation.
* Updated: Settings panel styling.
* Fixed: Default event type (time-based) issue.
* Security: Sanitized, validated, and escaped all data.

= 2.1.6 - 05 November 2025 =
* Added: JSON-LD event schema markup.
* Fixed: Missing composer.json file.
* Updated: Code improvements and compliance with WordPress Plugin Review Guidelines.
* Security: Escaped all variables and options before output.

= 2.1.5 - 03 October 2025 =
* Fixed: Google Fonts loading issue.

= 2.1.4 - 17 September 2025 =
* Added: Documentation and demo links for all available fields.

= 2.1.3 - 30 August 2025 =
* Fixed: PHP compatibility issue.

= 2.1.2 - 11 August 2025 =
* Fixed: Featured events filter.

= 2.1.1 - 06 August 2025 =
* Added: Marked The Events Calendar as a required plugin.

= 2.1.0 - 05 August 2025 =
* Added: Clean-up data on deletion.
* Fixed: Navigation positioning issue.
* Improved: Advanced filter options.
* Updated: Setting field titles and descriptions.
* Updated: Admin panel redesign.

= 2.0.6 - 22 April 2025 =
* Fixed: Translation-related warning with WordPress 6.8.

= 2.0.5 - 08 April 2025 =
* Tested: WordPress 6.8 compatibility.
* Updated: Plugin help page content.
* Updated: Plugin readme content.

= 2.0.4 - 12 March 2025 =
* Added: Admin preview feature.

= 2.0.3 - 06 March 2025 =
* Added: Plugin review notice.

= 2.0.2 - 27 February 2025 =
* Fixed: Filtering option.
* Fixed: Translation issue with latest WordPress version.
* Added: Help and video tutorial tabs.
* Tested: WordPress 6.7.2 compatibility.

= 2.0.1 - 15 December 2024 =
* Tested: WordPress 6.7.1 compatibility.

= 2.0.0 - 16 November 2024 =
* Added: IcoFont support.
* Fixed: Code structure improvements.
* Fixed: CSS issues.
* Updated: WordPress and PHP compatibility.

= 1.0.5 - 06 November 2024 =
* Fixed: Carousel navigation issue.
* Fixed: Minor CSS issues.

= 1.0.4 - 17 August 2024 =
* Updated: Appsero SDK.

= 1.0.3 - 13 June 2024 =
* Fixed: Plugin URL issue.

= 1.0.2 - 13 June 2024 =
* Fixed: CodeMirror editor issue.
* Fixed: Admin panel icon loading issue.
* Fixed: Conflict with Pro version.
* Added: Screenshots.
* Added: FAQ section.
* Added: Shortcode and layout column support.
* Updated: Language files.

= 1.0.1 =
* Added: Language files.
* Updated: Plugin banner and thumbnail.

= 1.0.0 =
* Initial release.