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

説明

基本構文

remove_all_actions( string $hook_name, int|false $priority = false ): true

引数

• $hook_name：フック名
• $priority：指定すると、その優先度の処理だけを削除

戻り値

常に true。

使い方（サンプル）

remove_all_actions( 'wp_head' );

注意点

• 他のプラグインやコアの処理も消えるため、副作用が大きく、基本的には避けます。
• 削除したいものが特定できるなら remove_action() を使います。

実務での使いどころ

• あるアクションに登録された、すべての処理を、外すとき。

よくあるミスと対処

• WordPress本体や、他のプラグインの処理まで、まとめて外してしまう。影響を確認する。
• 登録される前に実行され、効かない。
• 特定の処理だけを外したいのに、使っている。その場合は、remove_action()。

NG例

remove_all_actions( 'wp_head' ); // 本体の出力まで、すべて外れる

OK例

remove_action( 'wp_head', 'wp_generator' ); // 外したい処理だけを指定

使い分け早見表

関連項目

remove_action()、remove_all_filters()

公式リファレンス：remove_all_actions() | Function | WordPress Developer Resources