has_action( string $hook_name, callable|string|array|false $callback = false ): bool|int
Checks if any action has been registered for a hook.
Contents
Description
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.
See also
- has_filter() : This function is an alias of has_filter() .
Parameters
-
$hook_name
string Required -
The name of the action hook.
-
$callback
callable|string|array|false Optional -
The callback to check for.
This function can be called unconditionally to speculatively check a callback that may or may not exist.Default:
false
Return
bool|int If $callback
is omitted, returns boolean for whether the hook has anything registered. When checking a specific function, the priority of that hook is returned, or false if the function is not attached.
More Information
Since this action is an alias of has_filter() , it also uses the global array $wp_filter that stores all of the filters / actions.
Source
File: wp-includes/plugin.php
.
View all references
function has_action( $hook_name, $callback = false ) {
return has_filter( $hook_name, $callback );
}
Changelog
Version | Description |
---|---|
2.5.0 | Introduced. |