【函数说明】
调用添加到过滤器hook上的函数。在Plugin API上查看过滤器hook列表。
当执行 apply_filters这个函数时所有添加到该filter hook($tag)上的回调函数将被调用。通过设置新的$tag值可以创建一个新的filter hook。
【函数用法】
<?PHP apply_filters($tag, $value); ?>
【函数参数】
$tag
(字符串)(必需)过滤器hook的名称
默认值:None
$value
(混合)(必需)连接到$tag上的过滤器可能修改的值
默认值:None
【函数实例】
输出返回的结果
echo apply_filters( $tag, $value );
获取返回的结果
$myvar = apply_filters( $tag, $value );
添加额外的过滤器参数
$myvar = apply_filters( $tag, $value, $param, $otherparam );
调用the_title这个过滤器
$my_custom_title = apply_filters('the_title', ' My Custom Title (tm) ');
$my_custom_title 现在的值是 ‘My Custom Title ?’, 因为the_title 这个过滤器(filter)中有wptexturize() andtrim()函数,返回的$my_custom_title即是通过这两个函数处理后的结果。
【返回值】
(混合)所有连接函数都应用到该函数后,返回$value的结果。
注意:返回值的类型应与$value类型一致,如字符串或数组。
【源文件】
apply_filters() 位于 wp-includes/plugin.php.