has_action()WP 2.5.0

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

Работает на основе: has_filter()
1 раз — 0.000016 сек (очень быстро) | 50000 раз — 0.03 сек (скорость света)

Хуков нет.

Возвращает

true|false|int.

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

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

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

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

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

$has = has_action( $tag, $function_to_check );
$tag(строка) (обязательный)
Название хука (действия) наличие функций у которого нужно проверить.
$function_to_check(строка/колбэк)
Название функции, которую нужно проверить, что она прикреплена к хуку указанному в первом параметре.
По умолчанию: false

Примеры

0

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

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

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

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

Заметки

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

С версии 2.5.0 Введена.

Код has_action() WP 6.1.1

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