Event Organiser icon
Events & Booking

Event Organiser hooks reference

  • By Stephen Harris
  • v3.12.12
  • Updated

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.

functions.phpyour child theme
// 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

  • event-organiser-edit.php line 418 · used in 4 places
    /**
     * Triggered after an event has been updated.
     */
    do_action( 'eventorganiser_save_event', $post_id );
  • event-organiser-debug.php line 526 · used in 2 places
    /**
     * Settings to include in an export.
     */
    apply_filters( 'eventorganiser_export_settings', $options );
  • includes/event-organiser-ajax.php line 107 · used in 2 places
    /**
     * Filters the event before it is sent to the calendar.
     */
    apply_filters( 'eventorganiser_fullcalendar', $events_array, $query );
  • includes/event-organiser-venue-functions.php line 569 · used in 2 places
    /**
     * Triggered when a venue is created / updated.
     */
    do_action( 'eventorganiser_save_venue', $venue_id );
  • event-organiser-venues.php line 173
    /**
     * Fires after all built-in meta boxes for venues have been added.
     */
    do_action( 'add_meta_boxes_event_page_venues', $venue );
  • includes/event-organiser-ajax.php line 425
    /**
     * 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 );
  • includes/event-organiser-ajax.php line 533
    /**
     * Filters the event before its sent to the admin calendar.
     */
    apply_filters( 'eventorganiser_admin_fullcalendar_event', $event, $post->ID, $post->occurrence_id );
  • includes/event-organiser-utility-functions.php line 1499
    /**
     * Filters whether your site's time format is 12 hour or 24 hour.
     */
    apply_filters( 'eventorganiser_blog_is_24', $is_24 );
  • includes/event-organiser-utility-functions.php line 1523
    /**
     * Filters whether your site's date format uses the date suffix 'S'
     */
    apply_filters( 'eventorganiser_blog_is_using_ordinal', $use_ordinal );
  • includes/event-organiser-event-functions.php line 1764
    /**
     * Filters an array of keys which should be ignored when breaking an
     * occurrence.
     */
    apply_filters( 'eventorganiser_breaking_occurrence_exclude_meta', $ignore_meta );
  • event-organiser-calendar.php line 387
    /**
     * Allows tabs to the admin calendar modal to be added.
     */
    apply_filters( 'eventorganiser_calendar_dialog_tabs', array( 'summary' => __( 'Event Details', 'eventorganiser' ) ) );
  • includes/event.php line 269
    /**
     * Fires after an event has been created.
     */
    do_action( 'eventorganiser_created_event', $post_id );
  • includes/event.php line 326
    /**
     * Triggers just before the specified occurrences for the event are deleted.
     */
    do_action( 'eventorganiser_delete_event_occurrences', $event_id, $occurrence_ids );
  • includes/event-organiser-event-functions.php line 1141
    /**
     * Filters an array of classes for specified event (occurrence)
     */
    apply_filters( 'eventorganiser_event_classes', $event_classes, $post_id, $occurrence_id );
  • includes/event-organiser-event-functions.php line 1040
    /**
     * Filters the colour associated with an event
     */
    apply_filters( 'eventorganiser_event_color', $color, $post_id );
  • includes/event-organiser-event-functions.php line 1593
    /**
     * Filters mark-up for the event details list.
     */
    apply_filters( 'eventorganiser_event_meta_list', $html, $event_id );
  • event-organiser-edit.php line 93
    /**
     * Filters the notice at the top of the event details metabox.
     */
    apply_filters( 'eventorganiser_event_metabox_notice', $notices, $post );
  • includes/event-organiser-cpt.php line 311
    /**
     * Filters the settings used in `register_post_type()` for event post type.
     */
    apply_filters( 'eventorganiser_event_properties', $args );
  • includes/event-organiser-ajax.php line 197
    /**
     * 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 );
  • includes/event-organiser-register.php line 496
    /**
     * Filters how long (in seconds) after an event as finished it should be
     * considered expired.
     */
    apply_filters( 'eventorganiser_events_expire_time', 24*60*60 );
  • includes/event-organiser-utility-functions.php line 75
    /**
     * Filters the formatted date (DateTime object).
     */
    apply_filters( 'eventorganiser_format_datetime', $formatted_datetime, $format, $datetime );
  • includes/event-organiser-ajax.php line 266
    /**
     * Filters the event before it is sent to the calendar.
     */
    apply_filters( 'eventorganiser_fullcalendar_event', $event, $post->ID, $post->occurrence_id );
  • includes/event-organiser-ajax.php line 84
    /**
     * Filters the query before it is sent to the calendar.
     */
    apply_filters( 'eventorganiser_fullcalendar_query', $query );
  • includes/event.php line 914
    /**
     * Filters the event schedule after its dates has been generated by a given
     * schedule.
     */
    apply_filters( 'eventorganiser_generate_occurrences', $_event_data, $schedule );
  • includes/event.php line 579
    /**
     * Filters the schedule metadata for an event (as returned by
     * `eo_get_event_schedule()`.
     */
    apply_filters( 'eventorganiser_get_event_schedule', $event_details, $post_id );
  • includes/event-organiser-event-functions.php line 500
    /**
     * Filters the value returned by `eo_get_next_occurrence()`
     */
    apply_filters( 'eventorganiser_get_next_occurrence', eo_format_datetime( $next, $format ), $next, $format, $post_id );
  • includes/event-organiser-event-functions.php line 713
    /**
     * 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 );
  • includes/event-organiser-event-functions.php line 661
    /**
     * 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 );
  • includes/event-organiser-event-functions.php line 442
    /**
     * 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 );
  • includes/event-organiser-event-functions.php line 919
    /**
     * Filters the value returned by `eo_get_the_future_occurrences_of()`
     */
    apply_filters( 'eventorganiser_get_the_future_occurrences_of', $occurrences, $post_id );
  • includes/event-organiser-event-functions.php line 991
    /**
     * Filters the value returned by `eo_get_the_occurrences_of()`
     */
    apply_filters( 'eventorganiser_get_the_occurrences_of', $occurrences, $post_id );
  • includes/event-organiser-event-functions.php line 256
    /**
     * 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 );
  • includes/event-organiser-register.php line 44
    /**
     * Filters the URL for Google Maps
     */
    apply_filters( 'eventorganiser_google_maps_url', $url );
  • templates/ical.php line 130
    /**
     * Filters the description of the event as it appears in the iCal feed.
     */
    apply_filters( 'eventorganiser_ical_description', $description );
  • includes/class-eo-ical-parser.php line 239
    /**
     * Filter the feed class by reference.
     */
    do_action_ref_array( 'eventorganiser_ical_feed_parsed', array( &$this ) );
  • includes/class-eo-ical-parser.php line 163
    /**
     * Filters the options for the iCal parser class
     */
    apply_filters_ref_array( 'eventorganiser_ical_parser_args', array( $args, &$this ) );
  • includes/class-eo-ical-parser.php line 860
    /**
     * Action after iCal property has been parsed.
     */
    do_action( "eventorganiser_ical_property_{$property_lowercase}", $value, $modifiers, $this );
  • includes/class-eo-ical-parser.php line 1031
    /**
     * Filters the DateTimeZone object parsed from a timezone ID in an iCal feed.
     */
    apply_filters( 'eventorganiser_ical_timezone', $tz, $tzid );
  • includes/class-eo-ical-parser.php line 423
    /**
     * 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 );
  • includes/event-organiser-venue-functions.php line 650
    /**
     * Triggered when a venue is created.
     */
    do_action( 'eventorganiser_insert_venue', $venue_id );
  • includes/event-organiser-archives.php line 515
    /**
     * Filters whether the query is an event query.
     */
    apply_filters( 'eventorganiser_is_event_query', $bool, $query, $exclusive );
  • includes/event-organiser-utility-functions.php line 1738
    /**
     * Filter whether the site has more than one user with published events.
     */
    apply_filters( 'eventorganiser_is_multi_event_organiser', (bool) $is_multi_event_organiser );
  • includes/event-organiser-cpt.php line 277
    /**
     * Filters the menu position.
     */
    apply_filters( 'eventorganiser_menu_position', 5 );
  • event-organiser-edit.php line 349
    /**
     * Fires after EO's core event metabox fields have been rendered.
     */
    do_action( 'eventorganiser_metabox_after_core_fields', $post );
  • includes/event-organiser-event-functions.php line 1790
    /**
     * Triggered after an occurrence has been broken from an event.
     */
    do_action( 'eventorganiser_occurrence_broken', $post_id, $occurrence_id, $new_event_id );
  • includes/event-organiser-event-functions.php line 1714
    /**
     * Triggered before an occurrence is broken from an event.
     */
    do_action( 'eventorganiser_pre_break_occurrence', $post_id, $occurrence_id );
  • includes/event-organiser-templates.php line 330
    /**
     * 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 );
  • includes/class-eo-ical-parser.php line 648
    /**
     * 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 );
  • event-organiser-settings.php line 112
    /**
     * Triggered after a settings tab has been registered.
     */
    do_action( "eventorganiser_register_tab_{$tab_id}", $tab_id );
  • includes/event-organiser-cpt.php line 142
    /**
     * Filters the event category taxonomy properties.
     */
    apply_filters( 'eventorganiser_register_taxonomy_event-category', $event_category_args );
  • includes/event-organiser-cpt.php line 205
    /**
     * Filters the event tag taxonomy properties.
     */
    apply_filters( 'eventorganiser_register_taxonomy_event-tag', $event_tag_args );
  • includes/event-organiser-cpt.php line 88
    /**
     * Filters the event venue taxonomy properties.
     */
    apply_filters( 'eventorganiser_register_taxonomy_event-venue', $event_venue_args );
  • event-organiser-settings.php line 28
    /**
     * 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' ), ) );
  • includes/event-organiser-templates.php line 149
    /**
     * Filters the handle for a stylesheet
     */
    apply_filters( "eventorganiser_stylesheet_handle_{$handle}", $handle );
  • includes/event-organiser-templates.php line 80
    /**
     * Filters the template stack: an array of directories the plug-in looks for
     * for templates.
     */
    apply_filters( 'eventorganiser_template_stack', $stack );
  • includes/event-organiser-utility-functions.php line 785
    /**
     * Filter the event's trimmed excerpt string.
     */
    apply_filters( 'eventorganiser_trim_excerpt', $text, $raw_excerpt );
  • includes/event.php line 128
    /**
     * Fires after an event has been updated.
     */
    do_action( 'eventorganiser_updated_event', $post_id );
  • includes/event-organiser-venue-functions.php line 1017
    /**
     * Filters fields used for the address of a venue.
     */
    apply_filters( 'eventorganiser_venue_address_fields', $address_fields );
  • includes/event-organiser-venue-functions.php line 700
    /**
     * Triggered when a venue is deleted
     */
    do_action( 'eventorganiser_venue_deleted', $venue_id );
  • includes/event-organiser-venue-functions.php line 840
    /**
     * Filters the tooltip content for a venue.
     */
    apply_filters( 'eventorganiser_venue_map_options', $map );
  • includes/event-organiser-venue-functions.php line 812
    /**
     * Filters the url of the venue map marker. Set to `null` for default.
     */
    apply_filters( 'eventorganiser_venue_marker', null, $venue_id, $args );
  • includes/event-organiser-venue-functions.php line 802
    /**
     * Filters the tooltip content for a venue.
     */
    apply_filters( 'eventorganiser_venue_tooltip', $tooltip_content, $venue_id, $args );
  • classes/class-eo-widget-categories.php line 98
    /**
     * Filters the arguments for the event category list.
     */
    apply_filters( 'eventorganiser_widget_event_categories_args', $cat_args );
  • classes/class-eo-widget-categories.php line 65
    /**
     * Filters the settings for the event category dropdown.
     */
    apply_filters( 'eventorganiser_widget_event_categories_dropdown_args', $cat_args );
  • classes/class-eo-widget-venues.php line 101
    /**
     * Filters the arguments for the event venue list.
     */
    apply_filters( 'eventorganiser_widget_event_venues_args', $cat_args );
  • classes/class-eo-widget-venues.php line 67
    /**
     * Filters the settings for the event venue list drppdown.
     */
    apply_filters( 'eventorganiser_widget_event_venues_dropdown_args', $cat_args );
  • widget_title

    filter
    classes/class-eo-agenda-widget.php line 96 · used in 5 places
    apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base );
  • includes/class-eo-theme-compatability.php line 167 · used in 4 places
    apply_filters( 'category_archive_meta', '<div class="category-archive-meta">' . $tag_description . '</div>' );
  • includes/event-organiser-ajax.php line 175 · used in 2 places
    apply_filters( 'excerpt_length', 55 );
  • event-organiser-venues.php line 178
    do_action( 'add_meta_boxes', 'event_page_venues', $venue );
  • templates/event-meta-event-single.php line 100
    do_action( 'eventorganiser_additional_event_meta' );
  • includes/event-organiser-ajax.php line 520
    apply_filters( 'eventorganiser_admin_calendar', $event, $post );
  • includes/event-organiser-ajax.php line 281
    apply_filters( 'eventorganiser_cache_expiration_eo_full_calendar_public', -1, $query, $key, $events_array );
  • includes/event-organiser-ajax.php line 690
    apply_filters( 'eventorganiser_cache_expiration_eo_widget_agenda', -1, $query, $key, $return );
  • classes/class-eo-calendar-widget.php line 407
    apply_filters( 'eventorganiser_cache_expiration_eo_widget_calendar', -1, $query, $key, $return );
  • event-organiser-debug.php line 40
    do_action_ref_array( 'eventorganiser_debugger_setup', array( &$eo_debugger ) );
  • includes/event.php line 318
    do_action( 'eventorganiser_delete_event', $event_id, $occurrence_ids );
  • includes/event-organiser-venue-functions.php line 693
    do_action( 'eventorganiser_delete_venue', $venue_id );
  • classes/class-eo-event-list-widget.php line 297
    apply_filters( 'eventorganiser_event_list_loop', false );
  • event-organiser-settings.php line 624
    do_action( "eventorganiser_event_settings_{$active_tab}" );
  • event-organiser-settings.php line 635
    do_action( 'eventorganiser_event_settings_imexport' );
  • includes/event-organiser-utility-functions.php line 96
    apply_filters( 'eventorganiser_format_datetime_string', $formatted, $dateString, $format, $datetime );
  • templates/ical.php line 152
    apply_filters( 'eventorganiser_ical_location', $venue );
  • templates/ical.php line 119
    apply_filters( 'eventorganiser_ical_summary', $event_title );
  • includes/event.php line 239
    apply_filters( 'eventorganiser_insert_event_event_data', $event_data, $post_data, $event_data );
  • includes/event.php line 244
    apply_filters( 'eventorganiser_insert_event_post_data', $post_data, $post_data, $event_data );
  • event-organiser.php line 173
    apply_filters( 'eventorganiser_options', $options );
  • includes/event-organiser-venue-functions.php line 613
    apply_filters( 'eventorganiser_pre_insert_venue', $args );
  • classes/class-eo-event-list-widget.php line 86
    apply_filters( 'eventorganiser_query_scope', $intervals );
  • includes/event-organiser-templates.php line 119
    apply_filters( 'eventorganiser_stylesheet_src', $src, $handle );
  • includes/event-organiser-templates.php line 120
    apply_filters( "eventorganiser_stylesheet_src_{$handle}", $src );
  • includes/class-eo-theme-compatability.php line 243
    apply_filters( 'eventorganiser_theme_compatability_templates', $templates );
  • includes/event-organiser-utility-functions.php line 355
    apply_filters( 'eventorganiser_timezone', $tzstring );
  • includes/event.php line 76
    apply_filters( 'eventorganiser_update_event_event_data', $event_data, $post_id, $post_data, $event_data );
  • includes/event.php line 80
    apply_filters( 'eventorganiser_update_event_post_data', $post_data, $post_id, $post_data, $event_data );
  • event-organiser-venues.php line 288
    do_action( 'eventorganiser_venue_edit_form_tag', $venue );
  • includes/event-organiser-venue-functions.php line 260
    apply_filters( 'eventorganiser_venue_excerpt', $text, $venue_id );
  • excerpt_more

    filter
    includes/event-organiser-venue-functions.php line 256
    apply_filters( 'excerpt_more', ' ' . '[…]' );
  • includes/event-organiser-templates.php line 32
    do_action( "get_template_part_{$slug}", $slug, $name );
  • list_cats

    filter
    includes/class-eo-walker-taxonomydropdown.php line 27
    apply_filters( 'list_cats', $category->name, $category );
  • plugin_locale

    filter
    event-organiser.php line 91
    apply_filters( 'plugin_locale', get_locale(), $domain );
  • the_content

    filter
    includes/event-organiser-utility-functions.php line 775
    apply_filters( 'the_content', $text );
  • includes/event-organiser-event-functions.php line 1294
    apply_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: