WordPress at a glance
function is not described

apply_filters_deprecated() WP 4.6.0

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', 'wpdocs_new_filter' );
Hooks from the function
Return

Null. Nothing.

Usage

apply_filters_deprecated( $tag, $args, $version, $replacement, $message );
$tag(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)
The hook that should have been used.
Default: false
$message(string)
A message regarding the change.
Default: null

Notes

  • See: _deprecated_hook()

Changelog

Since 4.6.0 Introduced.

Code of apply filters deprecated: wp-includes/plugin.php WP 5.2.2

<?php
function apply_filters_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {
	if ( ! has_filter( $tag ) ) {
		return $args[0];
	}

	_deprecated_hook( $tag, $version, $replacement, $message );

	return apply_filters_ref_array( $tag, $args );
}