アクションフック

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

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

(post_type) — event、calendar、team、table、player、list、staff、directory、sponsor
(tab) — general、events、teams、players、staff、branding、league-menu、sponsors、text、configure
(option_type) — checkbox、textarea、text、email、number、select、color、password、radio、multiselect

ライフサイクルアクション

プラグインの初期化とページ読み込み時にトリガーされるアクション：

フック	発火タイミング
`sportspress_pro_loaded`	Pro プラグインのブートストラップ後（Pro のみ）
`before_sportspress_init`	ローカライゼーション、フォーマット、文字列オプションが読み込まれる前
`sportspress_init`	SportsPress コアの初期化後
`sportspress_loaded`	コア機能が読み込まれた後
`sportspress_widgets`	コアウィジェットが登録された後
`sportspress_register_taxonomy`	コアタクソノミーが登録される前
`sportspress_after_register_taxonomy`	コアタクソノミーが登録された後
`sportspress_register_post_type`	コア投稿タイプが登録される前
`sportspress_after_register_post_type`	コア投稿タイプが登録された後
`sportspress_updated`	プラグインが新しいバージョンに更新された後

管理アクション

WordPress 管理画面でトリガーされるアクション：

フック	発火タイミング
`sportspress_admin_css`	管理スタイルのエンキュー後
`sportspress_include_post_type_handlers`	管理投稿タイプハンドラークラスが読み込まれた後

設定アクション

SportsPress 設定ページで実行されるアクション：

フック	発火タイミング
`sportspress_settings_start`	設定が表示される前
`sportspress_settings_save_(tab)`	特定の設定タブの保存中
`sportspress_update_options_(tab)`	特定の設定タブの保存後
`sportspress_update_options`	いずれかのタブが保存された後
`sportspress_settings_saved`	設定が保存された後（保存ごとに 1 回発火）
`sportspress_settings_(tab)`	特定の設定タブの表示中
`sportspress_settings_(tab)_end`	設定タブセクションのメインコンテンツの後
`sportspress_settings_(tab)_after`	設定タブセクションが完全にレンダリングされた後
`sportspress_admin_field_(option_type)`	指定されたタイプの入力フィールドの表示中
`sportspress_update_option_(option_type)`	指定されたタイプのオプションの更新中
`sportspress_update_option`	いずれかのオプションの更新中

テンプレートアクション

フロントエンドのテンプレート読み込み中にトリガーされるアクション：

フック	発火タイミング
`sportspress_before_template`	テンプレートファイルが読み込まれる前（現在）
`sportspress_after_template`	テンプレートファイルが読み込まれた後（現在）
`sportspress_before_template_part`	テンプレートが読み込まれる前（非推奨エイリアス）
`sportspress_after_template_part`	テンプレートが読み込まれた後（非推奨エイリアス）
`sportspress_before_single_(post_type)`	投稿タイプのコンテンツが表示される前
`sportspress_single_(post_type)_content`	投稿タイプのコンテンツの出力中
`sportspress_after_single_(post_type)`	投稿タイプのコンテンツが読み込まれた後

ショートコード / AJAX アクション

ショートコードビルダーインターフェースでトリガーされるアクション：

フック	発火タイミング
`sportspress_ajax_shortcode_form`	エディターモーダルでショートコードフォームをレンダリング中
`sportspress_ajax_scripts_before_shortcode`	AJAX コンテキストでショートコードスクリプトが出力される前

ウェルカムページアクション

フック	発火タイミング
`sportspress_before_welcome_features`	ウェルカムページの機能リストがレンダリングされる前
`sportspress_after_welcome_features`	ウェルカムページの機能リストがレンダリングされた後

モジュールアクション

フック	発火タイミング
`sportspress_modules_sidebar`	モジュールページのサイドバー領域内
`sportspress_modules_after_sidebar`	モジュールページのサイドバー領域の後

使用例

// SportsPress コアが完全に読み込まれた後にコードを実行
add_action( 'sportspress_loaded', function() {
    // ここにコードを記述
});// 選手プロフィールの後にカスタムコンテンツを追加
add_action( 'sportspress_after_single_player', function() {
    echo '<p>Custom content below player profile.</p>';
});// 試合設定タブの保存後にコードを実行
add_action( 'sportspress_update_options_events', function() {
    // 試合設定が保存されたことへの対応
});