=== Vizou Events Manager ===

Requires at least: 6.0
Tested up to: 6.8
Stable tag: 0.1.13
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Events management for artists. Requires Advanced Custom Fields plugin (free or Pro) to be active.

== Description ==

The Vizou Events Manager plugin allows you to create events to be displayed in your website via a shortcode with multiple parameters.

Features include:

* Custom post type (Events) making it easier to manage event posts all in one place
* Event data including venue, artist, date, address, venue URL, ticket URL, tour, and event status
* Automatically add a venue, artist or tour to the database
* Choose from existing venues, artists and tours
* Add, edit and delete venues, artists and tours independently
* Display event listings in a shortcode that filters on date, status, tour, artist, limit (number of events)
* Override the default event template with a directory in your theme (your-theme/vizou-events/vizou-events-list.php)
* Override the default single event template with a directory in your theme (your-theme/vizou-events/vizou-events-single-event.php) or the standard WordPress single-event.php in your directory root
* Turn off default CSS (vizou-events-manager/assets/css/vizou-events.css) and add or modify your theme's style.css to suit your needs
* Provide your own "No events" text and replace event status names (Active, Cancelled, Sold out, To be confirmed) with your own.
* Provide a custom "Request a show" link via the template or using a shortcode
* Option to import events (based on deprecated GigPress plugin CSV, but can be any CSV with appropriate column headers)
* Export all events as a CSV file
* Remove all plugin data on uninstalling
* Help page

== Installation ==

Upload the plugin files to the /wp-content/plugins/plugin-name directory, or upload through the WordPress plugins screen directly
Activate the plugin through the 'Plugins' screen in WordPress
Visit Events/Settings to configure the plugin

== Updating ==

Download the latest version from explicable.ca and manually upload it to your site
Click on activate and choose to overwrite the existing version (your events won't be harmed)
If you have custom templates, it is possible that some updates might affect your layout (for example, if features with new classes are added). You can copy the new templates and compare and update as needed.

== FAQ ==

Visit https://explicable.ca/category/plugins/vizou-events-manager for detailed documentation.

* This plugin requires the Advanced Custom Fields plugin to be active (free or Pro) but won't crash the site if it isn't installed
* Custom fields (ACF json) are auto-imported on plugin activation but are not visible in WordPress admin to prevent accidents to event field data.

Shortcode use:

[vizou-events] is the default shortcode and gets all active, upcoming events in ascending order.

Use with parameters to get a variety of data:
  * show: "upcoming" (default), "past", or "all"
  * year - YYYY to filter by year
  * order - "asc" (default, nearest date from today first) or "desc" (latest date first)
  * artist - by ID (see Events/Artists)
  * tour - by ID (see Events/Tours)
  * exclude_tour - exclude tour by ID (see Events/Tours)
  * limit - number of events to show (-1 for all)
  * request-show - true or false

  Examples
  * [vizou-events year="2025" artist="3" order="desc"]
  * [vizou-events show="upcoming" exclude_tour="15"]
  * [vizou-events show="upcoming" exclude_tour="15, 20, 33"]
