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 ) {
	return $content . '<p>最後まで読んでいただきありがとうございました。</p>';
} );

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

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

実行される順番

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

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

迷ったら init に書く、で大きく外しません。

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

フロントだけで動かしたいときは、条件を添えてください。

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

場面別によく使うフック

CSSとJSを足す

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

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

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

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

add_action( 'save_post_post', function ( $post_id, $post, $update ) {
	// 自動保存とリビジョンでは動かさない
	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 );
	}
} );

優先度と引数の数

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

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

「引数がnullになる」の原因は、ほぼこの4つめの書き忘れです。

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

// 他のプラグインが 10 で書き換えたあとに、こちらで上書きする
add_action( 'wp_enqueue_scripts', 'my_override', 99 );

フックを探すときは

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

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

自作のフックを作るときは do_action() を置くだけです。

// 自分のテーマやプラグインの中に置く
do_action( 'my_theme_before_footer', $args );

// 使う側
add_action( 'my_theme_before_footer', function ( $args ) {
	echo '<p>フッターの直前です</p>';
} );

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

あわせて読みたい

SWELL│最新版！アクションフック・フィルターフック79個全まとめ SWELLでカスタマイズをするときに欠かせないのがアクションフックとフィルターフックです。 開発者が事前に、指定箇所が変更ができるようにフックをたくさん仕込んでお…

あわせて読みたい

Arkhe│最新版！アクションフック・フィルターフック119個全まとめ WordPressテーマ「SWELL」と同じ制作者で作られたサイト制作に適したArkhe（アルケー）というテーマがあります。 たとえばWooCommerceを使ったECサイトを作る場合、SWEL…

あわせて読みたい

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

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

あわせて読みたい

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

まとめ

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

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

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

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

あわせて読みたい

WordPressの使い方まとめ｜カスタマイズ・エラー対応・高速化 WordPressの運用でつまずきやすい場面を、目的別にまとめました。 テーマを問わず使える内容です。 SWELL固有のカスタマイズは別にまとめています。 閲覧数の多い順に表…