wpseek.com
Outil de recherche WordPress pour les développeurs et auteurs de thèmes



apply_filters_deprecated › WordPress Function

Depuis4.6.0
Dépréciéen/a
apply_filters_deprecated ( $hook_name, $args, $version, $replacement = '', $message = '' )
Paramètres: (5)
  • (string) $hook_name The name of the filter hook.
    Requis: Oui
  • (array) $args Array of additional function arguments to be passed to apply_filters().
    Requis: Oui
  • (string) $version The version of WordPress that deprecated the hook.
    Requis: Oui
  • (string) $replacement Optional. The hook that should have been used. Default empty.
    Requis: Non
    Défaut: (vide)
  • (string) $message Optional. A message regarding the change. Default empty.
    Requis: Non
    Défaut: (vide)
Voir:
Retourne:
  • (mixed) The filtered value after all hooked functions are applied to it.
Défini(e) dans:
Codex:

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' );


Source

function apply_filters_deprecated( $hook_name, $args, $version, $replacement = '', $message = '' ) {
	if ( ! has_filter( $hook_name ) ) {
		return $args[0];
	}

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

	return apply_filters_ref_array( $hook_name, $args );
}