# Easy Events Calendar

**Easy Events Calendar** displays upcoming events from various third-party plugins in a unified, responsive, and customizable calendar with multiple layout options.

📅 **Supports Events Imported From:**
- Import Eventbrite Events
- Import Social Events
- Import Meetup Events
- WP Event Aggregator

🎨 **View Layouts:**
- **Calendar View** – Classic calendar layout with event highlights.
- **Grid View** – Card-style event listings with responsive grid.
- **Row View** – Clean horizontal list view of upcoming events.
- **Staggered View (Masonry)** – Pinterest-style layout with dynamic heights.

---

## ✨ Features

- Display events imported from multiple sources in one calendar.
- Clean, responsive, and lightweight event display system.
- Multiple layout options: Calendar, Grid, Row, and Masonry.
- Customizable load more button: text, background color, text color.
- Pagination setting to control how many events to show at once.
- Settings panel to manage appearance and functionality.
- Shortcode: `[easy_events_calendar]` to render events anywhere.
- Compatible with modern WordPress versions.

---

## 🚀 Installation

1. Upload the plugin to the `/wp-content/plugins/` directory.
2. Activate the plugin via **Plugins > Installed Plugins**.
3. Go to **Settings > Easy Events Calendar** to configure options.
4. Use the shortcode `[easy_events_calendar]` in any page or post.

---

## 🔧 Plugin Settings

- **Button Text**
- **Button Background Color**
- **Button Text Color**
- **Load More Button Text**
- **Load More Event Count (Pagination)**

---

## ❓ FAQ

### Which plugins are required to fetch events?

You need at least one of the following import plugins:
- Import Eventbrite Events
- Import Social Events
- Import Meetup Events
- WP Event Aggregator

### Can I customize the appearance?

Yes, you can change the button text, button color, text color, and the number of events shown before "load more".

### How do I display the calendar?

Use the shortcode `[easy_events_calendar]` in your content or use the widget/block in your theme.

---

## 📷 Screenshots

1. Calendar view showing multiple event sources.
2. Grid view layout of events.
3. Row view layout for a clean event list.
4. Staggered (masonry) view for Pinterest-style layout.
5. Admin settings for appearance and display options.

---

## 🗒️ Changelog

### 1.0.0
- Initial release
- Supports Eventbrite, Meetup, Facebook Events, and WP Event Aggregator
- Includes 4 views: Calendar, Grid, Row, Staggered (Masonry)
- Load more, button customization, and pagination support

---

## 📄 License

GPLv2 or later  
https://www.gnu.org/licenses/gpl-2.0.html

---

## 🧠 Credits

Crafted with ❤️ by [Xylus Themes](https://xylusthemes.com)
