=== Planzio Event Calendar ===
Contributors: mahethekiller
Tags: events, calendar, events calendar, responsive calendar, event manager
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern, lightweight and SEO-friendly event calendar. Features responsive grids, clean lists, AJAX lightboxes, and automatic SEO Event schema.

== Description ==

Planzio Event Calendar is a highly performant and beautifully styled WordPress plugin designed to help you create, manage, and display events with maximum ease. Built with modern styling (Outfit Google Font, glassmorphism elements, sleek transitions) and conforming to strict coding standards, this plugin integrates seamlessly into any WordPress theme.

One of the most powerful features of Planzio Event Calendar is its native SEO-friendliness. The plugin automatically generates and injects valid Schema.org Event JSON-LD metadata into your event page headers, making it incredibly easy for search engines like Google to index your events and show them in rich snippets and search results (Google Events).

Upgrade to the Pro version to unlock advanced recurrences (daily, weekly, monthly, custom), geolocation maps (Google Maps and Leaflet OpenStreetMap integrations), and virtual webinar access countdowns.

= Key Features (Free) =
* **Multiple Display Layouts**: Render your events in a standard clean List layout or a responsive Masonry Card Grid.
* **AJAX Lightbox Popup**: Open event details instantly inside a modern styled modal popup without page reloads.
* **Built-in Event Schema**: Timezone-aware Schema.org JSON-LD event structured data injected dynamically in headers for stellar SEO.
* **Event Customization**: Add start/end dates and times, configure unique branding colors for individual events, and add detailed descriptions.
* **Google Fonts Integration**: Styled natively with the modern Outfit typography for a premium design feel.

= Pro Features (Available in Pro Version) =
* **Geographical Map Views**: Map layout using Google Maps API or OpenStreetMap Leaflet fallbacks.
* **Advanced Recurrences**: Set recurring events with Daily, Weekly, Monthly, or specific Custom Date overrides.
* **Virtual Webinar countdowns**: Hide Zoom or Google Meet URLs behind live countdown timers, or restrict access to logged-in users only.
* **Location & Organizer Managers**: Dedicated taxonomies to organize event venues and coordinators.

== External Services ==

This plugin connects to and uses the following external third-party web services to render layouts and dynamic location maps:

1. Google Fonts
* **Service Provider**: Google LLC
* **Purpose**: Loads the 'Outfit' font family to style admin panels and frontend event calendar layouts.
* **Data Transmitted**: Visitor IP addresses and standard web browser user-agent headers.
* **Terms / Privacy**: [Google Fonts Privacy Policy](https://policies.google.com/privacy)

2. Google Maps Embed API
* **Service Provider**: Google LLC
* **Purpose**: Renders an interactive embedded location map iframe on the single event sidebar layout when a street address is entered.
* **Data Transmitted**: Event location coordinates/address query and visitor browser details.
* **Terms / Privacy**: [Google Maps Terms of Service](https://www.google.com/help/terms_maps/) and [Google Privacy Policy](https://policies.google.com/privacy)

== Installation ==

1. Upload the `planzio-event-calendar` directory to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Configure settings under **Event Calendar -> Settings** (toggle SEO schema structured data).
4. Place the shortcode `[planzio_event_calendar view="list"]` or `[planzio_event_calendar view="masonry"]` in any page or post to display your events.

== Shortcode Guide ==

Use the following parameters to adjust layouts:
* `view`: Choose layout - `list` (default) or `masonry`.
* `limit`: Max number of events to load (e.g., `5`, default is `10`, `-1` for unlimited).
* `category`: Filter events by Category Slug or ID.
* `tag`: Filter events by Tag Slug or ID.
* `order`: Sorting order - `ASC` (ascending, chronological) or `DESC` (descending).
* `hide_past`: Toggle showing past events - `1` (hide, default) or `0` (show).

Example:
`[planzio_event_calendar view="masonry" limit="6" hide_past="1"]`

== Changelog ==

= 1.0.0 =
* Initial release of the free basic version.
* Integrated responsive List and Masonry Grid views.
* Added native Schema.org Event JSON-LD structured data injection for SEO.
* Audited and formatted code according to WordPress Coding Standards (WPCS).

