has_action() WP 2.5

Проверяет была ли зарегистрирована функция для хука-события.

Хуков нет.

Возвращает

true|false|int. Когда проверяемая функция указана:

• Число (приоритет) — если функция для проверки найдена у хука.
• true — если указанная функция прикреплена к указанному хуку.
• false — Если указанная функция не прикреплена к хуку.

Когда проверяемая функция не указана:

• true — если у хука есть хоть одна прикрепленная функция.
• false — Если у хука нет ни одной прикрепленной функции.

Использование

$has = has_action( $tag, $function_to_check );

$tag(строка) (обязательный)

Название хука (действия) наличие функций у которого нужно проверить.
По умолчанию: нет

$function_to_check(строка/колбэк)

Название функции, которую нужно проверить, что она прикреплена к хуку указанному в первом параметре.
По умолчанию: false

Примеры

#1. Проверим есть ли хуки у события init:

if( has_action('init') ){
	echo "У действия init есть хотя бы одна прикрепленная функция.";
}

#2. Проверим наличие конкретной функции у события init:

if( $priority = has_action('init', 'my_function') ){
	echo "У хука init есть функция my_function с приоритетом $priority";
}

Заметки

• Смотрите: has_filter() has_action() is an alias of has_filter().

Список изменений

Код has_action() has action ^{WP 5.8.3}

function has_action( $hook_name, $callback = false ) {
	return has_filter( $hook_name, $callback );
}

Cвязанные функции

События (хуки)

Хуки: события, фильтры