has_filter() — описание функции WordPress на русском

Сигнатура

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

Описание

При использовании аргумента $callback функция может вернуть нелогическое значение, которое приводится к false (например, 0), поэтому для проверки возвращаемого значения используйте оператор ===.

Оригинал (английский)

When using the $callback argument, this function may return a non-boolean value that evaluates to false (e.g. 0), so use the === operator for testing the return value.

Параметры

$hook_name string обязательный

Имя хука-фильтра.

$callback callable|string|array|false необязательный = false

Функция обратного вызова, которую нужно проверить. Эту функцию можно вызывать безусловно, чтобы предположительно проверить функцию обратного вызова, которая может существовать, а может и нет.

$priority int|false необязательный = false

Конкретный приоритет, на котором проверяется функция обратного вызова.

Возвращаемое значение

bool|int

$callback $callback $priority

Исходный код

wp-includes/plugin.php:286

function has_filter( $hook_name, $callback = false, $priority = false ) {
	global $wp_filter;

	if ( ! isset( $wp_filter[ $hook_name ] ) ) {
		return false;
	}

	return $wp_filter[ $hook_name ]->has_filter( $hook_name, $callback, $priority );
}

История изменений

Версия	Описание
6.9.0	Added the $priority parameter.
2.5.0	Introduced.