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

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

has_filter() は、指定したフィルターフックにコールバックが登録されているかを調べる関数です。

2026.10.03

説明

has_filter() は、指定したフィルターフックにコールバックが登録されているかを調べる関数です。

has_filter( string $hook_name, callable|string|array|false $callback = false ): bool|int

未指定時は登録の有無（bool）、指定時は優先度（int）か false。

if ( false !== has_filter( 'the_content', 'wpautop' ) ) {
	// wpautop が有効
}

$callback を指定したとき、戻り値は、優先度（整数）。優先度が 0 のとき、if ( has_filter( ... ) ) は、偽になる。false !== で比べる。
登録前に呼び、false になる。

NG例

if ( has_filter( 'the_content', 'my_func' ) ) { // 優先度が 0 だと、偽になる
	// ...
}

OK例

if ( false !== has_filter( 'the_content', 'my_func' ) ) {
	// 登録されている
}