Title: Event Organiser
Author: Stephen Harris
Published: Onwa-isii 19, 2011
Last modified: Onwa-anö 10, 2024
---
Search plugins
This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.
# Event Organiser
By [Stephen Harris](https://profiles.wordpress.org/stephenharris/)
[Download](https://downloads.wordpress.org/plugin/event-organiser.3.12.8.zip)
* [Details](https://ibo.wordpress.org/plugins/event-organiser/#description)
* [Reviews](https://ibo.wordpress.org/plugins/event-organiser/#reviews)
* [Installation](https://ibo.wordpress.org/plugins/event-organiser/#installation)
* [Development](https://ibo.wordpress.org/plugins/event-organiser/#developers)
[Support](https://wordpress.org/support/plugin/event-organiser/)
## Description
Event Organiser adds event management that integrates well with your WordPress site.
By using WordPress’ in-built ‘custom post type’, this plug-in allows you to create
events that have the same functionality as posts, while adding further features
that allow you to manage your events. This includes the possibility of repeating
your event according to complex schedules and assign your events to venues. This
can all be done through an intuitive user interface, which allows you to view your
events in the familiar WordPress list or in a calendar page in the admin area.
[**User Docs**](http://docs.wp-event-organiser.com/)
| [**Function Reference**](http://codex.wp-event-organiser.com/)
| [**Forums**](http://wp-event-organiser.com/forums/) | [**Demo**](http://wp-event-organiser.com/demo/)
| [**Booking Add-on**](http://wp-event-organiser.com/pro-features?aid=7)
#### Available Extensions
* [Event Organiser Pro](http://wp-event-organiser.com/pro-features?aid=7)
* [Event Organiser Frontend Submissions](http://wp-event-organiser.com/extensions/event-organiser-frontend-submissions/?aid=7)
* [Discount Codes](http://wp-event-organiser.com/extensions/event-organiser-discount-codes?aid=7)
* [Stripe Gateway](http://wp-event-organiser.com/extensions/event-organiser-stripe?aid=7)
* [Posterboard](https://wordpress.org/plugins/event-organiser-posterboard) (free)
* [CSV export](https://wordpress.org/plugins/event-organiser-csv) (free)
* [iCal Sync](http://wp-event-organiser.com/extensions/event-organiser-ical-sync?aid=7)
A full list of available extensions can be found [here](http://wp-event-organiser.com/extensions/).
#### Features
#### For the user
* Create one-time events or recurring events.
* Allows complex recurring patterns for events. You can create events that last
an arbitrary time, and repeat over a specified period. Supports complex schedules
such as _On the third Tuesday of every fourth month_ or _Every month on the 16th_.
* Ability to add or remove specific dates to an event
* **Event functions** available which extend the post functions (e.g. `the_title()`,`
get_the_author()`, `the_author()`) to output or return event data (the start
date-time, the venue etc). For examples of their use see the [documentation](http://www.wp-event-organiser.com/documentation/function-reference/)
or the included template files.
* Create and maintain venues for your events, with **Google maps** support and
a fully-featured content editor.
* **Widgets**:
- Calendar widget – displays a calendar (identical to the standard WordPress
Calendar)
- Event List widget – displays a list of events, with options to specify the
number of events, restrict by categories or venues etc.
- Event Agenda widget
* Year, month and day archive pages
* **Shortcodes**:
- (full)Calendar, includes optional category & venue filters.
- (widget) Calendar
- Event List (similar to Event List widget)
- Event Agenda (similar to Event Agenda widget)
- Venue map
- Subscribe to event feeds
* **Relative date queries** (for example, query events that finished in the last
24 hours, or events starting in the coming week).
* Assign events to categories and tags, and view events by category or tag.
* Colour-coded event categories.
* **Custom permissions** allow to specifiy which roles have the ability to create,
edit and delete events or manage venues.
* Venue pages, to view events by venue.
* **Export/import** events to and from ICAL files.
* Delete individual occurrences of events.
* **Public events feed:** allow visitors to subscribe to your events, or a particular
venue / category.
* Supports ‘pretty permalinks’ for event pages, event archives, event category
and venue pages.
* (Optionally) automatically delete expired events.
#### For the developer
* Adds an **event custom post type** that fits naturally into WordPress and allows
for all the functionality of ‘posts’.
* Respects the template hierarchy. Default templates can be over-ridden by including
the appropriately named template files in your theme folder.
* Plug-in **actions and filters** are provided to modify the behaviour of the plug-
in ([hook reference](http://www.wp-event-organiser.com/documentation/function-reference/hooks)
* Extensive function API & [documentation](http://codex.wp-event-organiser.com/)
* **Javascript actions and filters** to modify interaction with the calendars and
maps
* Provide custom templates for shortcodes, widgets and ICAL export
* Custom metaboxes and meta data support for venues (see [tutorial](http://wp-event-organiser.com/documentation/developers/venue-meta-data-and-metaboxes/)).
* Minified javascript files are used, with the originals provided for ease of developing
* [Booking add-on](http://wp-event-organiser.com/pro-features) available
#### Localisation
A big thank you to those who have provided translations for Event Organiser. If
you wish to help out with translating the plug-in, you can do so [here](http://wp-event-organiser.com/i18n).
* Arabic – Layla, Mohamed Nazir
* Bulgarian – Parvan Voynov
* Catalan – jordioniric, marc.antje
* Chinese – sdsunqian
* Czech – Jan Kupsa
* Croatian – Branimir
* Danish – Intox Studio, Malthe, Morten Lyng
* Dutch – [Ingrid Ekkers](http://www.247design.nl), Roel
* English (Canada) – GhostToast
* Estonian – Kristjan Roosipuu
* Finnish – Kari Tolonen, Juhani Marttila
* French – [Remy Perona](http://remyperona.fr/), Arnaud
* German – [Martin Grether](http://www.datema.de/) & [Henning Matthaei](http://www.partnerwerk.de/)
* Greek – Vasilis, Panagiotis
* Hebrew (Israel) – heli
* Hungarian – Csaba Erdei
* Icelandic – HrHagedorn
* Indonesian – Daniel Tampubolon
* Italian – Emilio Frusciante, Pio Muto, Daniele Piccoli
* Japanese – ogawa, tkj, takeshi terai, haya.
* Latvian – Kristaps
* Lithuaniun – Stephan Siegi
* Macedonian – Aleksandar
* Norwegian – Erlend Birkedal
* Norweign (Bokmål) – DagC
* Persian (Iran, Islamic Republic of) –
* Polish – [Bartosz Arendt](http://digitalfactory.pl/)
* Portuguese (Brazil) – [Rafael Wahasugui](http://www.twitter.com/rafawhs), rafaelkvidal
* Portuguese (Portugal) – Emanuel Teixeira
* Romanian – raduanastasedev
* Russian – [Sergei](https://ibo.wordpress.org/plugins/event-organiser/www.vortexinter.ru?output_format=md)
* Slovak – ViRPo
* Slovenian – Matej
* Spanish (Spain)- Joseba Sanchez, jagarre, jelena kovacevic, courtesy of [WebHostingHub](http://www.webhostinghub.com/)
* Spanish (Peru) – Pedro Valverde
* Swedish РSofia Br̴vander, Urban Norlander
* Thai – Nibhon, Wuttichai Songprapai
* Turkish – Gökhan DAMGACI
* Ukranian – Максим Кобєлєв
## Screenshots
* [[
* Event admin screen
* [[
* Venue admin screen
* [[
* Event details metabox, showing the full reoccurrence options and venue selection
* [[
* Venue editing screen, with Google Maps
* [[
* Calendar View screen
* [[
* Calendar shortcode (using TwentyThirteen)
* [[
* Calendar shortcode when viewed on a mobile device (using TwentyFourteen)
* [[
* Events list (using TwentySixteen)
## Installation
Installation is standard and straight forward.
1. Upload `event-organiser` folder (and all it’s contents!) to the `/wp-content/plugins/`
directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Check Settings > Event Organiser
## FAQ
### How to create an event
Events behave very similarly to standard posts. To create a event, select the ‘Add
New’ submenu from ‘Events’ menu. The chief difference between events and post is
the ‘Event Details’ metabox which sets the date and venue data related to the event.
You can also add events in the Calendar view in a manner similiar to Google Calendar.
By selecting one (or multiple) days (in month mode) or times (in week/day mode)
you can create an event that spans the selected period.
### The Event Pages Don’t Look Right
Unfortunately its impossible for the default templates to work with _every_ theme.
Occasionally, they simply don’t work well with a given theme – the event content
might not appear right, or the sidebar might seem displaced. The solution is to
edit the default templates to fit in with your theme (you can use your theme’s own
templates as a guideline). [You can find more information here](http://wp-event-organiser.com/documentation/editing-the-templates/)
### How do I display events?
Events are automatically displayed on the events page: try `www.your-wordpress-site.
com/?post_type=event` (If you have permalinks enabled these will have ‘prettier’
versions). Similarly there are venue and event category pages. Each of these pages
have their own associated template which are present in the **template** sub-directory
of the Event Organiser plug-in folder. To override the default templates, simply
create the appropriately named files in your theme directory.
**Widgets**
The plug-in also provides the following widgets ([see widget documentation](http://wp-event-organiser.com/documentation/widgets/)):
* **Event list** – list events allows with options to filter by venue, categories
and dates.
* **Calendar** – display a calendar, similiar to the WordPress calendar, that displays
your events.
* **Agenda** – displays your events in a list grouped by date and navigated with
AJAX.
**Shortcodes**
Among others, the plug-in also provides the following shortcodes(
[see shortcode documentation](http://wp-event-organiser.com/documentation/shortcodes/)):
* **Event list & Widget Calendar** – shortcode versions of their widget counterparts.
* **Full calendar** – a calendar, similiar to the admin calendar, with optional
month, week and day views and category and venue filters
**Template Functions**
Finally, the plug-in provides a function `eo_get_events()`
which is similiar to WordPress’ `get_posts()`. It returns an array of post objects(
where the posts are events), and this can be used to display events through editing
your theme. The usual WordPress functions for display associated information (author,
title etc) are still available to you, and the plug-in provides a similar set of
functions to display event related data (dates, venues etc). [See the documentation for more information](http://www.wp-event-organiser.com/documentation/function-reference/).
### The full calendar doesn’t display any events
The calendar should display all published events. If you find the calendar doesn’t
appear this is usually caused by the theme you are using, and is verifiable by temporarily
switching to the TwentyEleven theme. If the theme is the cause this is normally
because:
* The theme de-registers the jQuery / jQuery UI shipped with WordPress and registers
an outdated version
* The theme does not call [`wp_footer`](https://codex.wordpress.org/Function_Reference/wp_footer)
in the footer
If the calendar _does_ appear, but gets stuck loading, the cause is usually the
AJAX response. If your site is in ‘debug’ mode – this can be due to error messages
from other plug-ins being printed. You can view the AJAX response in your browsers
console (E.g. Firefox’s firebug or Chrome’s dev tools). If you are still unable
to determine the cause of the problem, or how to fix, please use the plug-in forums
with a link to your site and I’ll take a look.
### I cannot navigate between months on the widget calendar
If clicking on the ‘next’ month causes the page to reload – the javascript has not
been loaded. This is usually because the theme does not call [`wp_footer`](https://codex.wordpress.org/Function_Reference/wp_footer)
in the footer.
If the calendar simply does not respond this is usually because your theme does
not allow widgets to add their own ID and classes. Somewhere in the theme folder
your theme will make use of `register_sidebar()` (probably in `functions.php`. It
should look something like:
```
register_sidebar(array(
'name' => __( 'Side bar name' ),
'id' => 'sidebar-id',
'description' => __( 'Widget area description' ),
'before_title' => '',
'after_title' => '
',
'before_widget' => '',
'after_widget' => '
',
));
```
Notice the `%1$s` and `%2$s` in the `before_widget` argument. These allow the widget
to add their own ID and classes to the widget. If your theme does not use `class
="widget %2$s"` (they should!) the month navigation for the widget calendar will
not work.
If you are still unable to determine the cause of the problem, or how to fix, please
use the plug-in forums with a link to your site and I’ll take a look.
### What ShortCodes are available?
Event Organiser provides the following shortcodes:
* `[eo_events]` – displays a list of events allows with options to filter by venue,
categories and dates.
* `[eo_calendar]` – displays a widget-calendar of your events, similiar to WordPress’
calendar, and navigated with AJAX.
* `[eo_fullcalendar]` – displays a calendar, similiar to the admin calendar, with
optional month, week and day views and category and venue filters.
* `[eo_venue_map]` – displays a Google map of the current venue, or of a particular
venue given as an attribute.
* `[eo_subscribe]` – wraps the content in a link which allows visitors to subscribe
to your events; there are two types: ‘Google’ and ‘Webcal’.
More information on shortcodes is [available here](http://wp-event-organiser.com/documentation/shortcodes/)
## Reviews
### [What a great plugin!](https://wordpress.org/support/topic/what-a-great-plugin-96/)
[Rovanov](https://profiles.wordpress.org/rovanov/) Onwa-anö 13, 2025
Finally one that works perfectly with OSM.Take good care of it—it’s the only one
I could find.
### [Not compatible with latest WordPress Version and PHP 8.x](https://wordpress.org/support/topic/not-compatible-with-latest-wordpress-version-and-php-8-x/)
[Patrick](https://profiles.wordpress.org/uentooser/) Onwa-iri 23, 2024
Not compatible with latest Wordpress Version and PHP 8.x. After installation the
plugin Icon was not shown.
### [does not work properly](https://wordpress.org/support/topic/does-not-work-properly-36/)
[guido030](https://profiles.wordpress.org/guido030/) Onwa-itolu 9, 2024 1 reply
I am going to delete this plug in. You cannot change dates. You cannot change times.
You cannot copy events. You cannot exclude dates within repeating events. This plug
in is full of bugs.
### [Good plugin](https://wordpress.org/support/topic/good-plugin-5718/)
[pgierak](https://profiles.wordpress.org/petergierakgmxde/) Onwa-asatö 3, 2022
Good plugin works as it should work
### [Problems with php 8](https://wordpress.org/support/topic/i-use-it-to-plan-my-trips-super-plugin/)
[rolandkb](https://profiles.wordpress.org/rolandkb/) Onwa-asaa 15, 2022
Does not work with php 8.
### [So far, so good](https://wordpress.org/support/topic/so-far-so-good-1019/)
[](https://profiles.wordpress.org/ccrussell/) Onwa-isii 22, 2021
I need just a basic calendar, so I can add events (color coded by category) that
people can just see. Very simple needs. This product does that for free. Easy to
set up, so far it has been working just fine. It let me import my events from an
ICS file, which was helpful, as that is how I was able to get my data from the plugin
that I was using, which used to be free but now charges a fee. Only hassle was that
all events came in as drafts, so I had to republish them. Not a big deal, other
than that I had a LOT of events
[ Read all 139 reviews ](https://wordpress.org/support/plugin/event-organiser/reviews/)
## Contributors & Developers
“Event Organiser” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Stephen Harris ](https://profiles.wordpress.org/stephenharris/)
“Event Organiser” has been translated into 18 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/event-organiser/contributors)
for their contributions.
[Translate “Event Organiser” into your language.](https://translate.wordpress.org/projects/wp-plugins/event-organiser)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/event-organiser/),
check out the [SVN repository](https://plugins.svn.wordpress.org/event-organiser/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/event-organiser/)
by [RSS](https://plugins.trac.wordpress.org/log/event-organiser/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
= 3.12.8 – 26th August 2024
* Bugfix: Fixes interoperability with Real Consent
banner * Bugfix: Fixes PHP 8 warning messages
= 3.12.7 – 26th August 2024
* Security patch: Bump version of moment.js
= 3.12.6 – 14th July 2024
* Fixed PHP 8.1 deprecation notices
= 3.12.5 – 24th February 2024
* Security patch: Disables cache of public calendars(
can be re-enabled with the following code)
```
`
add_filter('eventorganiser_cache_expiration_eo_widget_calendar', function(){
return DAY_IN_SECONDS;
});
add_filter('eventorganiser_cache_expiration_eo_widget_agenda', function(){
return DAY_IN_SECONDS;
});
add_filter('eventorganiser_cache_expiration_eo_full_calendar_public', function(){
return DAY_IN_SECONDS;
});
`
```
#### 3.12.4 – 2nd October 2023
* fix: php 8.2 warnings
#### 3.12.3 – 11th March 2023
* fix: integer overflow bug with theme compatbility template handling
#### 3.12.2 – 15th November 2022
* fix: bug with admin calendar not rendering correctly in WordPress 6.1
#### 3.12.1 – 28th September 2022
* fix: static method called dynamically
#### 3.12.0 – 30th March 2022
* feat: Add %event_organiser_url% placeholder for event list shortcode (url of
the event’s organiser)
#### 3.11.1 – 30th March 2022
* bugfix: Fix “InvalidValueError: setIcon: not a string…” error with Google Maps
#### 3.11.0 – 10th March 2022
* bugfix: Add support for PHP 8+
#### 3.10.8 – 13th October 2021
* bugfix: Close open tooltip windows when opening tooltip..
#### 3.10.7 – 11th June 2021
* bugfix: Fixed bug with license keys not saving on multisite installations.
#### 3.10.6 – 17th May 2021
* bugfix: Fix bug with Open Street Map & selecting ‘no venue’
#### 3.10.5 – 7th March 2021
* bugfix: Replace deprecated jQuery methods
#### 3.10.4 – 19th January 2021
* bugfix: Fixed week/day calendar views broken in WP 5.6
* bugfix: Fixed some jquery-migrate deprecation notices
#### 3.10.3 – 15th January 2021
* bugfix: Fixed jQuery errors with WordPress 5.6
* bugfix: Fixed styling regressions
#### 3.10.2 – 13th September 2020
* bugfix: Fixed all-day toggle not working with WordPress 5.5
#### 3.10.1 – 14th August 2020
* bugfix: Fixed iCal feeds being treated as comment feeds
#### 3.10.0 – 22nd July 2020
* feature: Extended support for RECURRENCE-ID in iCal calendards
* bugfix: Ensure translated screen help text is escaped
* bugfix: Replace instances of curly braces for array access (deprecated PHP 7).
#### 3.9.1 – 28th May 2020
* bugfix: Fixed bug where venue can’t be changed if maps are disabled
* feature: Added additonal methods to the maps adapter API
#### 3.9.0 – 8th January 2020
* feature: Added option to disable venue maps
* bugfix: Ensure latitude/longtitude co-ordinates are cast as floats
#### 3.8.6 – 18th November 2019
* bugfix: Removed call to is_feed(), uses $query->is_feed() instead. Fixes potential
warning logged
#### 3.8.5 – 7th November 2019
* bugfix: Fixed missing Leaflet files for openstreetmap
#### 3.8.4 – 5th November 2019
* bugfix: Fixed inline editing event looses venue selection
#### 3.8.3 – 31st August 2019
* bugfix: Fixed ‘Feed not found’ when importing a feed with a Byte Order Mark.
#### 3.8.2 – 6th August 2019
* bugfix: Restored PHP 5.2 compatability
#### 3.8.1 – 26th July 2019
* Bumped tested up-to version
* bugfix: Fixed bug where leaflet map appeared above datepicker in the event edit
screen
#### 3.8.0 – 15th July 2019
* feature: Added `eventorganiser_ical_location` filter
* feature: Added `eventorganiser_ical_summary` filter
* bugfix: Fixed max zoom for leaflet
* bugfix: Fixed recurrence notice being removed by ‘hide admin notices’ plugin
* bugfix: Fixed bug where `[eo_fullcalendar]` shortcode would not display terms
in the dropdown filter if they were surrounded by space, e.g. `[eo_fullcalendar
event_category="foo, bar"]`
#### 3.7.6 – 6th March 2019
* bugfix: Fixed missing translations
* bugfix: Fix tags and categories not appearing in Gutenberg
#### 3.7.5 – 1st March 2019
* feature: Added eventorganiser_pre_insert_venue filter
* bugfix: Use case-sensitive constants for PHP 7.3 [#454](https://github.com/stephenharris/Event-Organiser/issues/454)
* bugfix: Fix issue if event categories are invalid [#455](https://github.com/stephenharris/Event-Organiser/issues/455)
* bugfix: Fix user_events option for calendar not working
* bugfix: Ensure table names are reigstered before removing tables. Fixes [#444](https://github.com/stephenharris/Event-Organiser/issues/444)
* bugfix: Fix warning for PHP 7+ where string is passed, not integer
* bugfix: Fix typo
#### 3.7.4 – 26th August 2018
* bugfix: Fix bug with venue map shortcode when used without attributes
#### 3.7.3 – 13th July 2018
* bugfix: Fix Google Maps API key notice appearing when Open Street Maps is selected
* bugfix: Corrected spelling error in venue arguments (“longtitude” corrected to“
longitude”)
#### 3.7.2 – 8th June 2018
* bugfix: Fixed maps bug which affected users with Yoast’s SEO Plugin installed
* bugfix: Replaced data-vocabulary.org with schema.org
* bugfix: Fixed higher-priority template being overridden by lower priority template
in
eo_locate_template() when multiple template names are given. See [#434](https://github.com/stephenharris/Event-Organiser/issues/434)
#### 3.7.1 – 31st May 2018
* bugfix: fixed admin calendar modal appearing behind overlay
* bugfix: fixed venues with apostrophes not appearing in the venue search/autocomplete.
#### 3.7.0 – 25th May 2018
* Added support for OpenStreetMap. New installations default to OpenStreetMap.
#### 3.6.5 3rd April 2018
* bugfix: Only use date ordinal suffix (st,nd,rd,th) if the site’s date format
setting includes it
= 3.6.4 26th March 2018
* bugfix: Addressed issue where grouping occurrences might error depending on MySQL
configuration. Fixes [#432](https://github.com/stephenharris/Event-Organiser/issues/432)
= 3.6.3 6th March 2018
* bugfix: Fixed bug with grouping occurrences, effecting some MySQL versions. Fixes
[#430](https://github.com/stephenharris/Event-Organiser/issues/430)
= 3.6.2 5th January 2018
* bugfix: Fixed reference error in calendar shortcode introduced in 3.6.1
= 3.6.1 4th January 2018
* bugfix: Bug where static value is used for calendar breakpoint on initial load
* bugfix: Ensure venue tooltip is moved to fit within viewport
* bugfix: Bug where clicking on the venue tooltip could cause the map to overflow
the container
= 3.6.0 25th November 2017
* added: Ability to specify multiple event authors (organiser) in the fullcalendar
author/author_name attribute
by using a comma seperate lised e.g: [eo_fullcalendar
author=”1,2″]
* bugfix: The “organiser” full calendar filter only displays users included in
the author/author_name attribute
if supplied.
* bugfix: Occurrences which have changed time still appear in the include/excludes
datepicker
* bugfix: iCal feed will display correct DSTART & DTEND values even when the initial
occurrence is excluded from
the query driving the feed.
* changed: The admin calendar week/day views display 15-minute intervals. If dragging
of occurrences is enabled
this can be done in 5 minute intervals.
= 3.5.1 14th November 2017
* Fix bug where multiple filters are used in fullcalendar shortcode, seperated
by a comma
= 3.5.0 8th November 2017
* Added ‘organiser’ option to calendar shortcode’s headerLeft/headerCenter/headerRight
attributes – allows
filting of the event calendar by event organiser (author).
* Improved effeciency of calendar page load time by lazy loading required data
* Updated French and Dutch translations
* Tested up to 4.9.0-beta-4
= 3.4.1 18th October 2017
* Tested up to 4.9.0-beta-2
* Fixed a bug with the calculation of long occurrences
* Updated Czech translation
= 3.4.0 25th September 2017
* Tested up to 4.8.2
* added: `weeknumbers` attribute for the calendar shortcode: `[eo_fullcalendar
weeknumbers=true]`
= 3.3.0 12th September 2017
* added: `%event_range{date-format}{time-format}%` placeholder for the event list
shortcode / widget
* added: `%event_organiser%` placeholder for the event list shortcode / widget
* added: `eventorganiser_google_maps_url` hook
* updated: Spanish, Finish and Italian translations
* bugfix: private events authored by the current user are now visible in the admin
calendar
* bugfix: Fix casing in ‘All events’
* bugfix: Fix bug in event list widget settings: `group_occurrences` checkbox is
not checked, even when enabled.
= 3.2.0 23rd August 2017
* Updated ‘Tested up to’ version (WordPress 4.8.1) * Update
Czech, Indonesian, French, Japanese, Dutch, Portuguese, Norwegian, Slovenian and
Swedish. * Default event page names are now filterable via `eventorganiser_event_properties`.*
Remove X-WR-CALNAME from iCal feed for single event feeds. See [#413](https://github.com/stephenharris/Event-Organiser/issues/413).*
Fixes errors if event-category tax is disabled. See [#414](https://github.com/stephenharris/Event-Organiser/issues/414)*
Fixes mark-up error in calendar widget: tbody must occur before tfoot
= 3.1.10 – 8th July 2017
* Updated ‘Tested up to’ version (WordPress 4.8) * Updated
Afrikaan, Catalan, Croatian, Czech, Dutch, French, German, Greek, Hungarian, Portuguese,
Russian, Slovenian, Spanish and Turkish translations.
= 3.1.9 – 31st March 2017
* Removed development tool * Updated French, Italian
and Japanese translations
= 3.1.8 – 30th March 2017
* Handle 767 byte index size limit in MySQL. See [#404](https://github.com/stephenharris/Event-Organiser/issues/404)
* Fix handling of ampersands in the iCal feed
= 3.1.7 – 23rd December 2016
* bugfix: Remove icon was not visible when editing
galleries on the event admin page
= 3.1.6 – 11th November 2016
* Fix bug causing edit event admin page to link to
the settings page. * Fix bug in `eo_get_current_occurrence_of()` * Ensure `occurrence_id`
value returned by `eo_get_next_occurrence_of()` is an integer not a string.
#### 3.1.5 – 2nd November 2016
* bugfix: Fixed conflict, affecting widget the calendar, with some tranlsation
plugins. This resulted in not being able to naviage through the calendar.
* bugfix: Fixed inline documentation
* bugfix: Fixed `
` tag being used as a closing tag
#### 3.1.4 – 9th September 2016
* Tested up to 4.6.1
* bugfix: In the iCal field don’t change the BYDAY property when a city is used
as a timezone (i.e. instead of a UTC offset). Fixes [#376](https://github.com/stephenharris/Event-Organiser/issues/376)
#### 3.1.3 – 23rd July 2016
* bugfix: Fixed tranlsation (.mo files)
* bugfix: Fixed image files
* enhancement: Updated translations
#### 3.1.2 – 20th July 2016
* enhancement: Uses `eo_get_permalink()` rather than `get_permalink()“ in default
templates.
* bugfix: Fixes private events not displayed in the calendar widget for those who
can view private events
* bugfix: Fixes warnings in calendar widget settings
* bugfix: Fixes invalid HTML mark-up in widget settings. Ref #370
* bugfix: Fixes an edge case bug where the iCal feed errored
* bugfix: Fixes a typo in google maps help text
#### 3.1.1 – 8th July 2016
* bugfix: Allows Google Maps API to be used via a setting or constant. Please see
http://wp-event-organiser.com/blog/announcements/google-maps-now-requires-api-
key/ for details [#365](https://github.com/stephenharris/Event-Organiser/pull/365)
* bugfix: Fixes bug where deleting all the occurrences of an event via the admin
calendar does not properly delete the event. [#367](https://github.com/stephenharris/Event-Organiser/pull/367)
* bugfix: Sanitize hex codes for event category colours.
* bugfix: Fixed bug where the subscribe to calendar (in Google) shortcode did not
work on sites using SSL certificates. [#328](https://github.com/stephenharris/Event-Organiser/issues/328)
* enhancement: Refactor event render filter for the calendar so that it always
fires [#366](https://github.com/stephenharris/Event-Organiser/pull/366)
* bugfix: Fixes a bug where events without any dates did not appear in the Events
admin. [#367](https://github.com/stephenharris/Event-Organiser/pull/367)
#### 3.1.0 – 23rd May 2016
* enhancement: Improved performance when grouping by event series
* enhancement: Added `event_series` attribute for calendar shortcode. Display only
occurrences in Event with ID5: `[eo_fullcalendar event_series="5"]`
* enhancement: Add event-category / event-url query parameters to the URLs on the
calendar widgt if filtering by category / venue.
* enhancement: iCal feeds now include the featured image
* enhancement: Added `eventorganiser_indefinitely_recurring_event_last_date` filter
to change ‘recur until date’ for indefinitely recurring events imported from
an iCal feed.
* enhancement: Added `eventorganiser_metabox_after_core_fields` action after core
fields in Event metabox
* enhancement: Add setting to configure calendar shortcode’s mobile breakpoint
* enhancement: Calling `eo_format_datetime()` with a non DateTime object throws
an exception
* bugfix: Fix a bug with formatting date-range when two tokens look the same (e.
g. day of the week) bug refer to different dates. (See [#359](https://github.com/stephenharris/Event-Organiser/pull/359))
* bugfix: Improved a11y of venue address metabox
* bugfix: Improve a11y of notices and remove title attribute #323
* bugfix: Removed unnecessary title attributes, and ‘bookmark’ link from templates
and elsewhere
* bugfix: Fixed bug were uppercase meridian was being removed for languages which
don’t have a translation (should instead retain the English default, as is the
case with lowercase meridian). Adds tests
* bugfix: Double quotes now stripped from the ORGANISER CN parameter in iCal feeds
* bugfix: Remove date from venue page title when viewing events in a venue in given
year/month or on a given date
* bugfix: Fixed notice markup containing incorrect closing anchor tag
#### 3.0.5 – 31st March 2016
* bugfix: Compatible with WordPress 4.5
* bugfix: Fixed bug which occurs in firefox when using a single digit for the date/
month attribute of the calendar shortcode
* bugfix: Used alternative ‘Mustache’ style syntax for the agenda widget to prevent
conflicts with servers with ASP tags enabled.
* bugfix: Used get_the_title rather than post_title property in the calendar widget
* bugfix: Disabled plug-in’s front-end css if theme support is enabled.
* bugfix: Fixed error in the agenda widget if there are no events to display
* bugfix: Fixed ‘undefined variable’ warning in eo_get_permalink
#### 3.0.4 – 3rd March 2016
* bugfix: Fixed venue and organiser filters were not being applied for calendar
shortcode
* bugfix: Fixed 404 errors with category/venue dropdown widget
#### 3.0.3 – 24th Feburary 2016
* enhancement: Removed the year from the list view
* bugfix: Fixed ordering of terms in the Events admin page filters
* bugfix: Restore backwards compatability for custom templates using the ‘upcoming
dates’ list show more/less feature
* bugfix: Fixed venue dropdown not filtering the (frontend)calendar
* bugfix: Fixed incorrect class name in the ‘upcoming dates’ list show more/less
links
* bugfix: Fixed timezone warning not dismissable.
* bugfix: Fixed typo in stylesheet
#### 3.0.2 – 12th Feburary 2016
* enhancement: Clicking the down array in the venue selection field shows all venues.
Limit of suggested venues while searching venues in search suggestion increased
to 10.
* enhancement: Updated Dutch translation
* bugfix: Fixed and issue with some date formats (such as ‘T’, ‘Z’) not rendering
correctly on the calendar. Not all formats are supported.
* bugfix: Ensured the agenda widget does display bullet points. This fixes compatability
issues with some themes.
* bugfix: Fixed warning when quick editing an event
* bugfix: Restored missing template field in the event list widget
* bugfix: Fixed basic week/day buttons not hidden when in responsive list view.
* bugfix: Fixed calendar not highlighting the current day.
#### 3.0.1 – 4th February 2016
* bugfix: Fixed incorrect ‘No Venue’ label in venue selection when editing an event
* bugfix: Update languages
* bugfix: Addressed some text inconsistancies and typos (See [#329](https://github.com/stephenharris/Event-Organiser/pull/329),
[#330](https://github.com/stephenharris/Event-Organiser/pull/330), [#331](https://github.com/stephenharris/Event-Organiser/pull/331),
[#333](https://github.com/stephenharris/Event-Organiser/pull/333))
* bugfix: Fixed bug with agenda widget not translating dates.
* bugfix: Removed inline styles from the front-end and moved to stylesheet.
* bugfix: Fixed bug where agenda widget was not linking to event (when ‘add to
Google’ is disabled)
* bugfix: Agenda widget now opens on todays date if it has an event
* bugfix: Fixed subscribe shortcode when specfying a particular category/venue.
#### 3.0.0 – 29th January 2016
**Event Organiser now requires WordPress 3.8.0+ or better**
fullCalendar
* feature: fullCalendar is now responsive, and collapses to a list on mobile view.
This can be disabled with `[eo_fullcalendar responsive=0]`
* feature: Adds `nextDayThreshold` option. A multi-day event must finish after
this time for it appear on that day on the calendar. Default ’06:00:00′ (6am)
* feature: You can enable a more compact calendar view, where an event will occupy
only one line in the calendar and long event titles are truncated. This can be
enabled as follows: `[eo_fullcalendar compact=true]`
* feature: Improved, and minimalist styling for the calendar, which makes it easier
for themes to set the calendar styling.
* feature: fullCalendar key attribute can now take the value ‘top’ or ‘bottom’,
e.g. `[eo_fullcalendar key="bottom"]` to configure the location of the category
colour key.
* feature: Adds `aspectratio` attribute to configure the aspect ratio (height/width)
of the fullCalendar. Defaults to auto resizing.
* feature: You can now specify which days appear on fullCalendar shortcode (day&
week views): `[eo_fullcalendar showDays="MO,WE,TH,SU"]`
* feature: The fullCalendar library has been upgraded to v2.2.7
* feature: Adds `slotDuration` option, to specify the duration of time slots in
the agenda views, default ’00:30:00′ (30 minutes)
* feature: date/time ranges in calendar titles/axis are now done automatically.
* change: Use `defaultdate` attribute (yyyy-mm-dd) instead of year/month/date attributes
to specify an opening date for the calendar
* bugfix: Event categories in the calendar filter now appear in alphabetical order
API
* change: Removed support for deprecated API (Deprecated in 1.5.6, Sep 2012).
* change: `eo_event_venue_dropdown()` is deprecated (though still useable). It
is recommended that you use use `eo_taxonomy_dropdown()` instead
* feature: Introduced `eo_format_event_occurrence()`: which will format the date(
time) (range, where appropriate) of the event occurrence. E.g. a one day event
may appear as 28th November 2pm-3pm, and a two-day all-day event may appear as
28-29th November. The resulting date depends on the date/time format options,
and whether the event is multi-day and whether is all-day.
Google map
* Added js-hook `eventorganiser.google_map_loaded`
* Venue map function and shortcode now support `minzoom` and `maxzoom` properties
Theme compatability
* feature: A ‘theme compatability’ mode has been introduced to improve compatability
with themes. This can be enabled in Settings > Event Organiser > General
Templates
* feature: Added `eo_format_event_occurrence()`, `eo_format_datetime_range()` functions
to help format event dates and ranges
* feature: dateformats in event templates now use the date format settings
* feature: Added `eventorganiser_stylesheet_src` and `eventorganiser_stylesheet_src_{
handle}` filters to filter plug-in stylesheets locations. This allows for themes
to map plug-in stylesheets to their own stylesheets.
* feature: Added `eo_enqueue_style()` function, which filters the handle of front-
facing CSS files with `eventorganiser_stylesheet_handle_{handle}`. This allows
themes/plugins to map a CSS file to a different one.
* change: Removed generic `entry-meta` class from `event-meta-event-single.php`
template as this was causing theme compatability issues
* change: Events pages (events, venue, category tag pages) now display the event’s
start and end time as a range, e.g. 20th January 2016, 8pm-9pm
* change: Single event page, upcoming dates template can now be used on templates
with multiple events
* change: HTML classes added for the upcoming dates on the single event page for
themes
iCal feed
* feature: The iCal importer is more forgiving when importing incorrectly formatted
iCal feeds
* feature: When importing a feed, the DURATION attribute is now supported
* bugfix: Fixes bug with way events without a DTEND specified were interpretted.
* bugfix: Event dates are not converted to Site’s timezone defined in VTIMEZONE(
if php 5.3+)
Widget
* change: Agenda widget ‘day’ mode it behaves like week/month mode and displays
only one day at a time
* feature: Event list widget now allows you to list events in certain scopes (e.
g. past events, future events, running events, events on today). Custom ‘scopes’
can be registered with the `eventorganiser_query_scope` filter.
General
* feature: improved performance, particularly for sites with long recurring events
or large number of venues
* feature: Added `eventorganiser_timezone` to filter the timezone
* feature: improved support for UTC-offset timezones, but it is **strongly** recommended
you chose a city
* bufix: Fixes bug where quick editing will cause event start and end cells to
disappear
Accessibility
This is an ongoing process, and any bug reports, feature suggestions
and pull requests are welcome in this respect.
* feature: Added a Keyboard shortcuts modal (shift + ?) added (admin calendar page)
* bugfix: Edit event metabox no longer uses a tabular mark-up. Missing label/description
mark-up is added, as well as other minor improvements to the markup.
* bugfix: The timepicker is now keyboard accessible
* bugfix: Focus state is now clearer on the date & time pickers
* bugfix: Modals on the admin calendar page are keyboard friendly
* bugfix: Mark-up for the admin calendar tabs have been improved
* bugfix: Screen reader text added to events in the fullcalendar and calendar header
made an aria-live region
* bugfix: Improved keyboard accessibility of venue selection on the edit event
and calendar screen
#### 2.13.7 – 9th December 2015
* Fixes a bug with the event list widgets on WordPress 4.4
* Ensures categories in the category fullCalendar shortcode are listed alphabetically
* Replaces deprecated `.below-h2` with `.inline` notice classes
* Updated translations and Lithuaniun
#### 2.13.6 – 9th August 2015
* Fixes incompatability with WordPress 4.3 on venue admin screen
#### 2.13.5 – 25th July 2015
* Register database tables early
* Fix bug where ‘schedule_last’ is used instead of ‘until’ in parsing iCal feed.
#### 2.13.4 – 13th June 2015
* Correct escaped characters in time format not being displayed as literal text.
Fixes [#273](https://github.com/stephenharris/Event-Organiser/issues/273).
#### 2.13.3 – 2nd June 2015
* Fixed incomptability with WordPress 3.4. **Please note that from Event Organiser
3.0.0 onwards, the minimum requirement is being increased to WordPress 3.8**
#### 2.13.2 – 23rd May 2015
* Fixed a bug with the drop-down venue/category filters on the events admin screen
with WordPress 4.2.
* Fixed issue with google map when selecting a venue on the event admin screen.
Props to @r-a-y.
* The times of newly created events are now rounded (forward) to the half hour.
Props to @r-a-y.
* Reoccurence label is changed from ‘once’ to ‘none’. Props to @r-a-y.
* Updated translations.
#### 2.13.1 – 7th May 2015
* Fixes bug where use of `%event_duration%` tag modifies end date
* Fixes bug where `schedule_last` is set to ‘false’. (Fixes conflict with FES)
#### 2.13.0 – 1st May 2015
* Added `eo_get_the_occurrence_id()` for use ‘inside the Loop’
* Added `eo_get_permalink()` for use by themes/extensions
* Added filter event calendar query: `eventorganiser_fullcalendar_query`
* Added `eventorganiser_additional_event_meta` action
* Added `eventorganiser_updated_event` hook
* `schedule_last` argument for `eo_insert_event()` and `eo_update_event()` deprecated
in favour of `until`. (`schedule_last` is still
supported)
* Fixed bug where including/excluding dates may change ‘until’ recurrence date.
* Fixed bug with importing included/excluded dates in ‘foreign’ timezone to site
timezone
* Bump fullCalendar CSS to 1.6.4 inline with fullcalendar.js. Fixes issue with
event overlap in week view
* Fix bug in iCal parsing with feeds containing weekly events without a byday component
to the RRule
#### 2.12.5 – 21st April 2015
* Fixes XSS vulnerability
* Fixes a bug with editing an event date/time after including additional dates.
* Fixes warnings produced by `eo_break_occurrence()`
#### 2.12.4 – 19th March 2015
* Fixes bug with incorrect “Invalid datetime” errors when parsing iCal exdate or
rdate dates
* Decode HTML entities for X-ALT-DESC
#### 2.12.3 – 13th March 2015
* Fixes bug with iCal parser not correctly handling excluded date-times (bug introduced
2.12.0)
* Fixes bug with validating iCal date (as opposed to date-time).
#### 2.12.2 – 10th March 2015
* Fixes conflict with ACF on event admin pages
* Fixes fatal error on events pages when displaying event tag (bug introduced 2.12.1).
* Fixes `eo_get_event_meta_list()` for use outside the loop.
* Uses taxonomy labels array for category drop-dropdown labels.
* Updates Romanian & Slovak translations.
#### 2.12.1 – 2nd March 2015
* Fix bug which disabled adding events via the admin calendar
* Fixed typo with enabling beta feature of changing an occurrence’s time via the
admin calendar
* Added php 5.2 to Travis CI tests
#### 2.12.0 – 20th February 2015
_You are strongly recommended to update to 2.12.0 before updating to **WordPress
4.2** (to be released).
Please see this [post](http://wp-event-organiser.com/blog/announcements/event-organiser-wordpress-4-2)
* Includes fix for WordPress 4.2 “term splitting”.
* Removes obsolete event update checks. Fixes [#241](https://github.com/stephenharris/Event-Organiser/issues/241).
* Adds support for “author” and “author_name” attributes for fullCalendar to display
a user’s events.
* Adds support for “event_tag” attribute for fullCalendar to display a events with
particular tag(s).
* Fixes bug with iCal feed not converting HTML entities for summary/description.
* Improve resonsiveness of venue admin page. Fixes [#236](https://github.com/stephenharris/Event-Organiser/issues/236).
* Fixes bug with event ID not always set for eventorganiser_get_the_start/end filters.
* Remove tabindex attribute from venue admin page.
* Replaces `get_the_permalink()` with `get_permalink()` in iCal feed.
* Adds fix for themes adding CSS transition to fullCalendar.
* Ensures dates are populated when duplicating events with Duplicate Post plug-
in. Fixes [#242](https://github.com/stephenharris/Event-Organiser/issues/242).
* Fixes bug with long list of (unscrollable) venues overflowing modal on admin
calendar page.
* Allows post_date and post_date_gmt keys in eo_update/insert_event.
#### 2.11.1 – 28th January 2015
* Fixes UI issue with adding/removing occurences
* Improves highlight of “active” components
* Sets max-width of venue/category drop-downs so long venue/category names don’t
break the admin calendar layout
#### 2.11.0 – 24th January 2015
* Update jQuery UI stylesheet
* Removed support for old classic (blue) WordPress admin
* Adds a fix for fullcalendar with themes setting max-width of links
* Add ‘sanity check’ for datetime instances in event class function
* Add comment_status & context to eo_insert_event / eo_update_event post data
* Updated Spanish, French, Latvian, Swedish & Turkish translations.
* Added Macedonian translation.
#### 2.10.0 – 22nd December 2014
* Tested against WordPress 4.1
* Allow google map styles to be set via API
* Added `eventorganiser_venue_map_options` filter
* Support RTL languages (added stylesheet)
* Added `eventorganiser_ical_property_{property_lowercased}` action
* Added `eventorganiser_pre_ical_property_{property_lowercased}` filter
* Added venue admin page hook for `