The Events Calendar Shortcode & Block 4.0.0 has 6 actions and 67 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 The Events Calendar Shortcode & Block fires an action
add_action( 'ecs_admin_page_options_after', function() {
// Your code runs here.
}, 10, 1 );
// Change a value The Events Calendar Shortcode & Block is about to use
add_filter( 'ecs_admin_page_capability', function( $value ) {
// Change $value here.
return $value;
}, 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
-
ecs_admin_page_capability
filterapply_filters( 'ecs_admin_page_capability', 'edit_published_posts' ); -
ecs_bricks_designs
filterapply_filters( 'ecs_bricks_designs', [ 'free' => esc_html__( 'Standard', 'the-events-calendar-shortcode' ), ] ); -
apply_filters( 'ecs_elementor_thumbnail_width_and_height_conditions', [ 'thumbnail' => 'yes', 'thumbnail_dimensions_choice' => 'width_and_height', ] ); -
ecs_event_thumbnail
filterapply_filters( 'ecs_event_thumbnail', get_the_post_thumbnail( get_the_ID(), apply_filters( 'ecs_event_thumbnail_size', [ $thumbWidth, $thumbHeight ], $atts, $post ) ), $atts, $post ); -
ecs_event_thumbnail_size
filterapply_filters( 'ecs_event_thumbnail_size', [ $thumbWidth, $thumbHeight ], $atts, $post ); -
ecs_show_upgrades
filterapply_filters( 'ecs_show_upgrades', true ); -
ecs_admin_page_options_after
actiondo_action( 'ecs_admin_page_options_after' ); -
do_action( 'ecs_admin_page_options_after_cat' ); -
do_action( 'ecs_admin_page_options_before' ); -
ecs_admin_page_options_top
actiondo_action( 'ecs_admin_page_options_top' ); -
do_action( 'ecs_admin_page_styling_before' ); -
ecs_always_show
filterapply_filters( 'ecs_always_show', false, $atts ); -
ecs_atts_pre_query
filterapply_filters( 'ecs_atts_pre_query', $atts, $meta_date_date, $meta_date_compare ); -
ecs_beginning_output
filterapply_filters( 'ecs_beginning_output', $output, $posts, $atts ); -
ecs_block_attributes
filterapply_filters( 'ecs_block_attributes', [ 'design' => [ 'type' => 'string', 'default' => 'standard', ], 'limit' => [ 'type' => 'number', ], 'settings' => [ 'type' => 'string', 'default' => json_encode( [ 'design', 'limit', 'order', 'thumb', 'venue', 'excerpt', 'contentorder' ] ), ], 'cat' => [ 'type' => 'string' ], 'month' => [ 'type' => 'string' ], 'thumb' => [ 'type' => 'string', ], 'thumbsize' => [ 'type' => 'string', ], 'thumbwid... ); -
ecs_block_render_attribute
filterapply_filters( 'ecs_block_render_attribute', '', $key, $value ); -
ecs_bricks_atts
filterapply_filters( 'ecs_bricks_atts', $atts, $this->settings ); -
ecs_bricks_categories
filterapply_filters( 'ecs_bricks_categories', $categories ); -
apply_filters( 'ecs_bricks_thumbnail_condition', null ); -
ecs_default_contentorder
filterapply_filters( 'ecs_default_contentorder', 'title, thumbnail, excerpt, date, venue', $atts ); -
ecs_elementor_design_default
filterapply_filters( 'ecs_elementor_design_default', '' ); -
ecs_elementor_designs
filterapply_filters( 'ecs_elementor_designs', [ '' => __( 'Standard', 'the-events-calendar-shortcode' ), ] ); -
apply_filters( 'ecs_elementor_limit_condition', [] ); -
apply_filters( 'ecs_elementor_thumbnail_condition', [] ); -
apply_filters( 'ecs_elementor_thumbnail_size_conditions', [ 'thumbnail' => 'yes', 'thumbnail_dimensions_choice' => 'size', ] ); -
ecs_elementor_widget_atts
filterapply_filters( 'ecs_elementor_widget_atts', $atts, $settings ); -
do_action( 'ecs_elementor_widget_controls_before_advanced', $this ); -
apply_filters( 'ecs_elementor_widget_script_depends', [] ); -
ecs_end_tag
filterapply_filters( 'ecs_end_tag', '</ul>', $atts ); -
ecs_ending_output
filterapply_filters( 'ecs_ending_output', $output, $posts, $atts ); -
ecs_event_classes
filterapply_filters( 'ecs_event_classes', '', $atts, $post ); -
ecs_event_contentorder
filterapply_filters( 'ecs_event_contentorder', $atts['contentorder'], $atts, $post ); -
ecs_event_date_tag_end
filterapply_filters( 'ecs_event_date_tag_end', '</span>', $atts, $post ); -
ecs_event_date_tag_start
filterapply_filters( 'ecs_event_date_tag_start', '<span class="duration time">', $atts, $post ); -
ecs_event_date_thumb
filterapply_filters( 'ecs_event_date_thumb', '<div class="date_thumb"><div class="month">' . tribe_get_start_date( null, false, 'M' ) . '</div><div class="day">' . tribe_get_start_date( null, false, 'j' ) . '</div></div>', $atts, $post ); -
ecs_event_end_tag
filterapply_filters( 'ecs_event_end_tag', '</li>', $atts, $post ); -
ecs_event_excerpt
filterapply_filters( 'ecs_event_excerpt', self::get_excerpt( $excerptLength ), $atts, $post, $excerptLength ); -
ecs_event_excerpt_tag_end
filterapply_filters( 'ecs_event_excerpt_tag_end', '</p>', $atts, $post ); -
ecs_event_excerpt_tag_start
filterapply_filters( 'ecs_event_excerpt_tag_start', '<p class="ecs-excerpt">', $atts, $post ); -
ecs_event_list_details
filterapply_filters( 'ecs_event_list_details', tribe_events_event_schedule_details(), $atts, $post ); -
apply_filters( "ecs_event_list_output_custom_{strtolower(trim($contentorder))}", '', $atts, $post ); -
ecs_event_list_title
filterapply_filters( 'ecs_event_list_title', get_the_title(), $atts, $post ); -
apply_filters( 'ecs_event_list_title_link_end', '</a>', $atts, $post ); -
apply_filters( 'ecs_event_list_title_link_start', '<a href="' . tribe_get_event_link() . '" rel="bookmark">', $atts, $post ); -
ecs_event_list_venue
filterapply_filters( 'ecs_event_list_venue', tribe_get_venue(), $atts, $post ); -
ecs_event_list_viewall_link
filterapply_filters( 'ecs_event_list_viewall_link', tribe_get_events_link(), $atts ); -
ecs_event_start_tag
filterapply_filters( 'ecs_event_start_tag', '<li class="ecs-event' . implode( '', $category_slugs ) . $featured_class . apply_filters( 'ecs_event_classes', '', $atts, $post ) . '">', $atts, $post ); -
ecs_event_thumbnail_link_end
filterapply_filters( 'ecs_event_thumbnail_link_end', '</a>', $atts, $post ); -
apply_filters( 'ecs_event_thumbnail_link_start', '<a href="' . tribe_get_event_link() . '">', $atts, $post ); -
ecs_event_title_tag_end
filterapply_filters( 'ecs_event_title_tag_end', '</h4>', $atts, $post ); -
ecs_event_title_tag_start
filterapply_filters( 'ecs_event_title_tag_start', '<h4 class="entry-title summary">', $atts, $post ); -
ecs_event_venue_at_tag_end
filterapply_filters( 'ecs_event_venue_at_tag_end', ' </em>', $atts, $post ); -
ecs_event_venue_at_tag_start
filterapply_filters( 'ecs_event_venue_at_tag_start', '<em> ', $atts, $post ); -
ecs_event_venue_at_text
filterapply_filters( 'ecs_event_venue_at_text', __( 'at', 'the-events-calendar-shortcode' ), $atts, $post ); -
ecs_event_venue_tag_end
filterapply_filters( 'ecs_event_venue_tag_end', '</span>', $atts, $post ); -
ecs_event_venue_tag_start
filterapply_filters( 'ecs_event_venue_tag_start', '<span class="duration venue">', $atts, $post ); -
ecs_filter_events_after_get
filterapply_filters( 'ecs_filter_events_after_get', $posts, $atts ); -
ecs_get_events_args
filterapply_filters( 'ecs_get_events_args', [ 'post_status' => 'publish', 'hide_upcoming' => true, 'posts_per_page' => $atts['limit'], 'tax_query' => $atts['event_tax'], 'meta_key' => ( ( trim( $atts['orderby'] ) and 'title' != $atts['orderby'] ) ? $atts['orderby'] : $atts['key'] ), 'orderby' => ( $atts['orderby'] == 'title' ? 'title' : 'event_date' ), 'author' => $atts['author'], 'order' => 'DESC' === strtoupper( $atts['order'] ) ? 'DES... ); -
ecs_get_meta_query
filterapply_filters( 'ecs_get_meta_query', [ $atts['meta_date'] ], $atts, $meta_date_date, $meta_date_compare ); -
ecs_no_events_found_message
filterapply_filters( 'ecs_no_events_found_message', sprintf( _x( wp_kses_post( $atts['message'] ), 'A message to indicate there are no upcoming events.', 'the-events-calendar' ), tribe_get_event_label_plural_lowercase() ), $atts ); -
ecs_shortcode_atts
filterapply_filters( 'ecs_shortcode_atts', [ 'cat' => '', 'month' => '', 'limit' => 5, 'eventdetails' => 'true', 'time' => null, 'past' => null, 'venue' => 'false', 'author' => null, 'schema' => 'true', 'message' => 'There are no upcoming %1$s.', 'key' => 'End Date', 'order' => 'ASC', 'orderby' => 'startdate', 'viewall' => 'false', 'excerpt' => 'false', 'thumb' => 'false', 'thumbsize' => '', 'thumbwidth' => '', 'thumbheight' => '', 'con... ); -
ecs_single_event_output
filterapply_filters( 'ecs_single_event_output', $event_output, $atts, $post, $post_index, $posts, $content ); -
ecs_skip_event
filterapply_filters( 'ecs_skip_event', false, $atts, $post ); -
ecs_start_tag
filterapply_filters( 'ecs_start_tag', '<ul class="ecs-event-list">', $atts, count( (array) $posts ), $content ); -
ecs_view_all_events_tag_end
filterapply_filters( 'ecs_view_all_events_tag_end', '</span></div>' ); -
apply_filters( 'ecs_view_all_events_tag_start', '<div class="ecs-view-all-events"><span class="ecs-all-events">', $atts ); -
ecs_view_all_events_text
filterapply_filters( 'ecs_view_all_events_text', sprintf( __( 'View all %s', 'the-events-calendar' ), tribe_get_event_label_plural_lowercase() ), $atts ); -
apply_filters( "wisdom_delay_notification_{$this->plugin_name}", 0 ); -
apply_filters( "wisdom_filter_schedule_{$this->plugin_name}", 'monthly' ); -
apply_filters( "wisdom_form_text_{esc_attr($this->plugin_name)}", $form ); -
apply_filters( "wisdom_is_local_{$this->plugin_name}", $is_local ); -
apply_filters( "wisdom_marketing_text_{esc_attr($this->plugin_name)}", $marketing_text ); -
apply_filters( "wisdom_notice_text_{esc_attr($this->plugin_name)}", $notice_text );
Generated from The Events Calendar Shortcode & Block'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: