Event Organiser CSV

Importing new venues, categories and tags

By default the plug-in will only import venues, categories and tags that already exist. To allow the plug-in to create new venues, categories and tags you can add the following code (to a seperate plug-in or your theme’s functions.php ).

function my_set_import_imports( $args, $file ){ $args['import_new_event-category'] = true; //create category if it doesn't exist $args['import_new_event-venue'] = true; //create venue if it doesn't exist. $args['import_new_event-tag'] = true; //create tag if it doesn't exist. return $args; } add_filter( 'eventorganiser_csv_import_args', 'my_set_import_imports', 10, 2 );

Please note the limitations on importing venues discussed below.

Limitations

Current limitations apply. See the examples folder for an archetypal CSV file

• All dates are read using PHP’s DateTime. While various formats are supported, Y-m-d (e.g. 2013-12-31) formats are strongly recommended
• Starts dates must be provided in Y-m-d (e.g. 2013-12-31) for all day events and also include a time-component (e.g. 2013-12-31 11:30pm) for non-all-day events. There is no prescribed format for the time but 24-hour time is recommended. You do not need to specify seconds.
• Include/exclude dates should be given as comma-seperated list of dates in Y-m-d format.
• Categories and tags must be given as comma-seperated list of names
• It does not support venue meta-data (yet)

Please note that in theory all dates (other than the start date) can be given in any format, however, to ensure dates are interpreted correctly it is strongly recommended to give dates in Y-m-d (or Y-m-d H:i for non-all day events) format. The start date must be in that format so that the importer can differentriate between all-day and non-all-day events.

Future Features

• An “import preview” or “dry-run” so users can view how events will be imported.
• Support venue meta data
• Support category colours
• Add filters for developers
• Add support for UID to prevent importing an event twice (perhaps, update the event?)
• Add support ‘maps’ for importing from other applications (where format of exported CSV file is prescribed).
• Support generic date formatting (try to ‘guess’ / ask for format )