add_action() の使い方｜説明・引数・注意点

フック（アクション・フィルター）

add_action() は、指定したアクションフックに、実行したい関数（コールバック）を登録する関数です。WordPressの処理の途中に独自の処理を差し込むときの基本になります。

2026.10.03

説明

add_action() は、指定したアクションフックに、実行したい関数（コールバック）を登録する関数です。WordPressの処理の途中に独自の処理を差し込むときの基本になります。

add_action( string $hook_name, callable $callback, int $priority = 10, int $accepted_args = 1 ): true

常に true を返します。

function my_add_meta() {
	echo '<meta name="robots" content="noindex">';
}
add_action( 'wp_head', 'my_add_meta' );

フックが複数の引数を渡すのに、第4引数（受け取る引数の数）を指定していない。既定は1つのため、コールバックが2つ以上の引数を必須として宣言していると、PHP 7.1以降は致命的エラー（ArgumentCountError）になります。
フック名のスペルミス。エラーは出ず、ただ実行されないだけなので、気づきにくい不具合になります。
アクションのコールバックで、戻り値を返そうとしている。アクションの戻り値は使われません。値を加工して返したいときは add_filter() を使います。
関数名が、他のプラグインやテーマと重複している。致命的エラーになるため、接頭辞を付けるか、無名関数を使います（ただし、無名関数は後から remove_action() で外しにくくなります）。

NG例

add_action( 'save_post', 'my_save' );
function my_save( $post_id, $post, $update ) {
	// 引数が足りず、エラーになる（PHP 7.1以降）
}

OK例

add_action( 'save_post', 'my_save', 10, 3 );
function my_save( $post_id, $post, $update ) {
	// 3つの引数を受け取れる
}