Simple Calendar icon
Events & Booking

Simple Calendar hooks reference

  • By SimpleCalendar
  • v4.3.3 New
  • Updated

Simple Calendar 4.3.3 has 66 actions and 75 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 Simple Calendar fires an action
add_action( 'simcal_clear_ics_feed_cache', function( $id ) {
	// Your code runs here.
}, 10, 1 );

// Change a value Simple Calendar is about to use
add_filter( 'simcal_additional_event_link_attributes', function( $value, $attr ) {
	// Change $value here.
	return $value;
}, 10, 2 );

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

  • includes/functions/shared.php line 698 · used in 2 places
    /**
     * Clear Pro ICS subscription feed cache for this calendar.
     */
    do_action( 'simcal_clear_ics_feed_cache', $calendar->id );
  • includes/functions/shared.php line 706 · used in 2 places
    /**
     * Fires after feed transients for a calendar are deleted.
     */
    do_action( 'simcal_deleted_feed_transients', $calendar->id );
  • includes/frontend/sc-event-single.php line 397
    /**
     * Before the event detail wrapper.
     */
    do_action( 'simcal_before_event_detail', $post, $context );
  • includes/ics-export.php line 169
    /**
     * Print extra calendar action buttons (e.g. Pro ICS URL).
     */
    do_action( 'simcal_calendar_action_buttons', $calendar_id, $show_ics_export );
  • includes/functions/shared.php line 208
    /**
     * Filter whether the Spread the Word setting can be managed for a calendar.
     */
    apply_filters( 'simcal_can_manage_powered_by', $can_manage, $calendar_id );
  • includes/abstracts/calendar.php line 1032
    /**
     * Filter the prerequisites documentation URL shown in the empty-events notice.
     */
    apply_filters( 'simcal_empty_events_notice_docs_url', $docs_url, $this );
  • includes/frontend/sc-event-single.php line 384
    /**
     * Filter event detail wrapper CSS classes.
     */
    apply_filters( 'simcal_event_detail_classes', ['simcal-event-detail'], $post, $context );
  • includes/frontend/sc-event-single.php line 373
    /**
     * Filter event detail template context.
     */
    apply_filters( 'simcal_event_detail_context', $context, $post );
  • includes/frontend/sc-event-single.php line 530
    /**
     * Filter description HTML before output.
     */
    apply_filters( 'simcal_event_detail_description_html', $content, $post, $context );
  • includes/frontend/sc-event-single.php line 631
    /**
     * Filter Add to Google Calendar link text.
     */
    apply_filters( 'simcal_event_detail_gcal_text', __('Add to GCal', 'google-calendar-events'), $post, $context );
  • includes/frontend/sc-event-single.php line 444
    /**
     * Filter the full event detail HTML.
     */
    apply_filters( 'simcal_event_detail_html', $html, $post, $context );
  • includes/frontend/sc-event-single.php line 578
    /**
     * Filter the map placeholder HTML.
     */
    apply_filters( 'simcal_event_detail_map_html', $map_html, $post, $context );
  • includes/functions/shared.php line 93
    /**
     * Filter whether a valid premium add-on license is active.
     */
    apply_filters( 'simcal_has_valid_addon_license', $has_valid );
  • includes/feeds/admin/ics-feed-admin.php line 322
    /**
     * Process add-on ICS feed meta before core file handling.
     */
    do_action( 'simcal_ics_feed_process_meta', $post_id );
  • includes/feeds/admin/ics-feed-admin.php line 252
    /**
     * Add ICS feed source fields after the file upload.
     */
    do_action( 'simcal_ics_feed_settings_fields_after', $post_id );
  • includes/ics-export.php line 455
    /**
     * Extra VEVENT lines (e.g. Pro ORGANIZER / ATTENDEE / ATTACH).
     */
    apply_filters( 'simcal_ics_vevent_extra_lines', [], $event );
  • includes/feeds/ics-feed.php line 1558
    /**
     * Filter Windows timezone ID to IANA mapping used by ICS Feed.
     */
    apply_filters( 'simcal_ics_windows_timezone_map', $map );
  • includes/functions/shared.php line 150
    /**
     * Filter whether a calendar is subject to the Powered by cutoff rules.
     */
    apply_filters( 'simcal_is_powered_by_cutoff_calendar', $is_cutoff, $calendar_id );
  • includes/functions/shared.php line 177
    /**
     * Filter whether the Powered by credit is mandatory for a calendar.
     */
    apply_filters( 'simcal_is_powered_by_mandatory', $mandatory, absint($calendar_id) );
  • includes/objects.php line 328
    /**
     * Swap or override a resolved object class name.
     */
    apply_filters( 'simcal_object_class_name', $class_name, $name, $type );
  • includes/functions/shared.php line 114
    /**
     * Filter the Powered by feature cutoff datetime (UTC).
     */
    apply_filters( 'simcal_powered_by_cutoff_datetime', '2026-11-10 00:00:00' );
  • includes/abstracts/calendar.php line 1006
    /**
     * Filter whether to display the empty-events diagnostic notice.
     */
    apply_filters( 'simcal_show_empty_events_notice', $show_notice, $this );
  • includes/admin/pages/system-status.php line 596
    /**
     * Final Output ============
     */
    apply_filters( 'simcal_system_status_report_panels', $panels );
  • includes/abstracts/calendar.php line 977
    /**
     * Filter whether the current user can see the empty-events diagnostic notice.
     */
    apply_filters( 'simcal_user_can_view_empty_events_notice', $can_view, $this );
  • includes/admin/pages/connect-controller.php line 93
    /**
     * Filter the welcome video embed URL shown on the Connect welcome step.
     */
    apply_filters( 'simple_calendar_connect_welcome_video_url', $default, $welcome_context_for_template );
  • includes/admin/pages/advanced.php line 145 · used in 4 places
    apply_filters( "simcal_add_{$this->option_group}_{$this->id}_fields", $fields );
  • includes/admin/pages/advanced.php line 48 · used in 4 places
    apply_filters( "simcal_add_{$this->option_group}_{$this->id}_sections", [ 'assets' => [ 'title' => __('Styles', 'google-calendar-events'), 'description' => '<div class="simcal-text-sm simcal-font-poppins simcal-font-normal simcal-text-sc_grey-100 simcal-mt-[5px] ">' . __('Manage front end assets that handle the calendars appearance.', 'google-calendar-events') . '</div>', ], 'optimisation' => [ 'title' => __('Optimisation', 'google-calendar-events'), 'description' ... );
  • includes/admin/metaboxes/settings.php line 65 · used in 4 places
    apply_filters( 'simcal_default_feed_type', 'google' );
  • includes/admin/meta-boxes.php line 97 · used in 3 places
    apply_filters( 'simcal_installed_addons', [] );
  • includes/admin/views/page-add-ons.php line 41 · used in 2 places
    do_action( "simcal_admin_page_{$page_slug}_{$current_tab}_end" );
  • includes/admin/views/page-add-ons.php line 40 · used in 2 places
    do_action( "simcal_admin_page_{$page_slug}_{$current_tab}_start" );
  • includes/abstracts/calendar.php line 946 · used in 2 places
    do_action( 'simcal_calendar_html_after', $this->id );
  • includes/abstracts/calendar.php line 940 · used in 2 places
    do_action( 'simcal_calendar_html_before', $this->id );
  • includes/admin/metaboxes/settings.php line 184 · used in 2 places
    apply_filters( 'simcal_default_calendar_type', 'default-calendar' );
  • includes/feeds/admin/ics-feed-admin.php line 197 · used in 2 places
    apply_filters( 'simcal_ics_feed_show_core_options', true, $post_id );
  • includes/functions/admin.php line 435 · used in 2 places
    apply_filters( 'simcal_is_google_calendar_pro_active', $is_pro_active );
  • includes/feeds/google.php line 595 · used in 2 places
    apply_filters( 'simple_calendar_oauth_list_events', '', $id, $args );
  • includes/main.php line 222
    do_action( 'before_simcal_init' );
  • plugin_locale

    filter
    includes/main.php line 106
    apply_filters( 'plugin_locale', get_locale(), 'google-calendar-events' );
  • includes/abstracts/admin-page.php line 163
    apply_filters( "simcal_{$this->option_group}_{$this->id}_sections_callback", $default );
  • includes/installation.php line 46
    do_action( 'simcal_activated' );
  • includes/ajax.php line 51
    do_action( 'simcal_add_ajax_callbacks' );
  • includes/admin/meta-boxes.php line 154
    do_action( 'simcal_add_meta_boxes' );
  • includes/shortcodes.php line 56
    do_action( 'simcal_add_shortcodes' );
  • includes/admin/fields/license.php line 80
    apply_filters( "simcal_addon_status_{$this->addon}", simcal_get_license_status($this->addon) );
  • includes/admin/menus.php line 187
    do_action( 'simcal_admin_add_menu_items' );
  • includes/admin/notices.php line 203
    apply_filters( 'simcal_admin_notices', get_option('simple-calendar_admin_notices', []) );
  • includes/admin/views/page-misc-settings.php line 99
    do_action( "simcal_admin_page_{$page_slug}_{$advanced_tab_id}_end" );
  • includes/admin/views/page-misc-settings.php line 96
    do_action( "simcal_admin_page_{$page_slug}_{$advanced_tab_id}_start" );
  • includes/admin/views/page-misc-settings.php line 101
    apply_filters( "simcal_admin_page_{$page_slug}_{$advanced_tab_id}_submit", true );
  • includes/admin/views/page-misc-settings.php line 72
    do_action( "simcal_admin_page_{$page_slug}_{$calendars_tab_id}_end" );
  • includes/admin/views/page-misc-settings.php line 69
    do_action( "simcal_admin_page_{$page_slug}_{$calendars_tab_id}_start" );
  • includes/admin/views/page-misc-settings.php line 74
    apply_filters( "simcal_admin_page_{$page_slug}_{$calendars_tab_id}_submit", true );
  • includes/admin/views/page-tools.php line 28
    apply_filters( "simcal_admin_page_{$page_slug}_{$current_tab}_submit", true );
  • includes/admin/pages.php line 78
    do_action( 'simcal_admin_pages', $page );
  • includes/frontend/sc-event-single.php line 431
    do_action( 'simcal_after_event_detail', $post, $context );
  • includes/frontend/sc-event-single.php line 538
    do_action( 'simcal_after_event_detail_description', $post, $context );
  • includes/frontend/sc-event-single.php line 667
    do_action( 'simcal_after_event_detail_details', $post, $context );
  • includes/frontend/sc-event-single.php line 603
    do_action( 'simcal_after_event_detail_location', $post, $context );
  • includes/frontend/sc-event-single.php line 504
    do_action( 'simcal_after_event_detail_meta', $post, $context );
  • includes/frontend/sc-event-single.php line 427
    do_action( 'simcal_after_event_detail_sidebar', $post, $context );
  • includes/frontend/sc-event-single.php line 519
    do_action( 'simcal_before_event_detail_description', $post, $context );
  • includes/frontend/sc-event-single.php line 620
    do_action( 'simcal_before_event_detail_details', $post, $context );
  • includes/frontend/sc-event-single.php line 555
    do_action( 'simcal_before_event_detail_location', $post, $context );
  • includes/frontend/sc-event-single.php line 482
    do_action( 'simcal_before_event_detail_meta', $post, $context );
  • includes/frontend/sc-event-single.php line 420
    do_action( 'simcal_before_event_detail_sidebar', $post, $context );
  • includes/frontend/sc-event-single.php line 415
    do_action( 'simcal_before_event_detail_summary', $post, $context );
  • includes/update.php line 83
    do_action( 'simcal_before_update', $this->installed_ver );
  • includes/abstracts/calendar.php line 906
    apply_filters( 'simcal_calendar_class', ['simcal-calendar', $this->type, $view_class], $this->id );
  • includes/abstracts/calendar.php line 411
    apply_filters( 'simcal_calendar_default_feed', 'google' );
  • includes/abstracts/calendar.php line 405
    apply_filters( 'simcal_calendar_default_type', 'default-calendar' );
  • includes/calendars/default-calendar.php line 330
    do_action( 'simcal_calendar_get_view', $this->type, $view );
  • includes/abstracts/calendar.php line 378
    apply_filters( 'simcal_calendar_title', $title );
  • includes/functions/shared.php line 358
    apply_filters( 'simcal_common_scripts_variables', [] );
  • includes/main.php line 458
    apply_filters( 'simcal_connect_authenticate_with_google_url', '' );
  • includes/admin/pages/connect/steps/pro-credentials.php line 57
    apply_filters( 'simcal_connect_oauth_via_simple_calendar_url', $authredirect );
  • includes/admin/ajax.php line 132
    apply_filters( 'simcal_connect_own_oauth_calendarlist', null );
  • includes/functions/admin.php line 284
    apply_filters( 'simcal_connect_settings_fields', $fields );
  • includes/calendars/views/default-calendar-grid.php line 224
    apply_filters( 'simcal_current_cols', $calendar->static ? '7' : '5' );
  • includes/installation.php line 61
    do_action( 'simcal_deactivated' );
  • includes/calendars/default-calendar.php line 128
    apply_filters( 'simcal_default_calendar_views', [ 'grid' => __('Grid', 'google-calendar-events'), 'list' => __('List', 'google-calendar-events'), ] );
  • includes/functions/shared.php line 479
    apply_filters( 'simcal_default_event_template', $content );
  • includes/functions/shared.php line 637
    do_action( 'simcal_delete_plugin_transients' );
  • includes/assets.php line 176
    do_action( 'simcal_enqueue_assets' );
  • includes/frontend/sc-event-single.php line 665
    do_action( 'simcal_event_detail_details', $post, $context );
  • includes/frontend/sc-event-single.php line 653
    do_action( 'simcal_event_detail_details_rows', $post, $context );
  • includes/frontend/sc-event-single.php line 601
    do_action( 'simcal_event_detail_location', $post, $context );
  • includes/frontend/sc-event-single.php line 502
    do_action( 'simcal_event_detail_meta', $post, $context );
  • includes/frontend/sc-event-single.php line 425
    do_action( 'simcal_event_detail_sidebar', $post, $context );
  • includes/frontend/sc-event-single.php line 418
    do_action( 'simcal_event_detail_summary', $post, $context );
  • includes/events/event-builder.php line 1293
    apply_filters( 'simcal_event_tags_add_custom', [] );
  • includes/events/event-builder.php line 1301
    apply_filters( 'simcal_event_tags_do_custom', '', $tag, $partial, $attr, $event );
  • includes/functions/shared.php line 233
    apply_filters( 'simcal_feed_type_labels', [] );
  • includes/admin/metaboxes/settings.php line 56
    apply_filters( 'simcal_feed_types_requiring_google_api_key', ['google'] );
  • includes/assets.php line 410
    apply_filters( 'simcal_front_end_scripts', $scripts );
  • includes/assets.php line 419
    apply_filters( 'simcal_front_end_styles', $styles );
  • includes/abstracts/admin-page.php line 103
    apply_filters( "simcal_get_{$this->option_group}_{$this->id}", $settings );
  • includes/objects.php line 149
    apply_filters( 'simcal_get_admin_pages', [] );
  • includes/objects.php line 135
    apply_filters( 'simcal_get_calendar_types', [] );
  • includes/objects.php line 121
    apply_filters( 'simcal_get_feed_types', [] );
  • includes/widgets.php line 37
    apply_filters( 'simcal_get_widgets', ['SimpleCalendar\Widgets\Calendar'], [] );
  • includes/feeds/google.php line 761
    apply_filters( 'simcal_google_client_curl_options', [] );
  • includes/feeds/admin/ics-feed-admin.php line 138
    do_action( 'simcal_ics_feed_file_field_before', $post_id );
  • includes/feeds/admin/ics-feed-admin.php line 133
    apply_filters( 'simcal_ics_feed_file_field_label', __('ICS File', 'google-calendar-events') );
  • includes/feeds/admin/ics-feed-admin.php line 121
    apply_filters( 'simcal_ics_feed_hide_file_source', false, $post_id );
  • includes/feeds/admin/ics-feed-admin.php line 128
    do_action( 'simcal_ics_feed_settings_fields_before', $post_id );
  • simcal_init

    action
    includes/main.php line 228
    do_action( 'simcal_init' );
  • includes/functions/admin.php line 565
    apply_filters( 'simcal_is_appointment_addon_active', $is_active );
  • includes/functions/admin.php line 500
    apply_filters( 'simcal_is_fullcalendar_addon_active', $is_active );
  • includes/admin/meta-boxes.php line 59
    do_action( 'simcal_load_meta_boxes' );
  • includes/objects.php line 109
    do_action( 'simcal_load_objects', $is_admin );
  • simcal_loaded

    action
    includes/main.php line 143
    do_action( 'simcal_loaded' );
  • includes/calendars/views/default-calendar-grid.php line 257
    apply_filters( 'simcal_next_cols', '1' );
  • includes/calendars/views/default-calendar-list.php line 791
    apply_filters( 'simcal_no_events_message', $nothing_message, $calendar->id, $from, $to );
  • includes/post-types.php line 303
    apply_filters( 'simcal_post_type_registration_args', $args );
  • includes/calendars/views/default-calendar-grid.php line 212
    apply_filters( 'simcal_prev_cols', '1' );
  • includes/admin/metaboxes/settings.php line 1403
    do_action( 'simcal_process_settings_meta', $post_id );
  • includes/assets.php line 92
    do_action( 'simcal_register_assets' );
  • includes/post-types.php line 250
    do_action( 'simcal_register_post_types' );
  • includes/post-types.php line 50
    do_action( 'simcal_register_taxonomies' );
  • includes/widgets.php line 57
    do_action( 'simcal_register_widgets' );
  • includes/admin/meta-boxes.php line 208
    do_action( 'simcal_save_attach_calendar_meta', $post_id, $post );
  • includes/admin/meta-boxes.php line 211
    do_action( 'simcal_save_meta_boxes', $post_id, $post );
  • includes/admin/meta-boxes.php line 206
    do_action( 'simcal_save_sc_event_meta', $post_id, $post );
  • includes/admin/meta-boxes.php line 204
    do_action( 'simcal_save_settings_meta', $post_id, $post );
  • includes/post-types.php line 198
    apply_filters( 'simcal_sc_event_category_taxonomy_args', $args );
  • includes/post-types.php line 352
    apply_filters( 'simcal_sc_event_post_type_args', $args );
  • includes/post-types.php line 239
    apply_filters( 'simcal_sc_event_tag_taxonomy_args', $args );
  • includes/admin/metaboxes/settings.php line 114
    do_action( 'simcal_settings_meta_advanced_panel', $post->ID );
  • includes/admin/metaboxes/settings.php line 108
    do_action( 'simcal_settings_meta_calendar_panel', $post->ID );
  • includes/admin/metaboxes/settings.php line 105
    do_action( 'simcal_settings_meta_events_panel', $post->ID );
  • includes/admin/metaboxes/settings.php line 111
    do_action( 'simcal_settings_meta_panels', $post->ID );
  • includes/admin/metaboxes/settings.php line 100
    do_action( 'simcal_settings_meta_tabs' );
  • includes/admin/metaboxes/settings.php line 236
    apply_filters( 'simcal_settings_meta_tabs_li', [ 'events' => [ 'label' => __('Events', 'google-calendar-events'), 'target' => 'events-settings-panel', 'class' => ['active'], 'icon' => 'simcal-icon-event', ], 'calendar' => [ 'label' => __('Appearance', 'google-calendar-events'), 'target' => 'calendar-settings-panel', 'class' => [], 'icon' => 'simcal-icon-calendar', ], ], $post->ID );
  • includes/shortcodes.php line 141
    do_action( 'simcal_shortcode_assets_loaded' );
  • includes/admin/pages/system-status.php line 597
    apply_filters( 'simcal_system_status_report_sections', $sections );
  • includes/update.php line 103
    do_action( 'simcal_updated', $this->new_ver );
  • includes/admin/ajax.php line 405
    apply_filters( 'simcal_validate_api_key_public_calendar_id', 'en.usa#holiday@group.v.calendar.google.com' );
  • widget_title

    filter
    includes/widgets/calendar.php line 79
    apply_filters( 'widget_title', $instance['title'], $instance, $this->id_base );

Generated from Simple Calendar'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: