forked from slimndap/wp-theatre
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
286 lines (201 loc) · 14.7 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
=== Theater for WordPress ===
Contributors: slimndap
Tags: theatre, stage, venue, events, shows, concerts, tickets, ticketing, sports, performances, calendar, festival, workshops, theater, cinema
Requires at least: 4.0
Tested up to: 4.7
Stable tag: 0.15
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=CZERCBG5SUGQW
A free plugin to publish your events on a WordPress website. Perfect for theaters, live venues, cinemas and festivals.
== Description ==
A WordPress plugin to manage events with all necessary shortcodes and widgets for your theater.
__Shortcodes__
Theater comes with several shortcodes and widgets to show off your events. See the [documentation](https://github.com/slimndap/wp-theatre/wiki/Shortcodes) for an overview.
__Extensions__
* [Event Duplicator](https://wp.theater/downloads/event-duplicator-for-theater/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) – This __free__ extension adds a new action to the event editor that instantly duplicates the event. Very helpful if your need to enter a lot of events at once.
* [Events Feed](https://wp.theater/downloads/events-feed/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) - Automatically show your events in your email newsletter. Works perfectly with Mailchimp and other email marketing solutions.
* [Events Slider](https://wp.theater/downloads/events-slider-theater/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) – Show your events in a touch enabled and responsive slider.
* [Timetable](https://wp.theater/downloads/timetable-for-theater/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) – Show your event showtimes in a clear table layout. Perfect for cinemas and festivals.
* [Kijkwijzer](https://wp.theater/downloads/kijkwijzer-for-theater/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) – Add Kijkwijzer icons to your events.
* [MPAA](https://wp.theater/downloads/mpaa-for-theater/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) – Add Motion Picture Association of America (MPAA) film rating labels to your movies.
* [BBFC](https://wp.theater/downloads/bbfc-for-theater/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) – Add British Board of Film Classification (BBFC) icons to your movies.
__Integrate with your existing ticketing solution__
* [ActiveTickets](https://wp.theater/downloads/activetickets-for-wordpress/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) - Automatically import your ActiveTickets events and sell them through your website.
* [SRO4](https://wp.theater/downloads/sro4-for-wordpress/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) - Automatically import your SRO4 events and sell them on your website.
* [Stager](https://wp.theater/downloads/stager-for-wordpress/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) - Automatically import your Stager concerts and sell them on your website.
* [Ticketlab](https://wp.theater/downloads/ticketlab-for-wordpress/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) - Automatically import your Ticketlab films and sell them on your website.
* [Ticketmatic](https://wp.theater/downloads/ticketmatic-for-wordpress/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) - Automatically import your Ticketmatic events and sell them on your website.
* [Veezi](https://wp.theater/downloads/veezi-for-wordpress/?utm_source=wordpress.org&utm_medium=web&utm_campaign=readme.txt&utm_content=description) - Automatically import your Veezi films and sell them on your website.
__Missing features?__
Submit a request on the [forum](http://wordpress.org/support/plugin/theatre).
__Extending Theater for WordPress__
Easy! Write your own plugins that extend Theater for WordPress. Check out my [example](https://github.com/slimndap/wp-theatre-example-extension) plugin on GitHub.
__Contributors welcome__
* Submit a [pull request on GitHub](https://github.com/slimndap/wp-theatre)
== Installation ==
This section describes how to install the plugin and get it working.
__Installation__
1. Go to _Plugins_ → _Add new_.
1. Search for 'Theater'.
1. Look for the _Theater for WordPress_ plugin and click on _Install now_.
1. Wait for the next screen to load and click on _Activate Plugin_.
__Add events__
Theater for WordPress uses _productions_ to group your _events_. Each production can have one or more events.
Add your first event:
1. Go to _Theater_ → _Productions_ → _Add new_.
1. Enter a title and description for your production.
1. Scroll down and click on _Add a new event_.
1. Enter a start time that is in the future.
1. Enter the other details for your event.
1. Click on _Save event_.
1. Add a featured image (if your theme supports it).
1. Click on _Publish_.
__Show your events__
You can show your upcoming events on a page.
1. Go to _Pages_ → _Add new_.
1. Give your page a title (eg. 'Upcoming events').
1. Click on _Publish_.
1. Go to _Theater_ → _Settings_ → _Display_.
1. Set _Page to show upcoming events on_ to the page that you just created.
1. Set _Position on page_ to _show above content_.
1. Click on _Save Changes_.
1. Go to _Theater_ → _Settings_ → _Style_.
1. Check _Enable built-in Theater stylesheet_.
1. Click on _Save Changes_.
The page that you created now shows your upcoming events.
== Screenshots ==
1. Manage events in the WordPress admin.
2. The event editor.
3. Manage events in the WordPress admin.
4. Your upcoming events listed on your website.
5. Event details.
== Frequently Asked Questions ==
__All event listings look really weird!__
Make sure that you checked the 'Enable built-in Theater stylesheet'-option in the Theater plugin settings.
__I don't see the Theater Calendar widget__
Make sure that you select a page to show your event listings on in the Theater plugin settings.
__I really need feature X. Can you add it?__
If you are missing a feature that you really need for your website you can:
1. submit a feature request on the [forum](http://wordpress.org/support/plugin/theatre) or
1. add it yourself and submit a pull request on [GitHub](https://github.com/slimndap/wp-theatre) or
1. [hire me](mailto:[email protected]).
The new feature may be added directly to the Theater plugin or as an extension so that others may benefit from this as well.
== Changelog ==
= 0.15 =
Release Date: March 22nd, 2016
This release focusses on a more streamlined experience when managing your events. Let me know what you think and if you are missing anything in the [forum](https://wordpress.org/support/plugin/theatre).
* Enhancements
* Renamed 'productions' to 'events'.
* Simplified the events admin screen.
* Added a new `{{prices}}` placeholder for productions (0.15.3).
* Events can now be filtered by tags (0.15.5).
* Activated events archive pages (0.15.10).
* You can now set until what time events should fall on the previous days using the `Theater/Helpers/Time/Next_Day_Start_Time_Offset` filter (0.15.11).
* Bugfix
* The translation setting for the header above events on the productions page was also being used in other places (eg. the admin menu) (0.15.2). Thank you [Bob Morris](https://wordpress.org/support/profile/bob-morris)!
* Seasons are now hidden from search results (0.15.3).
* The post slug was not working for events when using bulk edit in the events admin screen (0.15.5).
* Updates for extension plugins were not working anymore (0.15.6).
* Events where not always showing the correct end date.
* Search results no longer get lost when navigating on the Events page in the WordPress admin (0.15.9).
* Fixed an issue with the 'end' filter for events (0.15.10).
* Fixed the sort order of events on the admin screen after you changed the status of an event (0.15.13). Thank you [Menno Luitjes](https://www.linkedin.com/in/mennoluitjes)!
* Fixed a problem with the changelog of extensions if you're running multiple extensions (0.15.14).
* Fixed a problem with the event editor in WordPress 4.7 (0.15.15).
= 0.14 =
Release Date: February 2nd, 2016
* Enhancements
* The plugin is now ready for [language packs hosted on WordPress.org](https://make.wordpress.org/plugins/2015/09/01/plugin-translations-on-wordpress-org/). This makes it much easier for you to contribute a translation of the plugin in your native language. Add you translation [here](https://translate.wordpress.org/projects/wp-plugins/theatre).
* The `[wpt_events]` shortcode now accepts a `production` parameter to limit the a events list to one or more productions (0.14.4). See the updated [documentation](https://github.com/slimndap/wp-theatre/wiki/Shortcodes#event-listing) for examples.
* Bugfixes
* Fixed some layout glitches on the Theater extensions page (0.14.1).
* Listings were not working correctly if you combined the `start` and `post__not_in` params (0.14.2).
* Event imports didn't always clean up properly (0.14.2).
* Fixed a problem when saving a production with multiple events (0.14.3). Thank you [tomaszkoziara](https://github.com/tomaszkoziara)!
* Fixed several PHP warnings when no listing page is set in the Theater settings (0.14.3).
= 0.13 =
Release Date: September 3rd, 2015
* Enhancements
* Production listings can now be filtered by start and end dates. See the updated [documentation](https://github.com/slimndap/wp-theatre/wiki/Shortcodes#production-listing).
* Production listings can now be grouped and paginated by day, month or year.
* Stripped all unnecessary elements off the event edit screen.
* Made it possible to alter the behaviour of the tickets lightbox with a filter.
* You can now browse extensions inside the WordPress admin.
See the [release post](https://wp.theater/theater-for-wordpress-0-13-released/?utm_source=wordpress.org&utm_medium=web&utm_content=changelog&utm_campaign=readme.txt) for examples.
* Bugfixes
* Fixed a problem in production listings with events that start before 1-1-1970.
* Visibility of ticket buttons didn't account for timezones.
* Pagination for listings wasn't working when the listing page was the same as the front page.
* Weekdays were showing up as question marks when using a multibyte language (eg. Russian).
* Requirements
* The plugin is no longer tested on WordPress versions prior to 4.0 (0.13.3).
= 0.12 =
Release Date: July 3rd, 2015
* Enhancements
* You can adjust the slug for production detail pages in the permalink settings. Your URLs can now look like `http://example.com/show/billy-elliot` or `http://example.com/concert/kurt-vile`.
* New template placeholders for events: `{{starttime}}`, `{{startdate}}`, `{{endtime}}` and `{{enddate}}`. Thanks [jbrandligt](https://github.com/jbrandligt)!
* You can choose the size for your thumbnail placeholder: `{{thumbnail('large')}}`.
* The URLs for your ticket pages look nicer, if you use the iframe option: `http://example.com/tickets/billy-elliot/123`.
* Added new filters to manipulate the output of the Theater Production widget and the Theater Events widget.
* Updated the German translation. Thanks [henk23](https://github.com/henk23)!
* Added error messages to the import status. Thanks [Menno](https://www.linkedin.com/in/mennoluitjes)!
* Made it easier for extensions to add functionality to the event editor (0.12.4).
* Clean up
* Productions no longer have an archive page on `http://example.com/productions/`.
* Removed the Theater dashboard widget since it was kind off useless and slowing the admin interface down.
* Bugfixes
* Some past events were showing a false tickets status.
* It was impossible to clear a value for an event field.
* Events were polluting the 'link to existing content' section on the 'Insert/edit link' dialog (0.12.3).
* Fixed a timezone problem with the `{{datetime}}` template tag (0.12.6).
* Fixed a lightbox problem with themes that don't properly support screen-reader texts (0.12.6).
* Fixed a problem with invalid event end dates (0.12.7).
* The tickets status was not being saved when creating a new event (0.12.7).
= 0.11 =
Release Date: May 30th, 2015
* Enhancements
* A brand new event editor. See the [release notes](http://www.slimndap.com/theater-for-wordpress-0-11-a-new-event-editor/) for all the info.
* Support for `post__in` and `post__not_in` in the `[wpt_events]` shortcode. See the [documentation](https://github.com/slimndap/wp-theatre/wiki/Shortcodes) for examples. Thanks [jbrandligt](https://wordpress.org/support/profile/jbrandligt)!
* Support for custom filters in event listings. See [this post](http://www.slimndap.com/add-venue-and-city-filters-to-event-listings/) for an example.
== Upgrade Notice ==
= 0.15.15 =
Fixes several compatibility issues with WordPress 4.7.
= 0.15.14 =
Fixes a problem with the changelog of extensions if you're running multiple extensions.
= 0.15.13 =
Fixes a problem with the sort order of events on the admin screen.
= 0.15.12 =
Fixes a problem that was introduced in 0.15.10 where past events were not visible in the admin.
= 0.15.11 =
Small bugfixes and CSS tweaks.
= 0.15.10 =
Fixes the ordering of events on archive pages. Fixes a problem with the 'end' filter for events.
= 0.15.9 =
Fixes a problem where search results got lost when navigating on the Theater Events page in the WordPress admin.
= 0.15.8 =
Fixes in the HTML output of the Calendar widget and improves the sanitization of ticket urls.
= 0.15.7 =
Fixes two issues with displaying event dates.
= 0.15.6 =
Fixes a problem with updates for Theater for WordPress extension plugins.
= 0.15.5 =
Adds support for a 'tag' filter in event lists. Fixes a problem when bulk publishing events.
= 0.15.4 =
Small bugfixes and improvements to the events admin screen.
= 0.15.3 =
Added a new `{{prices}}` placeholder for productions.
= 0.15.2 =
Adds context information to fields in listings, useful for styling and context-aware hooks.
= 0.15.1 =
Fixes a problem with the 'date' filter in template placeholders.
= 0.15 =
This release focusses on a more streamlined experience when managing your events.
= 0.14.7 =
Adds context information to listings, useful for styling and context-aware hooks.
= 0.14.6 =
Adds two new filters to manipulate the appearance of events in lists.
= 0.14.5 =
Internal improvements that can be used by importer extensions. No real need to update if you are not importing events from an external ticketing solution.
= 0.14.4 =
The [wpt_events] shortcode now accepts a 'production' parameter to limit the a events list to one or more productions.