CiviCRM Event Organiser

Contributors: needle
Donate link: https://www.paypal.me/interactivist
Tags: civicrm, event organiser, events, sync
Requires at least: 4.9
Tested up to: 5.9
Stable tag: 0.7.1a
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Keep Event Organiser plugin Events in sync with CiviCRM Events.

Description

A WordPress plugin for syncing Event Organiser plugin Events with CiviCRM Events. The plugin syncs Event Organiser Events, Venues and Event Categories to their corresponding entities in CiviCRM.

Important note: Please do not use with (or upgrade to) CiviCRM 5.47. Your Events in CiviCRM will not respect Daylight Savings offsets.

ACF Integration

This plugin is compatible with CiviCRM Profile Sync which enables integration of Custom Fields on CiviCRM Events with ACF Fields attached to the Event Organiser "Event" Post Type.

Important note: Please make sure you have CiviCRM Profile Sync version 0.4 or greater.

Apple Calendar compatibility

There is an issue with Apple Calendar's display of Event Organiser iCal feeds which means that Apple Calendar requires special handling. To solve this, you can install the Event Organiser ICS Feed for Apple Calendar plugin and use its shortcode instead of the one supplied by Event Organiser.

Requirements

This plugin recommends a minimum of WordPress 4.9 and CiviCRM 5.13.

It also requires:

• Event Organiser version 3.0 or greater
• Radio Buttons for Taxonomies to ensure only one event type is selected

Be aware that this plugin is in active development. Test often, test thoroughly and open an issue if you find a problem.

Installation

Note: If installing on WordPress multisite, do not network-activate CiviCRM Event Organiser. Only activate it on the sites that Event Organiser is activated - even if Event Organiser is network-activated.

There are two ways to install from GitHub:

ZIP Download

If you have downloaded CiviCRM Event Organiser as a ZIP file from the GitHub repository, do the following to install and activate the plugin:

1. Unzip the .zip file and rename the enclosing folder so that the plugin's files are located directly inside /wp-content/plugins/civicrm-event-organiser
2. Activate the plugin
3. Go to the plugin's admin page and follow the instructions
4. You are done!

git clone

If you have cloned the code from GitHub, it is assumed that you know what you're doing.

Using CiviCRM Event Organiser

Now that you've installed the plugin, you'll want to find out:

• How to configure the CiviCRM Event Organiser settings.
• How to add synced Events to your website.

Known Issues

There is currently no proper integration with CiviCRM's implementation of repeating events in version 4.7.n because, at present, CiviCRM does not save (or expose) the schedule that generates the sequence. To get around this limitation, this plugin prioritises a workflow based on creating events in Event Organiser and then (optionally, via the "CiviCRM Settings" metabox on the event's edit page) passing the data over to CiviCRM when requested.

The plugin implements automatic linking to an event's online registration page(s) via the eventorganiser_additional_event_meta hook which has been available since Event Organiser 2.12.5. If you have overridden the Event Organiser template(s) you may have to apply the function to the appropriate hook in your template(s) yourself. See the documentation for the function civicrm_event_organiser_register_links() for details. Thanks to Consilience Media for providing the resources to push this forward.