=== FCA Events Basic ===
Contributors: fluentcommunityaddons
Donate link: https://fluentcommunityaddons.com/
Tags: events, calendar, fluent-community, event-management, community
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Simple event management for Fluent Community. Create events, display them in grid/list/week views, and let users save events.

== Description ==

**FCA Events Basic** adds simple but powerful event management to your Fluent Community portal.

Perfect for community managers who want to share upcoming events, meetings, webinars, or gatherings with their members — without the complexity of full event ticketing systems.

= Features =

**Event Management**
* Create and edit events with title, description, date, time, and location
* Support for both in-person and online events
* Featured images for event cards
* Draft and publish status
* Event categories for organization

**Multiple Display Views**
* **Grid view** — Beautiful card-based layout with date badges
* **List view** — Compact list for scanning many events
* **Week view** — See events grouped by day for the current week

**Member Features**
* Save/bookmark events for quick access
* Add events to calendar (Google, Outlook, Yahoo, Apple)
* Share events via social media
* Responsive design works on all devices

**Date & Time Handling**
* Full timezone support — set event timezone independently
* Display times in 12h or 24h format
* Optional: Show user's local timezone alongside event time
* Configurable week start day (Monday/Sunday)

**Fluent Community Integration**
* Seamlessly integrates into your FC portal
* Respects FC access permissions
* Uses FC styling and design system
* Adds Events menu to sidebar and/or header

= Requirements =

* WordPress 5.8 or higher
* PHP 7.4 or higher
* [Fluent Community](https://fluentcommunity.co/) plugin (free or pro)

= Documentation =

Complete user guide available in the `docs/` folder or visit [Fluent Community Add-ons](https://fluentcommunityaddons.com/)

= Full Feature List =

**Event Management**
- Create and edit events with rich text descriptions
- Draft system for editing published events without unpublishing
- Featured images with 400px display on detail pages
- Event categories with inline creation
- Online and in-person event support
- Clickable URLs for online events

**Display Views**
- Grid, List, and Week views
- Responsive design for all devices
- Pagination and infinite scroll options

**Member Features**
- Save/bookmark events
- Add to calendar (Google, Outlook, Yahoo, Apple)
- Share events via social media
- Full timezone support with local time conversion

**Admin Features**
- Frontend event deletion
- Comprehensive timezone filtering (400+ timezones)
- Customizable sidebar and header menu labels
- RTL language support
- WCAG 2.1 AA accessibility compliant

== Installation ==

= Automatic Installation =

1. Go to **Plugins → Add New** in your WordPress admin
2. Search for "FCA Events Basic"
3. Click **Install Now**, then **Activate**

= Manual Installation =

1. Download the plugin ZIP file
2. Go to **Plugins → Add New → Upload Plugin**
3. Choose the ZIP file and click **Install Now**
4. Click **Activate**

= After Activation =

1. Make sure Fluent Community is installed and activated
2. Go to **Events** in your WordPress admin to create your first event
3. Visit your Fluent Community portal — the Events menu will appear automatically

== Frequently Asked Questions ==

= Does this work without Fluent Community? =

No. This plugin is specifically designed as an add-on for Fluent Community and requires it to function.

= Can users register for events? =

Not in this basic version. FCA Events Basic is for displaying events only. For registration, ticketing, and capacity management, check out our premium version.

= Is there a calendar view? =

The week view shows a 7-day calendar. A full month calendar view is available in our premium version.

= Can I import events from other calendars? =

Bulk import is available via the REST API for developers. iCal/ICS import is available in the premium version.

= Does it work with page builders? =

This plugin integrates specifically with Fluent Community's portal system. It does not provide standalone blocks or shortcodes for page builders.

= How do I customize the styling? =

The plugin inherits styles from Fluent Community. Custom CSS can be added via the WordPress Customizer or your theme.

= Is it multisite compatible? =

Yes, you can activate it on individual sites in a multisite network.

== Screenshots ==

1. Events grid view showing upcoming events with featured images (screenshot-1.png)
2. Event detail page with two-column layout (screenshot-2.png)
3. Event creation/editing interface with TipTap editor (screenshot-3.png)
4. Week view showing events grouped by day (screenshot-4.png)
5. Settings page with timezone multiselect (screenshot-5.png)

== Changelog ==

= 1.0.3 =
* Version bump

= 1.0.2 =
* Finalized RTL support with comprehensive layout fixes
* Fixed event sorting by date (not creation date)
* Added Upcoming/Past tabs with end_date logic
* Added sort order dropdown (Soonest/Latest first)
* Fixed menu items not showing on first activation
* Updated all translation strings (130+ strings)
* Verified accessibility and RTL compliance

= 1.0.1 =
* Added frontend event deletion for admins
* Added inline category creation from event edit page
* Added comprehensive timezone filtering (select which timezones to show)
* Separated sidebar group and item labels for independent customization
* Fixed sidebar menu configuration to properly use settings
* Added comprehensive RTL support and accessibility improvements
* Added TipTap rich text editor with full formatting options
* Added child draft system for editing published events without unpublishing
* Improved timezone list to include all PHP timezones (400+)

= 1.0.0 =
* Initial release
* Event creation and management
* Grid, list, and week views
* Save/bookmark events
* Add to calendar functionality
* Share events
* Full timezone support
* Fluent Community integration

== Upgrade Notice ==

= 1.0.1 =
Major feature update with frontend deletion, category creation, timezone filtering, and accessibility improvements.

= 1.0.0 =
Initial release. No upgrade necessary.

== Privacy Policy ==

FCA Events Basic stores the following data:

* **Event data** — stored as WordPress custom post types
* **User bookmarks** — stored as user meta (which events a user has saved)

This data is stored on your WordPress site and is not transmitted to external servers.

== Credits ==

* Built by [Fluent Community Add-ons](https://fluentcommunityaddons.com/)
* Uses [Vue.js](https://vuejs.org/) for the frontend interface
* Icons by [Solar Icon Set](https://solar-icons.com/)

== License ==

FCA Events Basic is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
