# daml-giglist 
Contributors: damedialimited, daveboulden
Donate link: https://paypal.me/DAMediaLimited?locale.x=en_GB
Tags: gig, event, calendar, band, musician, artist, shows, concert, list
Requires at least: 5.0
Tested up to: 6.6
Requires PHP: 7.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

A WordPress plugin to create and maintain a list of gigs or events on your website.

## Description 
**DA Media Gig List** enables you to create a configurable gig list to display on your WordPress site. It will manage all gigs and venues along with their corresponding details. It provides multiple options to display a configurable gig list to suit your specific requirements.

The plugin creates two new Custom Post Types, one for **Gigs** and one for **Venues**.

The Venue post type contains extra fields for the venue address and contact details as well as a Google Maps link.

The Gig post type provides extra fields for the Gig's date and start time plus a link to a Venue.

The plugin provides options to display the Gig List as an overridable templated page or via a shortcode in widgets, posts and pages. Gigs are shown in date order and may be grouped by either year or month or with no grouping at all.

Also included is an admin page with a simple to use UI to create a shortcode by selecting your choices from all available options in a dynamic set of dropdown fields and date-pickers. This can then be simply copy & pasted into your page, post or widget.

### Shortcode

The format of the short code to display the gig list in pages, posts and widgets is:

**`[damlgiglist group_by="Month|Year|None" sort_by="date_asc|date_desc" list_title="My gig list" start_date="tomorrow" end_date="last day of December this year" limit="10" show_headers="Y|N"]`**

The **`group_by`** parameter will group the gigs by month or year if **"Month"** or **"Year"** is supplied as the parameter. Any other value will suppress all grouping.

The **`sort_by`** parameter will sort the gigs ascending date **"date_asc"** is supplied as the parameter or descending date if **"date_desc"** is supplied.

The **`title`** parameter can be used to override the plugin settings default. Specifying an empty title remove the title altogether even if there is a value in the plugin settings default title.

The **`start_date`** and **`end_date`** parameters are used to set which gigs are shown. You can use textual PHP format relative dates (see more information here: https://www.php.net/manual/en/datetime.formats.relative.php) If you require a fixed date, it must be specified in the format: **`YYYY-MM-DD`**. Any gigs outside the supplied from and to dates will not be shown. The date parameters default to the default dates set in the Gig List Settings admin page if no values are supplied or the parameters are omitted.

## Installation 
 
1. Upload the plugin files to the /wp-content/plugins/plugin-name directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the DAML Gig List->Gig List Settings screen to configure your desired defaults
 
## Frequently Asked Questions 
 
### How do I choose the dates to only show gigs for this year 
 
The **Start Date** and **End Date** fields offer many options to set the date limits of the displayed gig list. For this specific option, choose _"First day of this year"_ for the **Start Date** and _"Last day of this year"_ for the **End Date**.
 
### Can I group gigs by date? 
 
There are currently three options: 

1. **Group by Month** _(e.g. groups gigs into blocks for January, February, March etc.)_ Note, the month is displayed alongside the year so that months are grouped individually across multiple years.
2. **Group by Year** _(e.g. groups gigs into blocks for 2020, 2021, 2022 etc.)_
3. **No grouping.** All gigs are displayed in one contiguous list.
 
## Screenshots 
 
## Changelog 
 
### 1.0
* Initial release.
 
 
## Upgrade Notice 
### 1.1.0
Added support for overriding Gig, Venue amd Gig List templates.

### 1.2.0
Added Website field to Gig and Venue post types. Added Email field to Venue post type. Shortcode generated gig lists can now be limited by number of gigs.

### 1.3.0
New option to show/hide the Date and Venue headings in the main giglist display.

### 1.4.0
* Option for automatic, default or manual gig post type titles

### 1.5.0
* Internal code improvements and typo fixes

### 1.6.0
* Added widget with same capabilities as short-code

### 1.7.0
* CSV import of Gigs and Venues is now implemented

### 1.7.1
* Push new version to mitigate failed upload to SVN of new importer class

### 1.8.0
* Compatible with WordPress 5.7

### 1.9.0
* New 'sort by' paramneter for default, shortcode and widget settings to sort by asecending or descending date
* Compatible with WordPress 6.6

## Translations 

* English - default, always included

### Machine translated by Yandex 
* Danish: Dansk
* Dutch: Nederlands
* Finnish: Suomi
* French: Français
* German: Deutsch 
* Greek: Ελληνικά
* Italian: Italiano
* Japanese: 日本語
* Polish: Polski
* Portuguese: Português
* Russian: Русский
* Spanish: Español
* Swedish: Svenska
* Ukranian: Українська