WordPressのアクションフック｜実行される順番と、場面別によく使う25個

フックは、WordPressの決まった場面に自分の処理を差し込む仕組みです。

独自プラグインや子テーマに登録すれば、親テーマの更新で追加コードが消えるのを避けられます。

ただし、種類が2,000以上あります。

全部覚える必要はありません。

実際に使うのは20個ほどで、大事なのは「どの順番で走るか」です。

この記事では、実行される順番と、場面別によく使うものをまとめました。

著者

motoki

WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。

WordPressのカスタマイズに困ったらご相談ください！

MOTOKI合同会社

カスタマイズの依頼・相談

アクションフックとフィルターフックの違い

先にここを押さえておくと、迷いません。

「何かをする」ならアクション、「何かを変える」ならフィルターです。

// アクション：処理を走らせるだけ。返さない
add_action( 'wp_enqueue_scripts', function () {
	wp_enqueue_style( 'my-style', get_stylesheet_uri() );
} );

// フィルター：受け取って、変えて、必ず返す
add_filter( 'the_content', function ( $content ) {
	if ( is_admin() || ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) return $content;
	return $content . '<p>最後まで読んでいただきありがとうございました。</p>';
} );

フィルターで return を忘れると、本文がまるごと消えます。

真っ白になったら、まずここを疑ってください。

実行される順番

順番を外すと、動かない・エラーになる、のどちらかです。

代表的なものを、走る順に並べます。

用途に対応するフックを選び、メインクエリに依存する条件分岐をinitで判定しないでください。

ただし init は管理画面でも Ajax でも走ります。

次の例は管理画面のリクエストを除外します。is_admin()がfalseでもREST APIやCLIなどから実行される場合があるため、通常の公開画面だけで処理する条件とは区別してください。表示するページに応じた処理には、メインクエリの確定後に使えるフックを選びます。

add_action( 'init', function () {
	if ( is_admin() ) {
		return;   // 管理画面では何もしない
	}
	// ここにフロント向けの処理
} );

場面別によく使うフック

CSSとJSを足す

enqueue_block_editor_assetsはツールバーやサイドバーなどの編集UI用です。本文のiframe内へブロック用のCSS・JSを読み込む場合は、enqueue_block_assetsやblock.jsonの設定を使います。対象の違いはWordPress公式のエディター資産読込ガイドを参照してください。

wp_head に直接 <style> を書くより、wp_enqueue_scripts を使ってください。

読み込み順とキャッシュをWordPressが面倒を見てくれます。

記事の保存に合わせて動かす

save_post は、そのまま書くと保存のたびに何度も走ります。

add_action( 'save_post_post', function ( $post_id, $post, $update ) {
	// 自動保存は親の下書きIDで保存される場合もある
	if ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) {
		return;
	}
	// 自動保存リビジョンと通常のリビジョンも除外する
	if ( wp_is_post_autosave( $post_id ) || wp_is_post_revision( $post_id ) ) {
		return;
	}
	// 権限の確認も入れる
	if ( ! current_user_can( 'edit_post', $post_id ) ) {
		return;
	}
	// ここに処理
}, 10, 3 );

管理画面をいじる

リダイレクトと表示の分岐

pre_get_posts は名前からフィルターに見えますが、アクションです。

渡されたクエリのオブジェクトを直接書き換えます。

add_action( 'pre_get_posts', function ( $query ) {
	// 管理画面とサブクエリは触らない
	if ( is_admin() || ! $query->is_main_query() ) {
		return;
	}
	if ( $query->is_category() ) {
		$query->set( 'posts_per_page', 20 );
	}
} );

下書きの自動保存は親の記事IDでも起こる

wp_is_post_autosave()は渡されたIDが自動保存リビジョンかを調べます。

本人のロックされていない下書きは、WordPressのwp_autosave()が親の下書きを直接保存するため、この確認だけでは自動保存を除外できません。

保存の例にはDOING_AUTOSAVEの判定も加えています。

WordPress 7.1.2の隔離環境で、wp_autosave()から下書きを保存しても、掲載例の処理位置は実行されないことを確認しました。

通常の投稿作成・更新は各1回、固定ページと権限のないユーザーによる保存では0回であることも確認しています。

実行回数を調べるため、例中の「ここに処理」だけを検証用カウンターへ置き換えました。

この例は処理を置く骨組みです。

フォーム独自の値を保存する場合は、フォームに対応したnonce、入力値の検証、保存先を別途実装します。

REST APIやCLIなどの保存経路すべてを自動保存扱いにする機能ではありません。

WordPress公式のwp_autosave()で保存先の分岐を確認できます。

同じsave_post_postの処理を重複登録しないでください。解除時は追加した登録全体を外します。

優先度と引数の数

add_action() の3つめと4つめが、つまずきどころです。

add_action( 'フック名', '関数名', 優先度, 受け取る引数の数 );

2つ目以降の引数を使う場合は、フックの呼び出し元がその値を渡しているかと、登録時の第4引数の両方を確認してください。

必要な引数の数が合わないと、nullになるとは限らず、引数不足のエラーになる場合もあります。

他のプラグインの処理より後に走らせたいときは、優先度を大きくします。

// 他のプラグインが 10 で書き換えたあとに、こちらで上書きする
add_action( 'wp_enqueue_scripts', function () {
    // 後から実行したい読み込み処理をここに置きます。
}, 99 );

フックを探すときは

全部を覚えるより、探し方を知っておくほうが早いです。

• 公式のリファレンスで名前を引く（developer.wordpress.org/reference/hooks/）
• テーマやプラグインのファイルを do_action で検索する。そこが差し込める場所
• 使っているテーマの一覧記事を見る（下にまとめています）

自作のフックは、処理を先にadd_actionで登録し、実行したい場所でdo_actionを呼び出します。

掲載例は登録側と呼び出し側の2つの置き場所を示しています。

// functions.phpや独自プラグインで先に登録する
add_action( 'my_theme_before_footer', function ( $args ) {
	echo '<p>フッターの直前です</p>';
} );

// 自分が管理するテーマのテンプレートで、フッター直前に呼び出す
$args = array(); // フックで渡すデータ
do_action( 'my_theme_before_footer', $args );

テーマ別のフック一覧は、それぞれまとめています。

あわせて読みたい

SWELLのフック一覧と使い方｜アクション・フィルターの基本 SWELLでカスタマイズをするときに欠かせないのがアクションフックとフィルターフックです。 開発者が事前に、指定箇所が変更ができるようにフックをたくさん仕込んでお…

あわせて読みたい

Arkheのフック一覧と使い方｜ヘッダー7例の実画面付き コード例は必要なものだけを、バックアップした子テーマのfunctions.phpのPHP領域に追加します。親テーマへ直接書き込まず、同じ関数名を重複させないでください。元へ…

あわせて読みたい

Snow Monkey Forms│フック23個全まとめ│アクションフック・フィルターフック Web制作時のお問い合わせフォームはブロックエディタで編集できるSnow Monkey Formsを重宝しています。 そのままでも簡易のお問い合わせフォームとしてはすぐに設置でき…

SWELLでフックを使ってコンテンツを差し込む場所は、こちらです。

あわせて読みたい

SWELL│フックを使ってコンテンツを挿入する場所まとめ SWELLのテーマにはフックがたくさん用意されているのが、良い点です。 他のWordPressテーマでは子テーマでテンプレートを上書きするような場面でも、SWELLならフックに…

登録と呼び出しを置く場所を分ける

掲載例はadd_actionによる登録を先に置き、その後でdo_actionを呼び出します。WordPress 7.1.2の実行環境で「フッターの直前です」の段落が出力されることを確認しました。

実際にフッター直前へ入れるときは、登録部分と呼び出し部分をそれぞれ表の位置へ置き、全体をfunctions.phpへ貼り付けないでください。

SWELLに既存の呼び出しがある場合は、親テーマのテンプレートを編集せず、SWELLのフック一覧から選びます。

pre_get_postsの掲載例では、カテゴリーのメインクエリだけが20件になり、カテゴリーのサブクエリとカテゴリー以外のメインクエリは元の5件のままであることも確認しました。

本文フィルターの例は実Pjaxで2つの投稿へ移動しても追加段落が1回だけ出力され、固定ページには追加されませんでした。

戻すときは登録した処理と自作の呼び出しを一組で取り除き、ほかのフックや本文を残します。

まとめ

• 「何かをする」はアクション、「何かを変える」はフィルター
• フィルターは return を忘れない。忘れると値が消える
• 順番は after_setup_theme → init → template_redirect → wp_enqueue_scripts → wp_head の流れ
• 用途に応じたフックを選ぶ。ただし管理画面でも走るので条件を添える
• save_post は自動保存とリビジョンを除外する
• 引数を2つ以上受け取るなら、4つめの数を必ず書く

この記事は2026年9月16日時点の公式リファレンスで確認しました。

公式の一覧はこちらです。

WordPressのカスタマイズ全体は、こちらにまとめています。

あわせて読みたい

WordPressの使い方まとめ｜カスタマイズ・エラー対応・高速化 WordPressで「作りたいもの」「直したい症状」が決まったら、目的に合う手順から進めるまとめです。まず下の表で入口を選び、詳しく調べたい場合はカテゴリー別の記事一…

この記事で紹介しているコードは、GitHubのMOTOKI-LLC/WAZA-codeにもまとめています。

wp_enqueue_scriptsは通常、wp_headアクションの優先度1に登録された処理から呼ばれるため、wp_head全体より前に独立して完了するわけではありません。

例は子テーマのfunctions.phpまたは独自プラグインへ用途ごとに追加し、戻す場合は追加した登録と関数を取り除きます。

公開への切り替えだけを処理する場合は、transition_post_statusで新状態がpublish、旧状態がpublish以外であることを確認してください。

保存フックの処理が実行される入口を確認する

WordPress 7.1.2の隔離環境で、自分が所有する下書きだけをHTTP更新し、例の「ここに処理」の位置を記録して確認しました。

REST認証用nonceはWordPress側が検証します。

この保存フック例に独自フォームのnonce検証が含まれるわけではありません。

独自フォームから処理する場合は、そのフォームの送信入口でnonceと権限を検証してください。

また、投稿を保存した回数と処理の実行回数は同じとは限りません。

課金や外部通知など重複できない処理を、条件のないsave_postへ置かないでください。