|
这篇承接上一篇:wordpress钩子,说说什么是过滤器,过滤器英文:Filters ,就是过滤的意思。 过滤器也叫过滤器钩子,它和动作钩子一样,基本的也有两个函数,动作钩子有do_action它有apply_filters函数,也是创建并执行一个过滤器函数,不同的是动作钩子仅仅是执行一些函数,而过滤器它要做的是改变对象或变量的值,就相当于把对象或变量过滤,然后返回。 apply_filters()是如何工作的呢:
?php
apply_filters($tag,$value);
//$tag必需、你想创建的过滤器的名称
//$value必需,挂在这个过滤器可以修改的值(参数)
//这两个参数是必须的,后面还可以带参数可道官网查看
?
同理动作钩子有个函数是add_action,过滤器钩子也有个函数add_filters。这两个函数的用法就一样了:
?php
add_filter($tag,$function_to_add,$priority,$accepted_args);
//$tag必需,钩子名
//$function必需,调用的函数
//优先级
//接受参数数量,默认1
//需要注意的是,用add_filter添加的过滤器必须要有个返回值
?
要注意的是,前面说了过滤器是要改变对象或变量的值,所以add_filter添加的过滤器必须要有个返回值,也就是函数$function_to_add必需有返回值。 实例:在默认主题的header.php里面的title/title标签内有个函数wp_title();这个函数的定义和wp_head()一样在wp-includes/general-template.php文件中,位于528行,从529行到607行之间的内容一直通过各种if语句来判断定义变量$title的值,关键是609行:
$title=apply_filters('wp_title',$title,$sep,$seplocation);//这里创建过滤器并执行过滤器wp_title,要改变的变量就是$title了,这就是前面弄了一大篇来定义$title变量,到后面给个过滤器给你,让你可以改变$title的值
//这就是过滤器的作用了
应用实例,改变$title:
?php
add_filter('wp_title','ash_titlename');
//添加过滤器wp_title,或者说把函数ash_titlename挂在过滤器钩子wp_title上
//定义函数
functionash_titlename($title){
//把$title的值改成苦太狼
$title='苦太狼';
return$title;
//一定要记得返回值
}
?
上面这些代码让把wp_title()函数的返回值$title的值为苦太狼,调用wp_title()函数得到的输出就是苦太狼了,不管在什么页面了,把它添加到主题的function.php中,你就能看到效果了(如果你的主题使用了wp_title函数)。 通过这个实例,应该明白什么是过滤器了。 在官网中搜索,过滤器相关的函数还有 has_filter() current_filter() merge_filters() remove_filter() remove_all_filters()...
文章来自苦太狼博客 |
|