has_action()
Проверяет была ли зарегистрирована функция для хука-события.
Работает на основе: 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
Примеры
#1 Проверим есть ли хуки у события init:
if( has_action('init') ){
echo "У действия init есть хотя бы одна прикрепленная функция.";
}
#2 Проверим наличие конкретной функции у события init:
if( $priority = has_action('init', 'my_function') ){
echo "У хука init есть функция my_function с приоритетом $priority";
}
Заметки
- Смотрите: has_filter() This function is an alias of has_filter().
Список изменений
| С версии 2.5.0 | Введена. |
Код has_action() has action WP 6.8
function has_action( $hook_name, $callback = false ) {
return has_filter( $hook_name, $callback );
}