=== TIXARENA Events ===
Contributors: tixarena
Tags: events, tickets, tixarena, calendar, block
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display your TIXARENA events on your WordPress site. Customers complete checkout securely on TIXARENA.

== Description ==

Connect your WordPress site to your TIXARENA producer account and show your upcoming events directly on your pages. Your visitors browse the event list on your site; when they click Buy, they complete the checkout on TIXARENA, where you already manage payments, delivery and attendee data.

Features:

* **Gutenberg block**, **Elementor widget**, and **shortcode** (`[tixarena_events]`)
* **Three layouts**: grid, list, card
* **Six languages** out of the box: English, Portuguese, Spanish, Italian, French, German (more via translate.wordpress.org)
* **Encrypted key storage** (AES-256-GCM using your site's auth salt)
* **Local cache** with configurable TTL (default 1 hour)
* **Theme override**: copy a template to `your-theme/tixarena-events/events-grid.php` to customize
* **Accept-Language aware**: event content is served in the site's language when your TIXARENA account supports it
* **No personal visitor data sent** — the plugin reads from your account only

Shortcode examples:

    [tixarena_events]
    [tixarena_events limit="9" layout="grid"]
    [tixarena_events limit="20" layout="list" theme="dark"]
    [tixarena_events limit="1" layout="card"]

The plugin is read-only: it fetches published events from your TIXARENA account. It does not process payments on WordPress.

== Installation ==

1. Install and activate the plugin.
2. In your TIXARENA producer dashboard, generate an API key.
3. In WordPress, go to **Settings → TIXARENA Events** and paste the key.
4. Click **Validate API Key** to confirm the connection.
5. Add the "TIXARENA Events" block to a page, or use `[tixarena_events limit="6" layout="grid"]` in post content.

== Frequently Asked Questions ==

= Where does the checkout happen? =

On TIXARENA. The plugin only displays your events. When someone clicks Buy, they're taken to the TIXARENA event page to complete the purchase.

= Can I customize the look? =

Yes. Copy `templates/events-grid.php` (or the layout you use) from the plugin into `your-theme/tixarena-events/events-grid.php` and edit it. Your changes survive plugin updates.

= Is the API key safe in the database? =

The key is encrypted at rest using AES-256-GCM. The encryption key is derived from your site's `wp_salt('auth')`, so every WordPress install has a unique encryption key.

= How often are events refreshed? =

By default the plugin caches API responses for 1 hour. You can lower it in the settings page, or click "Clear Cache" to force a refresh.

= Can I translate it to my language? =

Yes. The plugin ships with English, Portuguese, Spanish, Italian, French, and German. You can contribute other locales via translate.wordpress.org.

== Screenshots ==

1. Grid layout on the frontend
2. Gutenberg block in the editor
3. Settings page

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
First public release.
