Filter Hooks

Filter hooks disponíveis no SportsPress. Esses hooks usam a função apply_filters() do WordPress e estão confirmados presentes no código-fonte do plugin.

Marcadores de variáveis usados ao longo do documento:

(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

Filtros de Frontend

Hook	Descrição
`sportspress_enqueue_styles`	Adicionar entradas de stylesheet à lista de enqueue de frontend do núcleo
`sportspress_(post_type)_content_priority`	Alterar a prioridade de injeção de template para um tipo de post específico (padrão: 10)
`sportspress_get_template_part`	Filtrar partes de template conforme são localizadas e carregadas
`sportspress_locate_template`	Filtrar o caminho de template resolvido antes de ser exibido
`sportspress_shortcode_wrapper`	Filtrar o elemento wrapper ao redor da saída do shortcode

Filtros de Preset e Dados

Hook	Descrição
`sportspress_get_presets`	Filtrar os presets de esportes disponíveis no dropdown de configurações
`sportspress_countries`	Filtrar as opções de país disponíveis nos seletores de nacionalidade
`sportspress_continents`	Filtrar os agrupamentos de continente nos seletores de país
`sportspress_formats`	Filtrar as opções de formato de tipo de post
`sportspress_statuses`	Filtrar as opções de status nos dropdowns
`sportspress_dates`	Filtrar as opções de intervalo de datas nos dropdowns
`sportspress_date_format`	Filtrar as opções de formato de data nos dropdowns
`sportspress_time_format`	Filtrar as opções de formato de hora nos dropdowns
`sportspress_permalink_slugs`	Filtrar os slugs de permalink gerados pelo SportsPress
`sportspress_(taxonomy)_object_types`	Filtrar os tipos de post associados a uma taxonomia específica
`sportspress_register_post_type_(post_type)`	Filtrar os argumentos usados ao registrar um tipo de post

Filtros Condicionais

Hook	Descrição
`is_sportspress`	Booleano identificando se a página atual é um tipo de post do SportsPress
`sportspress_post_types`	Array de todos os slugs de tipo de post do SportsPress
`sportspress_primary_post_types`	Array dos tipos de post SP primários (`event`, `team`, `player`, `staff`)
`sportspress_secondary_post_types`	Array dos tipos de post SP secundários (calendários, tabelas, listas, etc.)
`sportspress_importable_post_types`	Array de tipos de post que suportam importação por CSV
`sportspress_config_types`	Array identificando tipos de post de configuração do SportsPress
`sportspress_taxonomies`	Array de todos os slugs de taxonomia do SportsPress

Filtros de Configurações

Hook	Descrição
`sportspress_settings_tabs_array`	Filtrar o array de abas de configurações
`sportspress_get_settings_pages`	Filtrar páginas de configurações antes das abas do núcleo serem adicionadas
`sportspress_get_settings_config_pages`	Filtrar páginas de configurações após as abas do núcleo serem adicionadas
`sportspress_(tab)_settings`	Filtrar opções exibidas em uma aba de configurações específica
`sportspress_(post_type)_admin_columns`	Filtrar as colunas exibidas na visualização de lista de admin para um tipo de post

Filtros de Registro de Templates

Esses filtros são usados para registrar templates adicionais e seções de configurações:

Hook	Descrição
`sportspress_(post_type)_templates`	Registrar seções de template adicionais para um tipo de post
`sportspress_event_templates`	Registrar novas seções em páginas de eventos (usado pelos módulos Pro)
`sportspress_event_settings`	Injetar linhas adicionais na aba de configurações de Eventos
`sportspress_team_settings`	Injetar linhas adicionais na aba de configurações de Times
`sportspress_player_settings`	Injetar linhas adicionais na aba de configurações de Jogadores
`sportspress_staff_settings`	Injetar linhas adicionais na aba de configurações de Equipe
`sportspress_text`	Adicionar entradas à aba de configurações de Texto
`sportspress_feeds`	Filtrar os tipos de feed de calendário disponíveis

Filtros de Dados

Hook	Descrição
`sportspress_player_list_args`	Filtrar os argumentos de consulta usados para buscar jogadores de uma lista
`sportspress_player_list_players`	Filtrar o array de jogadores retornado para uma lista de jogadores
`sportspress_player_data_event_args`	Filtrar argumentos de consulta de evento ao buscar dados de jogador
`sportspress_player_data_season_ids`	Filtrar os IDs de temporada usados para segmentar estatísticas de jogador
`sportspress_player_performance_add_value`	Filtrar um valor de desempenho antes de ser adicionado ao total
`sportspress_player_performance_table_placeholder`	Filtrar valores de placeholder em tabelas de desempenho
`sportspress_player_performance_table_placeholders`	Filtrar o conjunto completo de placeholders de totais de carreira
`sportspress_team_data_event_args`	Filtrar argumentos de consulta de evento ao buscar dados de time
`sportspress_event_performance_icons`	Filtrar a saída de ícones para uma coluna de desempenho de jogador
`sportspress_competitive_event_formats`	Filtrar quais formatos de evento contam como competitivos (padrão: `array( 'league' )`)

Exemplos de Uso

// Adicionar um stylesheet personalizado à lista de enqueue do SportsPress
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;
});// Mover o conteúdo do time para renderizar mais tarde em the_content
add_filter( 'sportspress_team_content_priority', function( $priority ) {
    return 20;
});// Adicionar um preset de esporte personalizado
add_filter( 'sportspress_get_presets', function( $presets ) {
    $presets['my-sport'] = array(
        'name' => 'My Sport',
        // ... dados do preset
    );
    return $presets;
});// Adicionar uma linha personalizada à aba de configurações de Eventos
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;
});

Última atualização: Abril de 2026