apply_filters()创建一个过滤器钩子,调用所有回调方法

目录

描述

译文

调用添加到过滤器hook上的函数。在Plugin API上查看过滤器hook列表。

通过调用该函数,可以调用附着在过滤器hook $tag上的回调函数。用$tag参数所指定的新hook的名称调用该函数,可创建一个新的过滤器hook。

原文

Call the functions added to a filter hook. See the Plugin API for a list of filter hooks.

The callback functions attached to filter hook $tag are invoked by calling this function. This function can be used to create a new filter hook by simply calling this function with the name of the new hook specified using the $tag parameter.

apply_filters() 描述

用法

 <?php apply_filters$tag$value$var ... ); ?> 

apply_filters() 用法

参数

$tag

(string) (必填) The name of the filter hook.

默认值: None

$value

(mixed) (必填) The value which can be modified by filters hooked to $tag

默认值: None

$var

(mixed) (可选) One or more additional variables passed to the filter functions. You can use this parameter in your function but it will not be returned. This parameter is available since Version 1.5.1.

默认值: None

apply_filters() 参数

示例

Echo after Filtering

Get Filtered

Additional Filter Arguments

With the_title filter

$my_custom_title will now contain 'My Custom Title ™', since the_title filter applies wptexturize() and trim(), among others.

apply_filters() 示例

历史

  • 添加于 版本: 0.71

apply_filters() 历史

源文件

apply_filters() 函数的代码位于 wp-includes/plugin.php.

apply_filters() 源文件

相关