Website owners - slimndap/wp-theatre GitHub Wiki

Events vs. productions

Theatre uses productions to group your events. Each production has its own page and can have one or more events. Events don't have their own pages. They only appear on pages with event listings.

So if you run a theatre then 'The Sound Of Music' is a production and the show this weekend is an event. If you're a musician then your band is a production and your gigs are the events.

Upcoming events

To add a listing with all upcoming events to your Wordpress website:

  1. Create a new blank page (eg. 'Upcoming events').
  2. Place [wpt_events] in the content.
  3. Publish the page and view it.
  4. Done!

See the Shortcodes for more examples.

Widgets

Theatre also comes with two widgets to show your upcoming events in the sidebar:

  • Theatre Events: a list of upcoming events.
  • Theatre Productions: a list of productions with upcoming events.

You can limit the size of the lists in the corresponding widget's settings.

Production pages

Production pages look exactly the same as regular post pages. However, you can add a listing of all the events for the current production to the page.

You have two options:

  • Check 'Show events on production page' on the Theatre settings page in the Wordpress admin. The listing is added to the bottom of the content of the production.
  • Add the [wpt_production_events] shortcode to the content of the production.

Sometimes you just want to show a tickets button for one of your events. You can use the following shortcode for this:

[wpt_event_ticket_button id=123]

Where '123' is the ID of your event.

See: Shortcodes#wiki-production-event-listing