> WordPress中文手册 > 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.