2020-05-01 / 4208阅 / 悠然
Fires functions attached to a deprecated filter hook.
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' );
Top ↑
(string)
(Required)
The name of the filter hook.
(array)
(Required)
Array of additional function arguments to be passed to apply_filters().
(string)
(Required)
The version of WordPress that deprecated the hook.
(string)
(Optional)
The hook that should have been used.
Default value: null
(string)
(Optional)
A message regarding the change.
Default value: null