=== Vizou Events Manager ===

Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.3
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, ticket email, 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.
* Change the ticket button link globally and/or on a per-event basis
* 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 ==

* Beginning with version 1.0.0, check for updates from the WordPress admin plugins page and click to auto-update, or 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 paid) 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:

Full documention is on the plugin Help page in the WordPress admin.

[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"]

== Changelog ==

= 1.0.4 =
* Fixed a bug where the date and sorting became corrupted on sites using verbose date formats

= 1.0.3 =
* Added a Ticket email field option to the Event editor

= 1.0.2 =
* Removed the standard Title field to make the Venue Name field the source for that information in the Event editor screen (via the dropdown selector or + Add New Venue option)

= 1.0.1 =
* Added an option to customize the ticket button text on a per-event basis

= 1.0.0 =
* Added the ability to check for and auto-update from the WordPress admin plugins page

= 0.1.14 =
* Added a "Buy me a latte" donation link to the Settings page ; )

= 0.1.13 =
* Removed continual two-way sync between event title and event venue to simplify entry
* Changed default list and single events templates to display the event status when there is no ticket link and the status is NOT cancelled. This display can still be customized with your own template override
* Small changes to the default CSS to improve readability and targeting of data, a single mobile breakpoint (you can override this)
* Changed the "reschedule" status labels to "To be confirmed" (you can still customize the frontend output)
* Added a "Changes saved" confirmation message to the Settings page after saving

= 0.1.12 =
* New Settings option to add a custom "Request a show" text with a link
* New shortcode parameter to display the custom show request link anywhere in your site
* New shortcode parameter to exclude one or more tours by ID from regular display (upcoming, for example)
* Updated single event template and corresponding default CSS
* Updated template tags to output whatever is in the default editor area (WordPress editor) as is and tightened up security of output
* Made small tweaks to default event list template to improve formatting
* Updated plugin help screen and Read Me pages to include new shortcode usage guide

= 0.1.11 =
* Fixed an import bug that caused issues with end dates
* Updated template tags for naming consistency
* Updated default list and single templates to reflect template tag changes
* Updated default CSS to include new classes
* Added batch editing of tour taxonomy and event status in the All Events Quick Edit window
* Made the event date column first in the All Events view
* Added shortcode options to display multiple years, tours and artists
* Updated template tags for customizing event display in your theme, including the addition of an event post info link ("Read more")

= 0.1.10 =
* Fixed the optional display of an Event featured image (it wasn't displaying when set). Both the event list and single templates were updated to use standard WordPress attachment query and output

= 0.1.9 =
* Fixed a date/timezone inconsistency across the plugin to ensure that event dates display to match the site's settings

= 0.1.8 =
* Updated vizou-events-list template to properly respect and display the site's default date and time settings as set in Settings/General
* Added CSS classes "event-start-date" and "event-end-date" to allow for easier styling (included in both listing and single event templates)
* Added CSS classes "venue-first" and "artist-first" to aid styling of different use cases
* Updated default CSS to use forward slash between venue and artist when both are present
* Corrected a typo in default CSS hiding some past event elements

= 0.1.7 =
* Fixed a bug where past events didn't get proper class
* Made the events list template a single file
* Improved syncing of Event post title and Venue field
* Updated permalink structure to be more compatible with WordPress chosen structure
* Made default single event template work with new permalink structure

= 0.1.6 =
* Changed Event editor field "Event name" to "Venue name" to maintain consistency (post title and venue name share the same data)
* Added descriptions and instructions to Venue name, Artist and Tours fields in the event editor
* Added a template tag system to help with custom overrides (in the theme) of both list and single event output
* Added a Settings option to choose whether Venue or Artist should be displayed first in the default events list template and improved Settings layout
* Added syncing of custom status text with the Event editor view
* Changed "Import/Export" to "Tools" to future-proof in the event of new options being added there
* Split override templates into "start", "end" and "list" for ease of use and updated shortcode and permalink handling for the new template structure
* Updated permalink structure to add artist to the URL (venue-name-artist-yyyy-mm-dd)
* Added Quick Edit option to All Events admin view

= 0.1.5 =
* Updated taxonomies and venue handler include files to use the proper "event_" field key (like other plugin field data) for termmeta table in WordPress database, with backward compatibility for any sites where it didn't already do this
* Updated default list and single event templates to check for either type of field key (for backward compatibility)

= 0.1.4 =
* Added container class to output
* Updated CSS to include new class
* Updated Help page

= 0.1.3 =
* Updated default CSS
* Automatically add publish date to duplicate venue permalinks

= 0.1.1 =
* Added address fields to Venue management taxonomy
* Improved syncing between Venue and Artist management and Event editor
* Improved loading of pre-populated fields in Event Editor
* Added auto-generated, SEO-friendly URLs
* Added single event template and option to override it
* Changed default All Events order to descending (future dates at top)
* Updates to Import/Export functions
* Improved default CSS
