Hooks de filtro

Hooks de filtro disponibles en SportsPress. Estos hooks usan la función apply_filters() de WordPress y están confirmados en el código fuente del plugin.

Variables usadas en los nombres de hooks:

(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	Descripción
`sportspress_enqueue_styles`	Añade entradas de hojas de estilo a la lista de registro principal del frontend
`sportspress_(post_type)_content_priority`	Cambia la prioridad de inyección de plantillas para un tipo de entrada específico (predeterminado: 10)
`sportspress_get_template_part`	Filtra las partes de plantilla mientras se localizan y cargan
`sportspress_locate_template`	Filtra la ruta de plantilla resuelta antes de mostrarla
`sportspress_shortcode_wrapper`	Filtra el elemento envolvente alrededor de la salida del shortcode

Filtros de preajustes y datos

Hook	Descripción
`sportspress_get_presets`	Filtra los preajustes de deporte disponibles en el desplegable de ajustes
`sportspress_countries`	Filtra las opciones de país disponibles en los selectores de nacionalidad
`sportspress_continents`	Filtra los agrupamientos de continentes en los selectores de países
`sportspress_formats`	Filtra las opciones de formato del tipo de entrada
`sportspress_statuses`	Filtra las opciones de estado en los desplegables
`sportspress_dates`	Filtra las opciones de rango de fechas en los desplegables
`sportspress_date_format`	Filtra las opciones de formato de fecha en los desplegables
`sportspress_time_format`	Filtra las opciones de formato de hora en los desplegables
`sportspress_permalink_slugs`	Filtra los slugs de permalink generados por SportsPress
`sportspress_(taxonomy)_object_types`	Filtra los tipos de entrada asociados con una taxonomía específica
`sportspress_register_post_type_(post_type)`	Filtra los argumentos usados al registrar un tipo de entrada

Filtros condicionales

Hook	Descripción
`is_sportspress`	Booleano que identifica si la página actual es un tipo de entrada de SportsPress
`sportspress_post_types`	Array de todos los slugs de tipos de entrada de SportsPress
`sportspress_primary_post_types`	Array de los tipos de entrada principales de SP (`event`, `team`, `player`, `staff`)
`sportspress_secondary_post_types`	Array de los tipos de entrada secundarios de SP (calendarios, tablas, listas, etc.)
`sportspress_importable_post_types`	Array de tipos de entrada que admiten importación CSV
`sportspress_config_types`	Array que identifica los tipos de entrada de configuración de SportsPress
`sportspress_taxonomies`	Array de todos los slugs de taxonomías de SportsPress

Filtros de ajustes

Hook	Descripción
`sportspress_settings_tabs_array`	Filtra el array de pestañas de ajustes
`sportspress_get_settings_pages`	Filtra las páginas de ajustes antes de añadir las pestañas principales
`sportspress_get_settings_config_pages`	Filtra las páginas de ajustes después de añadir las pestañas principales
`sportspress_(tab)_settings`	Filtra las opciones mostradas en una pestaña de ajustes específica
`sportspress_(post_type)_admin_columns`	Filtra las columnas mostradas en la vista de lista de administración de un tipo de entrada

Filtros de registro de plantillas

Estos filtros se usan para registrar plantillas adicionales y secciones de ajustes:

Hook	Descripción
`sportspress_(post_type)_templates`	Registra secciones de plantilla adicionales para un tipo de entrada
`sportspress_event_templates`	Registra nuevas secciones en las páginas de eventos (usado por los módulos Pro)
`sportspress_event_settings`	Inyecta filas adicionales en la pestaña de ajustes de Eventos
`sportspress_team_settings`	Inyecta filas adicionales en la pestaña de ajustes de Equipos
`sportspress_player_settings`	Inyecta filas adicionales en la pestaña de ajustes de Jugadores
`sportspress_staff_settings`	Inyecta filas adicionales en la pestaña de ajustes de Personal
`sportspress_text`	Añade entradas a la pestaña de ajustes de Texto
`sportspress_feeds`	Filtra los tipos de feed de calendario disponibles

Filtros de datos

Hook	Descripción
`sportspress_player_list_args`	Filtra los argumentos de consulta usados para obtener jugadores de una lista
`sportspress_player_list_players`	Filtra el array de jugadores devuelto para una lista de jugadores
`sportspress_player_data_event_args`	Filtra los argumentos de consulta de eventos al obtener datos del jugador
`sportspress_player_data_season_ids`	Filtra los IDs de temporada usados para segmentar las estadísticas del jugador
`sportspress_player_performance_add_value`	Filtra un valor de rendimiento antes de sumarse al total
`sportspress_player_performance_table_placeholder`	Filtra los valores de marcador de posición en las tablas de rendimiento
`sportspress_player_performance_table_placeholders`	Filtra el conjunto completo de marcadores de posición de totales de carrera
`sportspress_team_data_event_args`	Filtra los argumentos de consulta de eventos al obtener datos del equipo
`sportspress_event_performance_icons`	Filtra la salida de iconos para una columna de rendimiento de jugador
`sportspress_competitive_event_formats`	Filtra los formatos de evento que cuentan como competitivos (predeterminado: `array( 'league' )`)

Ejemplos de uso

// Añadir una hoja de estilos personalizada a la lista de registro de 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 el contenido del equipo para renderizarse más tarde en the_content
add_filter( 'sportspress_team_content_priority', function( $priority ) {
    return 20;
});// Añadir un preajuste de deporte personalizado
add_filter( 'sportspress_get_presets', function( $presets ) {
    $presets['my-sport'] = array(
        'name' => 'My Sport',
        // ... datos del preajuste
    );
    return $presets;
});// Añadir una fila personalizada a la pestaña de ajustes de Eventos
add_filter( 'sportspress_event_settings', function( $settings ) {
    $settings[] = array(
        'title'   => __( 'Mi opción personalizada', 'my-plugin' ),
        'id'      => 'sp_my_custom_option',
        'type'    => 'checkbox',
        'default' => 'yes',
    );
    return $settings;
});

Última actualización: abril de 2026