has_action() WordPress Function

The has_action() function is used to check if a certain action has already been added to the current filter.

has_action( string $hook_name, callable|string|array|false $callback = false ) #

Checks if any action has been registered for a hook.


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.

Top ↑

See also


Top ↑

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 value: false


Top ↑

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.


Top ↑

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.


Top ↑

Source

File: wp-includes/plugin.php

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


Top ↑

Changelog

Changelog
VersionDescription
2.5.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.