フィルターフック

SportsPress で利用可能なフィルターフック。これらのフックは WordPress の apply_filters() 関数を使用し、プラグインソースでの存在が確認されています。

全体で使用される変数プレースホルダー：

(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

フロントエンドフィルター

フック	説明
`sportspress_enqueue_styles`	コアフロントエンドエンキューリストにスタイルシートエントリを追加
`sportspress_(post_type)_content_priority`	特定の投稿タイプのテンプレート注入優先度を変更（デフォルト：10）
`sportspress_get_template_part`	テンプレートパーツが検索・読み込まれる際にフィルタリング
`sportspress_locate_template`	表示される前に解決されたテンプレートパスをフィルタリング
`sportspress_shortcode_wrapper`	ショートコード出力を囲むラッパー要素をフィルタリング

プリセットとデータフィルター

フック	説明
`sportspress_get_presets`	設定ドロップダウンで利用可能なスポーツプリセットをフィルタリング
`sportspress_countries`	国籍セレクターで利用可能な国のオプションをフィルタリング
`sportspress_continents`	国セレクターの大陸グループをフィルタリング
`sportspress_formats`	投稿タイプの形式オプションをフィルタリング
`sportspress_statuses`	ドロップダウンのステータスオプションをフィルタリング
`sportspress_dates`	ドロップダウンの日付範囲オプションをフィルタリング
`sportspress_date_format`	ドロップダウンの日付形式オプションをフィルタリング
`sportspress_time_format`	ドロップダウンの時間形式オプションをフィルタリング
`sportspress_permalink_slugs`	SportsPress が生成するパーマリンクスラッグをフィルタリング
`sportspress_(taxonomy)_object_types`	特定のタクソノミーに関連する投稿タイプをフィルタリング
`sportspress_register_post_type_(post_type)`	投稿タイプの登録時に使用される引数をフィルタリング

条件フィルター

フック	説明
`is_sportspress`	現在のページが SportsPress 投稿タイプかどうかを識別するブール値
`sportspress_post_types`	すべての SportsPress 投稿タイプスラッグの配列
`sportspress_primary_post_types`	プライマリ SP 投稿タイプの配列（`event`、`team`、`player`、`staff`）
`sportspress_secondary_post_types`	セカンダリ SP 投稿タイプの配列（カレンダー、テーブル、リストなど）
`sportspress_importable_post_types`	CSV インポートをサポートする投稿タイプの配列
`sportspress_config_types`	SportsPress の設定投稿タイプを識別する配列
`sportspress_taxonomies`	すべての SportsPress タクソノミースラッグの配列

設定フィルター

フック	説明
`sportspress_settings_tabs_array`	設定タブの配列をフィルタリング
`sportspress_get_settings_pages`	コアタブが追加される前に設定ページをフィルタリング
`sportspress_get_settings_config_pages`	コアタブが追加された後に設定ページをフィルタリング
`sportspress_(tab)_settings`	特定の設定タブに表示されるオプションをフィルタリング
`sportspress_(post_type)_admin_columns`	投稿タイプの管理一覧ビューに表示される列をフィルタリング

テンプレート登録フィルター

追加のテンプレートと設定セクションを登録するために使用されるフィルター：

フック	説明
`sportspress_(post_type)_templates`	投稿タイプの追加テンプレートセクションを登録
`sportspress_event_templates`	試合ページに新しいセクションを登録（Pro モジュールで使用）
`sportspress_event_settings`	試合設定タブに追加の行を注入
`sportspress_team_settings`	チーム設定タブに追加の行を注入
`sportspress_player_settings`	選手設定タブに追加の行を注入
`sportspress_staff_settings`	スタッフ設定タブに追加の行を注入
`sportspress_text`	テキスト設定タブにエントリを追加
`sportspress_feeds`	利用可能なカレンダーフィードタイプをフィルタリング

データフィルター

フック	説明
`sportspress_player_list_args`	選手リストの選手を取得するために使用されるクエリ引数をフィルタリング
`sportspress_player_list_players`	選手リストに返される選手の配列をフィルタリング
`sportspress_player_data_event_args`	選手データ取得時の試合クエリ引数をフィルタリング
`sportspress_player_data_season_ids`	選手統計を区切るために使用されるシーズン ID をフィルタリング
`sportspress_player_performance_add_value`	合計に追加される前のパフォーマンス値をフィルタリング
`sportspress_player_performance_table_placeholder`	パフォーマンステーブルのプレースホルダー値をフィルタリング
`sportspress_player_performance_table_placeholders`	通算成績プレースホルダーのフルセットをフィルタリング
`sportspress_team_data_event_args`	チームデータ取得時の試合クエリ引数をフィルタリング
`sportspress_event_performance_icons`	選手パフォーマンス列のアイコン出力をフィルタリング
`sportspress_competitive_event_formats`	コンペティションとしてカウントされる試合形式をフィルタリング（デフォルト：`array( 'league' )`）

使用例

// 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;
});// チームコンテンツを the_content でより遅くレンダリング
add_filter( 'sportspress_team_content_priority', function( $priority ) {
    return 20;
});// カスタムスポーツプリセットを追加
add_filter( 'sportspress_get_presets', function( $presets ) {
    $presets['my-sport'] = array(
        'name' => 'My Sport',
        // ... preset data
    );
    return $presets;
});// 試合設定タブにカスタム行を追加
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;
});

最終更新：2026 年 4 月