Filter Hooks

Filter hooks available in SportsPress. These hooks use WordPress's apply_filters() function and are confirmed present in the plugin source.

Variable placeholders used throughout:

(post_type) — event, calendar, team, table, player, list, staff, directory, sponsor
(taxonomy) — league, season, venue, position, role
(tab) — general, events, teams, players, staff, branding, league-menu, sponsors, text, configure

Frontend Filters

Hook	Description
`sportspress_enqueue_styles`	Add stylesheet entries to the core frontend enqueue list
`sportspress_(post_type)_content_priority`	Change the template injection priority for a specific post type (default: 10)
`sportspress_get_template_part`	Filter template parts as they are being located and loaded
`sportspress_locate_template`	Filter the resolved template path before it is displayed
`sportspress_shortcode_wrapper`	Filter the wrapper element around shortcode output

Preset and Data Filters

Hook	Description
`sportspress_get_presets`	Filter the sports presets available in the settings dropdown
`sportspress_countries`	Filter the country options available in nationality selectors
`sportspress_continents`	Filter the continent groupings in country selectors
`sportspress_formats`	Filter the post type format options
`sportspress_statuses`	Filter the status options in dropdowns
`sportspress_dates`	Filter the date range options in dropdowns
`sportspress_date_format`	Filter the date format options in dropdowns
`sportspress_time_format`	Filter the time format options in dropdowns
`sportspress_permalink_slugs`	Filter the permalink slugs generated by SportsPress
`sportspress_(taxonomy)_object_types`	Filter the post types associated with a specific taxonomy
`sportspress_register_post_type_(post_type)`	Filter the arguments used when registering a post type

Conditional Filters

Hook	Description
`is_sportspress`	Boolean identifying whether current page is a SportsPress post type
`sportspress_post_types`	Array of all SportsPress post type slugs
`sportspress_primary_post_types`	Array of primary SP post types (`event`, `team`, `player`, `staff`)
`sportspress_secondary_post_types`	Array of secondary SP post types (calendars, tables, lists, etc.)
`sportspress_importable_post_types`	Array of post types that support CSV import
`sportspress_config_types`	Array identifying SportsPress configuration post types
`sportspress_taxonomies`	Array of all SportsPress taxonomy slugs

Settings Filters

Hook	Description
`sportspress_settings_tabs_array`	Filter the array of settings tabs
`sportspress_get_settings_pages`	Filter settings pages before core tabs are added
`sportspress_get_settings_config_pages`	Filter settings pages after core tabs are added
`sportspress_(tab)_settings`	Filter options displayed in a specific settings tab
`sportspress_(post_type)_admin_columns`	Filter the columns displayed in admin list view for a post type

Template Registration Filters

These filters are used to register additional templates and settings sections:

Hook	Description
`sportspress_(post_type)_templates`	Register additional template sections for a post type
`sportspress_event_templates`	Register new sections on event pages (used by Pro modules)
`sportspress_event_settings`	Inject additional rows into the Events settings tab
`sportspress_team_settings`	Inject additional rows into the Teams settings tab
`sportspress_player_settings`	Inject additional rows into the Players settings tab
`sportspress_staff_settings`	Inject additional rows into the Staff settings tab
`sportspress_text`	Add entries to the Text settings tab
`sportspress_feeds`	Filter the available calendar feed types

Data Filters

Hook	Description
`sportspress_player_list_args`	Filter the query arguments used to fetch players for a list
`sportspress_player_list_players`	Filter the player array returned for a player list
`sportspress_player_data_event_args`	Filter event query arguments when fetching player data
`sportspress_player_data_season_ids`	Filter the season IDs used to segment player statistics
`sportspress_player_performance_add_value`	Filter a performance value before it is added to the total
`sportspress_player_performance_table_placeholder`	Filter placeholder values in performance tables
`sportspress_player_performance_table_placeholders`	Filter the full set of career total placeholders
`sportspress_team_data_event_args`	Filter event query arguments when fetching team data
`sportspress_event_performance_icons`	Filter the icon output for a player performance column
`sportspress_competitive_event_formats`	Filter which event formats count as competitive (default: `array( 'league' )`)

Usage Examples

// Add a custom stylesheet to the SportsPress enqueue list
add_filter( 'sportspress_enqueue_styles', function( $styles ) {
    $styles['my-sportspress-style'] = array(
        'src'     => get_stylesheet_directory_uri() . '/css/sportspress-custom.css',
        'deps'    => array( 'sportspress-general' ),
        'version' => '1.0.0',
        'media'   => 'all',
    );
    return $styles;
});// Move team content to render later in the_content
add_filter( 'sportspress_team_content_priority', function( $priority ) {
    return 20;
});// Add a custom sport preset
add_filter( 'sportspress_get_presets', function( $presets ) {
    $presets['my-sport'] = array(
        'name' => 'My Sport',
        // ... preset data
    );
    return $presets;
});// Add a custom row to the Events settings tab
add_filter( 'sportspress_event_settings', function( $settings ) {
    $settings[] = array(
        'title'   => __( 'My Custom Option', 'my-plugin' ),
        'id'      => 'sp_my_custom_option',
        'type'    => 'checkbox',
        'default' => 'yes',
    );
    return $settings;
});

Last updated: April 2026

Theme Integration

Action Hooks

Basketball Terminology

Ice Hockey Terminology

Football (Soccer) Terminology