Event Organiser vs OpenAgenda

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 | Function Reference | Forums | Demo | Booking Add-on Available Extensions Event Organiser Pro Event Organiser Frontend Submissions Discount Codes Stripe Gateway Posterboard (free) CSV export (free) iCal Sync A full list of available extensions can be found here. 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 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 Extensive function API & documentation 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). Minified javascript files are used, with the originals provided for ease of developing Booking add-on 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. 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, Roel English (Canada) – GhostToast Estonian – Kristjan Roosipuu Finnish – Kari Tolonen, Juhani Marttila French – Remy Perona, Arnaud German – Martin Grether & Henning Matthaei 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 Portuguese (Brazil) – Rafael Wahasugui, rafaelkvidal Portuguese (Portugal) – Emanuel Teixeira Romanian – raduanastasedev Russian – Sergei Slovak – ViRPo Slovenian – Matej Spanish (Spain)- Joseba Sanchez, jagarre, jelena kovacevic, courtesy of WebHostingHub Spanish (Peru) – Pedro Valverde Swedish – Sofia BrÃ¥vander, Urban Norlander Thai – Nibhon, Wuttichai Songprapai Turkish – Gökhan DAMGACI Ukranian – Максим Кобєлєв

Display calendars from https://openagenda.com on your site. Basic usage This WordPress plugin allows you to embed any calendar hosted on https://openagenda.com on your WordPress site. Upon activation, the plugin creates a new post type named Calendars. Just create a new calendar, provide the UID of the calendar you wish to display in the calendar settings box, and that’s it ! You can leave the content area for this calendar empty, as it will be populated automatically with your events ! Your events are automatically inserted after your content. If you wish to control where your events will be listed, just use the shortcode [openagenda] in your content. Settings General settings can be found under the Calendar > Settings entry in the admin menu. All data related to your API key or calendars can be found on https://openagenda.com. The settings are divided into two tabs: General and Integrations. General settings The General settings page provides the following settings : OpenAgenda API key : Your user API key. Providing your account API key is required for the plugin to work properly. It can be found in your account on https://openagenda.com Allow for embedded content : If your events contain embedded content, tick this box to allow the corresponding HTML tags. Load default stylesheets : The plugin provides very basic styling and depends heavily on your theme’s styles. Disable this to rely 100% on your theme styles. Legacy templates : Templates have been updated in 3.0.0. Check this option to continue using legacy templates. Cache duration : For performance reasons, basic requests to OpenAgenda are temporarily kept in cache. This settings controls the time to keep them cached, in seconds. Default event image : Choose an image to use in case events do not have one. Delete all calendar content on uninstall ? : controls whether you want to delete all your calendars on uninstall. Delete all options on uninstall ? : controls whether you want to delete all your calendar settings on uninstall. Allow OpenAgenda to collect usage stats ? : controls whether you want to send CMS used and site URL to OpenAgenda, for statistic purposes. Integrations settings The Integrations tab allows you to fine tune settings for various third party services the plugin uses. OpenStreetmap integration settings : Default map tiles link : This is the map tile used for the various maps displayed by the plugin. Default map tiles attribution link : this is the default attribution link placed on OpenStreetMaps. CloudImage integration settings : CloudImage API key : If you wish to use CloudImage to serve your images, enter your API key here. Permalinks settings In the Permalinks settings, you can change the prefix for your calendar pages. You cannot leave this blank as your URLs will conflict with WordPress’ default pages and posts. In the Settings > Reading section, you can set a calendar page as your front page. Note that it will still use the default calendar template provided by the plugin and the default front page template provided by your theme. Customizer settings In the Customizer, a new panel is available to house various display settings. For now only a main color setting is available. If you add Openagenda Filter widgets via the customizer, the preview will not display them immediately. That’s simply because filters are initialized on page load and the customizer preview is not always fully refreshed when a setting is changed. Simply publish your settings and refresh the page, or open your agenda page in another tab. Your filter should work just fine. Filter widget and shortcodes To allow users to easily find relevant events, the plugin also provides a convenient filter widget. Place the widget in your sidebar or other widgetized area, pick a filter and tweak any additional settings in the widgets admin. To integrate filters directly in your content instead of widget areas, the plugin also provide shortcodes. Every shortcode listed here (except for [openagenda]) corresponds to a filter option in the widget. Additionaly, shortcodes and widget filters have the same parameters, and every shortcode attribute corresponds to a widget filter setting. [openagenda] Displays the calendar. You do not need to use this shortcode explicitely, as it is automatically injected in the content of your “calendars” posts. However, if you need to insert static content after your list of events, you can do so by inserting this shortcode, then your static content afterwards. [openagenda_filter_active] Displays the active filters. It takes no parameters. [openagenda_filter_choice] Displays a list of choices, depending on the field chosen. It takes the following parameters : field: the slug of the choice field you want to display (e.g. “cities”, “keywords”, “departments”, “favorites”, etc… ). additional_field: Any custom field you have setup in your OpenAgenda administration. Only works when ‘Additional Field’ is the chosen field. page_size: Number of options to display before the ‘More options’ button. You can find the list of available additional fields in the Forms section of your agenda settings on openagenda.com (ex: https://openagenda.com/[your-agenda]/admin/schema) [openagenda_filter_calendar] Displays a calendar. It takes no parameters. [openagenda_filter_map] Displays an interactive map to locate and search events. It takes the following parameters : map_tiles_link : Map tiles link to use. Defaults to https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png map_auto : Whether to automatically update map on scroll. [openagenda_preview] Displays a preview of any calendar. It takes the following parameters : uid : UID of the calendar you wish to preview. size : Number of events to display. sort : Event sort option. Accepts lastTimingWithFeatured.asc, timingsWithFeatured.asc, lastTiming.asc, timings.asc, updatedAt.asc or updatedAt.desc. filters : Query string representing filters to apply to the request. To ensure it works properly and avoid breaking the shortcode, you should urlencode the query string. You can do so via a simple tool like https://www.urlencoder.org/fr/ links : Accepts oa or an empty string. If set to oa, event links will point to events pages on https//openagenda.com instead of local pages. [openagenda_filter_relative] Allows to filters past or upcoming events. It takes no parameters. [openagenda_filter_search] Displays a search field. It takes the following parameters : placeholder : text field placeholder. Customization Templates for the list of events and individual events can be customized in your child theme. If you’re not already using a child theme, it is recommended to create one. https://developer.wordpress.org/themes/advanced-topics/child-themes/ Just create a folder named openagenda/ in your child theme, then copy and paste the template you wish to override from the plugin’s templates/ folder. Here is a list of templates you can find in the plugin’s templates/ folder : event-loop.php : main wrapper for list view and single event view. Displays exports button and pagination at the top and bottom. list-header.php : contains the total number of events and active filters display. event.php : template used to display the event information on list views. single-event.php : template used to display the event information on single event views. event-location.php : template used to display the location information on single event views. event-additional-fields.php : template used to the list of additional fields on single event views. preview-loop.php : main wrapper for the preview widget and shortcode. The legacy/ folder contains templates used prior to version 3.0.0. If you updated the plugin and notice issues on your frontend, that’s probably because your site used legacy templates. Please try and check the Use legacy templates checkbox in the settings page. The plugin provide convenient template tags for you to display event data in the inc/template-tags.php file. Feel free to define your own in your theme. The plugin also provides many hooks to allow you to customize the html output or other various data. Usage of third party services and copyright information This plugin displays data hosted and provided by https://openagenda.com. By using this plugin, you accept and agree with OpenAgenda’s terms and conditions and privacy policy. Please make sure to read them before using this plugin. Also, using this plugin DOES require an account at https://openagenda.com, and an API key. By default, maps displayed by this plugin use data from https://openstreetmap.org/ and uses the leaflet JS library. By using this plugin, you accept and agree with OpenStreetMap’s terms of use, acceptable use policy and privacy policy The plugin provides optional integration with CloudImage. The integration requires to create an account at https://cloudimage.io and accept and agree their terms of use. Icons used in the UI are Genericons, licenced under the GPL 2.0.