WP_Hook::remove_filter( string $tag, callable $function_to_remove, int $priority )
Unhooks a function or method from a specific filter action.
Description Description
Parameters Parameters
- $tag
-
(string) (Required) The filter hook to which the function to be removed is hooked. Used for building the callback ID when SPL is not available.
- $function_to_remove
-
(callable) (Required) The callback to be removed from running when the filter is applied.
- $priority
-
(int) (Required) The exact priority used when adding the original filter callback.
Return Return
(bool) Whether the callback existed before it was removed.
Source Source
File: wp-includes/class-wp-hook.php
public function remove_filter( $tag, $function_to_remove, $priority ) {
$function_key = _wp_filter_build_unique_id( $tag, $function_to_remove, $priority );
$exists = isset( $this->callbacks[ $priority ][ $function_key ] );
if ( $exists ) {
unset( $this->callbacks[ $priority ][ $function_key ] );
if ( ! $this->callbacks[ $priority ] ) {
unset( $this->callbacks[ $priority ] );
if ( $this->nesting_level > 0 ) {
$this->resort_active_iterations();
}
}
}
return $exists;
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 4.7.0 | Introduced. |