Event Organiser 3.12.12 has 23 actions and 83 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when Event Organiser fires an action
add_action( 'eventorganiser_save_event', function( $post_id ) {
// Your code runs here.
}, 10, 1 );
// Change a value Event Organiser is about to use
add_filter( 'eventorganiser_export_settings', function( $options ) {
// Change $options here.
return $options;
}, 10, 1 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
eventorganiser_save_event
action/** * Triggered after an event has been updated. */ do_action( 'eventorganiser_save_event', $post_id ); -
/** * Settings to include in an export. */ apply_filters( 'eventorganiser_export_settings', $options ); -
eventorganiser_fullcalendar
filter/** * Filters the event before it is sent to the calendar. */ apply_filters( 'eventorganiser_fullcalendar', $events_array, $query ); -
eventorganiser_save_venue
action/** * Triggered when a venue is created / updated. */ do_action( 'eventorganiser_save_venue', $venue_id ); -
/** * Fires after all built-in meta boxes for venues have been added. */ do_action( 'add_meta_boxes_event_page_venues', $venue ); -
/** * Filters the summary of the event as it appears in the admin calendar's * modal. */ apply_filters( 'eventorganiser_admin_cal_summary', $summary, $post->ID, $post->occurrence_id, $post ); -
/** * Filters the event before its sent to the admin calendar. */ apply_filters( 'eventorganiser_admin_fullcalendar_event', $event, $post->ID, $post->occurrence_id ); -
eventorganiser_blog_is_24
filter/** * Filters whether your site's time format is 12 hour or 24 hour. */ apply_filters( 'eventorganiser_blog_is_24', $is_24 ); -
/** * Filters whether your site's date format uses the date suffix 'S' */ apply_filters( 'eventorganiser_blog_is_using_ordinal', $use_ordinal ); -
/** * Filters an array of keys which should be ignored when breaking an * occurrence. */ apply_filters( 'eventorganiser_breaking_occurrence_exclude_meta', $ignore_meta ); -
/** * Allows tabs to the admin calendar modal to be added. */ apply_filters( 'eventorganiser_calendar_dialog_tabs', array( 'summary' => __( 'Event Details', 'eventorganiser' ) ) ); -
/** * Filters the link to the event's page on the admin calendar. */ apply_filters( 'eventorganiser_calendar_event_link', $link, $post->ID, $post->occurrence_id ); -
eventorganiser_created_event
action/** * Fires after an event has been created. */ do_action( 'eventorganiser_created_event', $post_id ); -
/** * Triggers just before the specified occurrences for the event are deleted. */ do_action( 'eventorganiser_delete_event_occurrences', $event_id, $occurrence_ids ); -
eventorganiser_event_classes
filter/** * Filters an array of classes for specified event (occurrence) */ apply_filters( 'eventorganiser_event_classes', $event_classes, $post_id, $occurrence_id ); -
eventorganiser_event_color
filter/** * Filters the colour associated with an event */ apply_filters( 'eventorganiser_event_color', $color, $post_id ); -
/** * Filters mark-up for the event details list. */ apply_filters( 'eventorganiser_event_meta_list', $html, $event_id ); -
/** * Filters the notice at the top of the event details metabox. */ apply_filters( 'eventorganiser_event_metabox_notice', $notices, $post ); -
/** * Filters the settings used in `register_post_type()` for event post type. */ apply_filters( 'eventorganiser_event_properties', $args ); -
eventorganiser_event_tooltip
filter/** * Filters the description of the event as it appears on the calendar tooltip. */ apply_filters( 'eventorganiser_event_tooltip', $description, $post->ID, $post->occurrence_id, $post ); -
/** * Filters how long (in seconds) after an event as finished it should be * considered expired. */ apply_filters( 'eventorganiser_events_expire_time', 24*60*60 ); -
/** * Filters the formatted date (DateTime object). */ apply_filters( 'eventorganiser_format_datetime', $formatted_datetime, $format, $datetime ); -
/** * Filters the event before it is sent to the calendar. */ apply_filters( 'eventorganiser_fullcalendar_event', $event, $post->ID, $post->occurrence_id ); -
/** * Filters the query before it is sent to the calendar. */ apply_filters( 'eventorganiser_fullcalendar_query', $query ); -
/** * Filters the event schedule after its dates has been generated by a given * schedule. */ apply_filters( 'eventorganiser_generate_occurrences', $_event_data, $schedule ); -
/** * Filters the schedule metadata for an event (as returned by * `eo_get_event_schedule()`. */ apply_filters( 'eventorganiser_get_event_schedule', $event_details, $post_id ); -
/** * Filters the value returned by `eo_get_next_occurrence()` */ apply_filters( 'eventorganiser_get_next_occurrence', eo_format_datetime( $next, $format ), $next, $format, $post_id ); -
/** * Filters the value returned by `eo_get_schedule_last()` */ apply_filters( 'eventorganiser_get_schedule_last', eo_format_datetime( $schedule_last, $format ), $schedule_last, $format, $post_id ); -
/** * Filters the value returned by `eo_get_schedule_start()` */ apply_filters( 'eventorganiser_get_schedule_start', eo_format_datetime( $schedule_start, $format ), $schedule_start, $format, $post_id ); -
eventorganiser_get_the_end
filter/** * Filters the value returned by `eo_get_the_end()` */ apply_filters( 'eventorganiser_get_the_end', eo_format_datetime( $end, $format ), $end, $format, $post_id, $occurrence_id ); -
/** * Filters the value returned by `eo_get_the_future_occurrences_of()` */ apply_filters( 'eventorganiser_get_the_future_occurrences_of', $occurrences, $post_id ); -
/** * Filters the value returned by `eo_get_the_occurrences_of()` */ apply_filters( 'eventorganiser_get_the_occurrences_of', $occurrences, $post_id ); -
eventorganiser_get_the_start
filter/** * Filters the value returned by `eo_get_the_start()` */ apply_filters( 'eventorganiser_get_the_start', eo_format_datetime( $start, $format ), $start, $format, $post_id, $occurrence_id ); -
/** * Filters the URL for Google Maps */ apply_filters( 'eventorganiser_google_maps_url', $url ); -
/** * Filters the description of the event as it appears in the iCal feed. */ apply_filters( 'eventorganiser_ical_description', $description ); -
/** * Filter the feed class by reference. */ do_action_ref_array( 'eventorganiser_ical_feed_parsed', array( &$this ) ); -
/** * Filters the options for the iCal parser class */ apply_filters_ref_array( 'eventorganiser_ical_parser_args', array( $args, &$this ) ); -
/** * Action after iCal property has been parsed. */ do_action( "eventorganiser_ical_property_{$property_lowercase}", $value, $modifiers, $this ); -
eventorganiser_ical_timezone
filter/** * Filters the DateTimeZone object parsed from a timezone ID in an iCal feed. */ apply_filters( 'eventorganiser_ical_timezone', $tz, $tzid ); -
/** * When parsing an iCal feed the 'until' date to assign to indefinitely * recurrring events Event Organiser doesn't support indefinitely recurring * events. When it encounters them in an iCal feed it assigns them an arbitrary * date in the future. This filter allows you to change that date */ apply_filters( 'eventorganiser_indefinitely_recurring_event_last_date', $until, $this->current_event, $this ); -
eventorganiser_insert_venue
action/** * Triggered when a venue is created. */ do_action( 'eventorganiser_insert_venue', $venue_id ); -
/** * Filters whether the query is an event query. */ apply_filters( 'eventorganiser_is_event_query', $bool, $query, $exclusive ); -
/** * Filter whether the site has more than one user with published events. */ apply_filters( 'eventorganiser_is_multi_event_organiser', (bool) $is_multi_event_organiser ); -
/** * Fires after EO's core event metabox fields have been rendered. */ do_action( 'eventorganiser_metabox_after_core_fields', $post ); -
/** * Triggered after an occurrence has been broken from an event. */ do_action( 'eventorganiser_occurrence_broken', $post_id, $occurrence_id, $new_event_id ); -
/** * Triggered before an occurrence is broken from an event. */ do_action( 'eventorganiser_pre_break_occurrence', $post_id, $occurrence_id ); -
/** * Filters the event details automatically appended to the event's content when * single-event.php is not present in the theme. */ apply_filters( 'eventorganiser_pre_event_content', $event_details, $content ); -
/** * Action before iCal property has been parsed. It also allows you to prevent * the default parsing of the property value. */ apply_filters( "eventorganiser_pre_ical_property_{$property_lowercase}", $skip, $value, $modifiers, $this, $property ); -
/** * Triggered after a settings tab has been registered. */ do_action( "eventorganiser_register_tab_{$tab_id}", $tab_id ); -
/** * Filters the event category taxonomy properties. */ apply_filters( 'eventorganiser_register_taxonomy_event-category', $event_category_args ); -
/** * Filters the event tag taxonomy properties. */ apply_filters( 'eventorganiser_register_taxonomy_event-tag', $event_tag_args ); -
/** * Filters the event venue taxonomy properties. */ apply_filters( 'eventorganiser_register_taxonomy_event-venue', $event_venue_args ); -
eventorganiser_settings_tabs
filter/** * Filters an array of tabs that appear in *Settings > Event Organiser* */ apply_filters( 'eventorganiser_settings_tabs', array( 'general' => __( 'General', 'eventorganiser' ), 'permissions' => __( 'Permissions', 'eventorganiser' ), 'permalinks' => __( 'Permalinks', 'eventorganiser' ), 'imexport' => __( 'Import', 'eventorganiser' ).'/'.__( 'Export', 'eventorganiser' ), ) ); -
/** * Filters the handle for a stylesheet */ apply_filters( "eventorganiser_stylesheet_handle_{$handle}", $handle ); -
/** * Filters the template stack: an array of directories the plug-in looks for * for templates. */ apply_filters( 'eventorganiser_template_stack', $stack ); -
eventorganiser_trim_excerpt
filter/** * Filter the event's trimmed excerpt string. */ apply_filters( 'eventorganiser_trim_excerpt', $text, $raw_excerpt ); -
eventorganiser_updated_event
action/** * Fires after an event has been updated. */ do_action( 'eventorganiser_updated_event', $post_id ); -
/** * Filters fields used for the address of a venue. */ apply_filters( 'eventorganiser_venue_address_fields', $address_fields ); -
eventorganiser_venue_deleted
action/** * Triggered when a venue is deleted */ do_action( 'eventorganiser_venue_deleted', $venue_id ); -
/** * Filters the tooltip content for a venue. */ apply_filters( 'eventorganiser_venue_map_options', $map ); -
eventorganiser_venue_marker
filter/** * Filters the url of the venue map marker. Set to `null` for default. */ apply_filters( 'eventorganiser_venue_marker', null, $venue_id, $args ); -
eventorganiser_venue_tooltip
filter/** * Filters the tooltip content for a venue. */ apply_filters( 'eventorganiser_venue_tooltip', $tooltip_content, $venue_id, $args ); -
/** * Filters the the link of a date on the events widget calendar */ apply_filters( 'eventorganiser_widget_calendar_date_link', $link, $current_date, $events ); -
/** * Filters the arguments for the event category list. */ apply_filters( 'eventorganiser_widget_event_categories_args', $cat_args ); -
/** * Filters the settings for the event category dropdown. */ apply_filters( 'eventorganiser_widget_event_categories_dropdown_args', $cat_args ); -
/** * Filters the arguments for the event venue list. */ apply_filters( 'eventorganiser_widget_event_venues_args', $cat_args ); -
/** * Filters the settings for the event venue list drppdown. */ apply_filters( 'eventorganiser_widget_event_venues_dropdown_args', $cat_args ); -
widget_title
filterapply_filters( 'widget_title', $instance['title'], $instance, $this->id_base ); -
category_archive_meta
filterapply_filters( 'category_archive_meta', '<div class="category-archive-meta">' . $tag_description . '</div>' ); -
excerpt_length
filterapply_filters( 'excerpt_length', 55 ); -
add_meta_boxes
actiondo_action( 'add_meta_boxes', 'event_page_venues', $venue ); -
do_action( 'eventorganiser_additional_event_meta' ); -
apply_filters( 'eventorganiser_admin_calendar', $event, $post ); -
apply_filters( 'eventorganiser_cache_expiration_eo_full_calendar_public', -1, $query, $key, $events_array ); -
apply_filters( 'eventorganiser_cache_expiration_eo_widget_agenda', -1, $query, $key, $return ); -
apply_filters( 'eventorganiser_cache_expiration_eo_widget_calendar', -1, $query, $key, $return ); -
do_action_ref_array( 'eventorganiser_debugger_setup', array( &$eo_debugger ) ); -
eventorganiser_delete_event
actiondo_action( 'eventorganiser_delete_event', $event_id, $occurrence_ids ); -
eventorganiser_delete_venue
actiondo_action( 'eventorganiser_delete_venue', $venue_id ); -
apply_filters( 'eventorganiser_event_list_loop', false ); -
do_action( "eventorganiser_event_settings_{$active_tab}" ); -
do_action( 'eventorganiser_event_settings_imexport' ); -
apply_filters( 'eventorganiser_format_datetime_string', $formatted, $dateString, $format, $datetime ); -
eventorganiser_get_permalink
filterapply_filters( 'eventorganiser_get_permalink', $permalink, $event_id, $occurrence_id ); -
eventorganiser_ical_location
filterapply_filters( 'eventorganiser_ical_location', $venue ); -
eventorganiser_ical_summary
filterapply_filters( 'eventorganiser_ical_summary', $event_title ); -
apply_filters( 'eventorganiser_insert_event_event_data', $event_data, $post_data, $event_data ); -
apply_filters( 'eventorganiser_insert_event_post_data', $post_data, $post_data, $event_data ); -
eventorganiser_options
filterapply_filters( 'eventorganiser_options', $options ); -
apply_filters( 'eventorganiser_pre_insert_venue', $args ); -
eventorganiser_query_scope
filterapply_filters( 'eventorganiser_query_scope', $intervals ); -
apply_filters( 'eventorganiser_stylesheet_src', $src, $handle ); -
apply_filters( "eventorganiser_stylesheet_src_{$handle}", $src ); -
apply_filters( 'eventorganiser_theme_compatability_templates', $templates ); -
eventorganiser_timezone
filterapply_filters( 'eventorganiser_timezone', $tzstring ); -
apply_filters( 'eventorganiser_update_event_event_data', $event_data, $post_id, $post_data, $event_data ); -
apply_filters( 'eventorganiser_update_event_post_data', $post_data, $post_id, $post_data, $event_data ); -
do_action( 'eventorganiser_venue_edit_form_tag', $venue ); -
eventorganiser_venue_excerpt
filterapply_filters( 'eventorganiser_venue_excerpt', $text, $venue_id ); -
excerpt_more
filterapply_filters( 'excerpt_more', ' ' . '[…]' ); -
get_template_part_{$slug}
actiondo_action( "get_template_part_{$slug}", $slug, $name ); -
list_cats
filterapply_filters( 'list_cats', $category->name, $category ); -
plugin_locale
filterapply_filters( 'plugin_locale', get_locale(), $domain ); -
the_content
filterapply_filters( 'the_content', $text ); -
the_excerpt_rss
filterapply_filters( 'the_excerpt_rss', get_the_excerpt() );
Generated from Event Organiser's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Can't find the right hook?
We can build the customisation for you. Describe what you need: