apply_filters_deprecated() wordpress function and usage This text is not used because the data attribute has a value

apply_filters_deprecated() wordpress function and usage

Home / WordPress / WordPress Wiki / apply_filters_deprecated() wordpress function and usage

apply_filters_deprecated( string $hook_name, array $args, string $version, string $replacement = '', string $message = '' )
Fires functions attached to a deprecated filter hook.

Description

When a filter hook is deprecated, the apply_filters() call is replaced with apply_filters_deprecated(), which triggers a deprecation notice and then fires the original filter hook.

Note: the value and extra arguments passed to the original apply_filters() call must be passed here to $args as an array. For example:

// Old filter.
return apply_filters( 'wpdocs_filter', $value, $extra_arg );

// Deprecated.
return apply_filters_deprecated( 'wpdocs_filter', array( $value, $extra_arg ), '4.9.0', 'wpdocs_new_filter' );

See also

  • _deprecated_hook()

Parameters

$hook_name

(string) (Required) The name of the filter hook.

$args

(array) (Required) Array of additional function arguments to be passed to apply_filters().

$version

(string) (Required) The version of WordPress that deprecated the hook.

$replacement

(string) (Optional) The hook that should have been used.

Default value: ”

$message

(string) (Optional) A message regarding the change.

Default value: ”

 

0 0 votes
Article Rating
Subscribe
Notify of
guest
0 Comments
Inline Feedbacks
View all comments