
如何使用Poedit翻译WordPress主题
apply_filters_deprecated ( $hook_name, $args, $version, $replacement = '', $message = '' )
apply_filters_deprecated: 这个函数与apply_filters相似,但它是用来应用已弃用的过滤器。它需要三个参数:第一个是要应用的过滤器的名称,第二个是要过滤的值,第三个是当使用过时的过滤器时显示给开发者的信息。
执行附属于已弃用的过滤器钩子的函数。
当一个过滤器钩子被弃用时,apply_filters()调用被替换为apply_filters_deprecated(),这将触发一个弃用通知,然后触发原始过滤器钩子。
注意:传递给原始apply_filters()调用的值和额外的参数必须作为一个数组在这里传递给`$args`。比如说:
// 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’ );
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 ); }