wordpress采用函数:apply_filters()

【函数说明】

调用添加到过滤器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.