=== Easy Events Calendar : All-in-One Events Calendar with Social Event, Eventbrite, Meetup, Google & iCal Import Support ===
Contributors: xylus, Rajat1192  
Tags: calendar, event calendar, eventbrite, meetup, facebook
Requires at least: 6.4  
Tested up to: 7.0 
Requires PHP: 8.0 
Stable tag: 1.1.1  
License: GPLv2 or later  
License URI: https://www.gnu.org/licenses/gpl-2.0.html  

A powerful, modern, and flexible WordPress event calendar with advanced recurring events, mini calendar, iCal sync, and real-time AJAX filtering.

== Description ==

✨ Easy Events Calendar is a powerful, modern, and flexible event management plugin for WordPress.

Create, manage, and display events with ease — whether they are internal events or imported from platforms like Eventbrite, Meetup, or Facebook.

⚡ Includes advanced recurring events, real-time AJAX event discovery, Mini Calendar widgets, and seamless "Add to Calendar" integration for a premium user experience.

📖 [Documentation](http://docs.xylusthemes.com/docs/easy-events-calendar/)  | 🔗 [Plugin Website](https://xylusthemes.com/plugins/easy-events-calendar/)

---

== 🚀 Why Choose Easy Events Calendar? ==

✔ No coding required  
⚡ Fast and performance optimized  
🔗 Supports internal + external events  
📱 Fully responsive design  
🔍 Advanced AJAX filtering system  
📆 Built-in Mini Calendar & "Add to Calendar" Sync

---

== 🚀 Core Features ==

=== 🗂️ Internal Event Management ===
* Create and manage events using custom post type (eec_events)
* Clean and user-friendly admin interface
* No dependency on third-party tools

=== 🔁 Advanced Recurring Events ===
* Supports Daily, Weekly, Monthly, and Yearly schedules
* Automatically generates future event instances
* Ideal for classes, webinars, and recurring events

=== 🔍 Smart Event Discovery (AJAX Powered) ===
* Real-time event filtering without page reload
* Filter by Category, Tag, Venue, Organizer, Date Range, Day, and Time
* Fast and smooth user experience
* Option to display past events when upcoming events are not available

👉 Shortcode:
**[eec_events_discovery]**

=== 🏷️ Event Organization ===
* Categories and Tags support
* Venue management 📍
* Organizer management 👤
* Dedicated archive pages

=== 📅 Calendar Export & Sync ===
* "Add to Calendar" buttons for individual events
* Support for Google Calendar, Yahoo Calendar, and iCalendar (.ics) downloads
* Global iCal feed link for syncing all upcoming events

=== 🗓️ Mini Calendar & Tools ===
* Compact Mini Calendar view for sidebars
* Includes a dedicated Mini Calendar widget
* Built-in Feedback form for user engagement

👉 Shortcode:
**[easy_event_calendar_mini]**

=== 🎨 Modern UI Design ===
* Clean and professional layouts
* Smooth animations and transitions
* Modern glass-style interface

=== ⚡ High Performance ===
* Optimized SQL queries
* Handles large event data efficiently
* Fast pagination system

=== 📱 Fully Responsive ===
* Mobile-friendly layouts
* Compact pagination for small screens
* Works perfectly on all devices

---

== 🎨 Available Views ==

📅 Calendar View – Full month layout  
🧱 Grid View – Card-based modern layout  
📋 List View – Clean listing format  
🧩 Staggered (Masonry) – Dynamic layout  
🎞️ Slider View – Interactive event slider  
🗓️ Mini Calendar – Compact sidebar calendar view

---

== Frequently Asked Questions ==

= 🔁 Does this support recurring events? =
Yes. You can create events that repeat daily, weekly, monthly, or yearly. The system automatically generates future occurrences.

= ⚡ How does the discovery shortcode work? =
The [eec_events_discovery] shortcode provides a real-time AJAX filtering interface. Users can filter events instantly without page reload.

= 📱 Is it mobile-friendly? =
Yes. All layouts are fully responsive and optimized for mobile devices.

= 🧑‍💻 Can I create events manually inside WordPress? =
Yes. You can create and manage events directly using the built-in "Easy Events" custom post type without relying on external sources.

= 🔌 Can I import events from other platforms? =
Yes. The plugin supports integration with Eventbrite, Facebook Events, Meetup, and other popular event plugins.

= 🎨 Can I change the layout or design of events? =
Yes. You can choose from multiple layouts like Calendar, Grid, List, Masonry, and Slider to match your website design.

= ⚡ Will it slow down my website? =
No. The plugin is optimized with efficient SQL queries and AJAX loading to ensure fast performance even with a large number of events.

= 🏷️ Can I filter events by category or organizer? =
Yes. Users can filter events by Category, Tag, Venue, and Organizer using the AJAX-powered discovery system.

= 🗓️ How do I add a Mini Calendar to my sidebar? =
You can easily display a compact Mini Calendar in your sidebar, footer, or any widget area by using the `[easy_event_calendar_mini]` shortcode. This view is fully responsive and perfect for saving space.

== 🔗 Supported External Sources ==

Easy Events Calendar also works seamlessly with the following third-party plugins:

* [Import Eventbrite Events](https://wordpress.org/plugins/import-eventbrite-events/)
* [Import Social Events](https://wordpress.org/plugins/import-facebook-events/)
* [Import Meetup Events](https://wordpress.org/plugins/import-meetup-events/)
* [WP Event Aggregator](https://wordpress.org/plugins/wp-event-aggregator/)
* [EventON](https://wordpress.org/plugins/eventon-lite/)
* [Events Manager](https://wordpress.org/plugins/events-manager/)

---

== ⚙️ Installation ==

1. Upload the plugin folder to /wp-content/plugins/ or install via dashboard  
2. Activate the plugin  
3. Go to Settings > Easy Events Calendar  
4. Start creating events from "Easy Events" menu  

📌 Shortcodes:

Use the following shortcodes to display events on your website:

**[eec_events_discovery]** – Displays AJAX-powered event discovery with filters.
**[easy_events_calendar]** – Shows the classic events calendar view. 
**[easy_event_calendar_mini]** – Displays the compact Mini Calendar.

---

== Screenshots ==

1. Calendar View – Browse upcoming events in an interactive calendar layout.
2. Grid View – Display events in a modern and visually appealing grid format.
3. List View – View events in a simple and easy-to-read list layout.
4. Masonry View – Showcase events in a dynamic staggered grid design.
5. Slider View – Highlight events using a smooth carousel slider.
6. Settings Panel – Customize layouts, styles, and event display options easily.
7. Event Discovery Grid – Search and explore events in a grid-based layout.
8. Event Discovery List – Find events quickly with a clean list-style search view.
9. Event Widget Backend – Configure event widgets with flexible backend options.
10. Event Widget Frontend – Display selected events beautifully on your website.
11. Gutenberg Block – Add and manage event layouts directly in the block editor. 
12. Mini Calendar (Widget) – Display a compact interactive calendar in the sidebar.
13. Single Event Page – View full details, location, and add to calendar options for an event.

---

== 📜 Changelog ==

= 1.1.1 =
* ADDED: Custom Recurring events Option.
* ADDED: "Add to Calendar" integration with Google Calendar, Yahoo Calendar, and iCalendar (.ics) file download.
* ADDED: iCal feed link for all upcoming events.
* ADDED: Mini Calendar view.
* ADDED: Mini Calendar widget for sidebars.
* ADDED: Feedback form.
* ADDED: Advanced event filters including Category, Tag, Location, Organizer, Date From, Date To, Day, and Time.
* ADDED: Option to display past events when no upcoming events are available.
* IMPROVEMENTS: Completely modernized and premium admin GUI, replacing basic design settings.
* IMPROVEMENTS: Enhanced security through improved data sanitization.

= 1.1.0 =
* ADDED: New "Related Events" support with term-based matching (Category, Tag, Venue, Organizer) to automatically display related events.
* ADDED: Advanced "Upcoming Events" widget with 10 unique styles (Timeline, Masonry, List, Card Grid, Badge, etc.), fully customizable from the admin panel.
* ADDED: AJAX filtering and layout toggle in [eec_events_discovery] shortcode with live search and Grid/List view switching.
* ADDED: Custom post type for internal events.
* ADDED: Custom taxonomies — Category, Tag, Organizer, and Venue.
* ADDED: Full support for recurring events with instance-based date handling.
* ADDED: Randomized professional placeholder images for events without featured images.
* ADDED: Design customization settings including Colors, Typography, and Header visibility controls.
* FIXED: Tooltip positioning and visibility issues.
* FIXED: Security and input sanitization improvements across all inputs.
* IMPROVEMENTS: Enhanced metadata support including venue addresses, Google Maps (latitude/longitude), and organizer contact details.
* IMPROVEMENTS: Organizer taxonomy changed to hierarchical for better admin experience.
* IMPROVEMENTS: Unified event data retrieval logic for improved performance.
* IMPROVEMENTS: Added compatibility support for WordPress 7.0.

= 1.0.3 =
* ADDED: New slider layout.
* ADDED: Support for multiple widgets.
* ADDED: Option to hide the header.
* ADDED: Category parameter support in the shortcode.
* IMPROVEMENTS: Security and code quality improvements.

= 1.0.2 =
* ADDED: Support for EventOn plugin.
* ADDED: Support for Events Manager plugin.
* FIXED: Issue with event ordering in Masonry(Staggered) layout.

= 1.0.1 =
* Updated plugin branding and improved overall presentation.

= 1.0.0 =
* Initial release
* Display support for Eventbrite, Meetup, Facebook Events, and WP Event Aggregator
* Includes 4 unique views: Calendar, Grid, Row, and Masonry
* Load More feature with pagination settings
* Button text and colour customisation options

---

== 🚀 Upgrade Notice ==

= 1.1.0 =
Major update with Internal Events, Recurring System, and AJAX Event Discovery.