has_action() WP 2.5
Проверяет была ли зарегистрирована функция для хука-события.
Работает на основе: has_filter()
1 раз — 0.000016 сек (очень быстро) | 50000 раз — 0.03 сек (скорость света)
Хуков нет.
Возвращает
Когда проверяемая функция указана:
- Число (приоритет) — если функция для проверки найдена у хука.
- 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().
Список изменений
С версии 2.5.0 | Введена. |
Код has_action() has action WP 5.6.2
function has_action( $tag, $function_to_check = false ) {
return has_filter( $tag, $function_to_check );
}