/civicrm-event-organiser

A WordPress plugin for syncing Event Organiser events with CiviCRM events

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

CiviCRM Event Organiser

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.

Notes

This plugin requires at least WordPress 4.4 and CiviCRM 4.6 (CiviCRM 4.7 recommended).

It also requires:

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

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.

Installation

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 and theme:

  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 (if on WP multisite, only activate the plugin on the main site, or wherever Event Organiser is activated)
  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