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

Description

Parameters

$hook_namestring

The name of the filter hook.

$callbackcallable|string|array|falseoptional

The callback to check for. This function can be called unconditionally to speculatively check a callback that may or may not exist. Default false.Default: false

$priorityint|falseoptional

The specific priority at which to check for the callback. Default false.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. If $callback and $priority are both provided, a boolean is returned for whether the specific function is registered at that priority.

Used by · 27

• Core_Upgrader::upgrade()Upgrades WordPress core.
• WP::build_query_string()Sets the query string property based off of the query variable property.
• WP_Customize_Nav_Menu_Item_Setting::preview()Handle previewing the setting.
• WP_Embed::shortcode()The do_shortcode() callback function.
• WP_MS_Sites_List_Table::column_plugins()Handles the plugins column output.
• WP_MS_Sites_List_Table::get_columns()Gets an array of column titles keyed by their column name.
• WP_Site_Health::check_wp_version_check_exists()Tests whether `wp_version_check` is blocked.
• WP_Site_Health::detect_plugin_theme_auto_update_issues()Checks for potential issues with plugin and theme auto-updates.
• WP_Site_Health_Auto_Updates::test_wp_version_check_attached()Checks if updates are intercepted by a filter.
• WP_Widget_Text::widget()Outputs the content for the current Text widget instance.
• _WP_Editors::editor()Outputs the HTML for a single instance of the editor.
• _restore_wpautop_hook()If do_blocks() needs to remove wpautop() from the `the_content` filter, this re-adds it afterwards, for subsequent `the_content` usage.

Source

View on Trac ↗View on GitHub ↗

286function has_filter( $hook_name, $callback = false, $priority = false ) {287	global $wp_filter;288 289	if ( ! isset( $wp_filter[ $hook_name ] ) ) {290		return false;291	}292 293	return $wp_filter[ $hook_name ]->has_filter( $hook_name, $callback, $priority );294}

History

Introduced in 2.5.0. One change between 6.7.7 and 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/plugin.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.