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

Display your events beautifully in sliders, carousels, grids, and lists with Eventful, a flexible addon for The Events Calendar.
== Description ==

**👁️[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)**

Eventful is an addon for [The Events Calendar](https://wordpress.org/plugins/the-events-calendar/) that lets you showcase your events in modern, responsive layouts.  
Choose from sliders, carousels, grids, or lists, and customize the design to fit your website — no coding required.

With support for popular page builders like Elementor and Gutenberg, Eventful makes it easy to highlight upcoming events, workshops, conferences, or community activities in a way that feels professional and engaging.

**Key Highlights:**
- Works with the free version of The Events Calendar
- Mobile-friendly layouts that adapt to any device
- Easy to configure with an intuitive settings panel
- Shortcode and block support for flexible placement

== Key Features ==
* **Multiple Layouts** : Create sliders and grids across your website
* **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
* 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
* 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/)**

== OTHER AMAZING PRODUCTS FROM ThemeAtelier ==

➡️ **[WhatsApp Chat Help](https://wordpress.org/plugins/chat-help/)** -  A WordPress plugin that allows website owners to easily add a WhatsApp chat bubble to their website and comes with Gutenberg, Elementor and Shortcode options.

➡️ **[Darkify Dark Mode](https://wordpress.org/plugins/darkify/)** -  Lightweight, customizable WordPress dark mode plugin for a sleek, accessible, and eye-friendly experience on both frontend and admin dashboard.

➡️ **[Domain For Sale](https://wordpress.org/plugins/domain-for-sale/)** - Transform your unused domain names into cash with this easy-to-use plugin that provides a professional template, customizable options, and a contact form for effortless selling.

➡️ **[Eventful for Elementor – Events Showcase For The Events Calendar and Elementor](https://wordpress.org/plugins/eventful-for-elementor/)** -  Elevate your event management with this dynamic addon, enhancing ‘The Events Calendar’ with versatile layouts, advanced filtering, and user-friendly features for superior event showcasing.

➡️ **[Greet – Video Bubble Warm Welcome Plugin](https://wordpress.org/plugins/greet-bubble/)** - A powerful and user-friendly video bubble plugin for WordPress that provides website owners with the opportunity to create a dynamic and engaging welcome experience for their visitors.

== 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 ==
= Does this plugin work without The Events Calendar? =
No. Eventful is an addon that requires the free [The Events Calendar](https://wordpress.org/plugins/the-events-calendar/) plugin to function.

= Can I use this inside Elementor or Gutenberg editor? =
Yes! Eventful works seamlessly with Elementor and Gutenberg. Use the shortcode or block to embed your layout anywhere.

= Is it mobile responsive? =  
Absolutely. All Eventful layouts are 100% responsive and mobile-friendly.

= Can I choose which events to show? =  
Yes. Filter events by category, tag, date, venue, organizer, and more.

= Do you offer a Pro version? =  
Yes. Eventful Pro unlocks advanced layouts, design templates, extended filtering, and premium support. [Compare Free vs Pro →](https://wpeventful.com/free-vs-pro/)

= How can I obtain support? =
Submit your query in plugin [Support Forum](https://wordpress.org/support/plugin/eventful/)

= I have some suggestions for improving this plugin. How can I communicate with you? =
You can create a topic in our [Support Forum](https://wordpress.org/support/plugin/eventful/) or send me a direct mail at [themeatelierbd@gmail.com](mailto:themeatelierbd@gmail.com)

== Screenshots ==
1. Event Carousel With Category Filter
2. Event Grid With Load More Pagination
3. Specific Events With Inner Padding
4. Admin: Filter Events
5. Admin: Display Options
6. Admin: Carousel Controls
7. Admin: Detail Page
8. Admin: Typography
9. Admin: Global Settings

== Changelog ==
= 2.1.13 - 15 January 2026 =
* Added: Gutenberg block.
* Removed Appsero integration.
* Improved internal code structure.

= 2.1.12 - 13 January 2026 =
* Added: Feature image custom sizes options.

= 2.1.11 - 21 December 2025 =
* Update: 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: Issue where event SEO schema was not being detected correctly.

= 2.1.8 - 20 November 2025 =
* Resolved: An issue where the taxonomy filter was not functioning correctly.

= 2.1.7 - 17 November 2025 =
* Added: Tools Export/Import option.
* Update: Enhanced SEO schema implementation.
* Update: Styling for settings panel.
* Fixed: Issue with the default event type (time-based).
* Security: Ensured all data is properly sanitized, validated, and escaped.

= 2.1.6 - 05 November 2025 =
* Added: JSON-LD event schema markup for improved SEO.
* Fixed: Missing composer.json file while using Composer.
* Updated: Code improvements and compliance with latest WordPress Plugin Review Guidelines.
* Security: Ensured all data is properly sanitized, validated, and escaped.
* 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 required plugin

= 2.1.0 - 05 August 2025 =
* Added: Clean-up Data on Deletion
* Fixed: Navigation positioning issue for improved layout consistency.
* Improved: Advanced filter options for greater flexibility.
* Update: Titles and descriptions for setting fields for better clarity.
* Update: Admin panel redesigned for a more intuitive user experience.

= 2.0.6 - 22 April 2025 =
* Fix: The translation-related warning was found with WP 6.8.

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

= 2.0.4 – 12 March 2025 =
* Added: Admin preview feature, allowing administrators to view and test configurations before applying changes.

= 2.0.3  – 06 March 2025 =
* Added: Review notice for the plugin.

= 2.0.2  – 27 February 2025 =
* Fixed: Filtering option.
* Fixed: Translation issue with latest WordPress version
* Added: Help and video tutorials 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 in both admin and frontend.
* Fixed: Code structure updated for better readability.
* Fixed: Various CSS issues for improved styling.
* Updated: Compatibility with the latest WordPress version.
* Updated: Compatibility with the latest PHP version.

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

= 1.0.4 - 17 August 2024 =
* Update: Appsero SDK

= 1.0.3 - 13 June 2024 =
* Fixed plugins URL

= 1.0.2 - 13 June 2024 =
* Fixed codemirror issue for code editor field
* Fixed check icon loading issue on admin panel
* Fixed conflict issue with pro version
* Added screenshots
* Added FAQ on readme file
* Added pro version link on the plugin list
* Added shortcode and layout column for Eventful shortcode posts
* Update language file

= 1.0.1 =
* Added language files
* Update plugin banner and thumbnail

= 1.0.0 =
* Initial release