WordPress过滤器(Filters):apply_filters和add_filter(转)写的太牛了
来源:互联网 发布:曼朗网络 编辑:程序博客网 时间:2024/06/07 08:54
过滤器(Filters)对于WordPress来说是非常重要的,它极大地扩展了WordPress的定制能力,提高了WordPress的灵活性。无论是制作主题还是开发插件,我们基本上都会或多或少地使用到过滤器,以实现我们的一些特殊需求。
其实,WordPress过滤器的使用非常简单,我们经常用到的也就两个函数而已,它们就是apply_filters和add_filter。本文将对WordPress过滤器进行详细解读与分析。
什么是过滤器?
下面就来说说什么是过滤器(Filters),过滤器就是注册到过滤器钩子(Filter Hook)的函数,过滤器钩子都有一个名字,在WordPress中,一般使用变量$tag来标识这个名字。所有挂接到过滤器钩子上的函数都是过滤器。
过滤器钩子和动作钩子一样,基本的函数有两个,动作钩子有do_action函数,它就有apply_filters函数,该函数是用于执行相应的过滤器函数,不同的是动作钩子仅仅是执行函数(或者称为动作,更为贴切),而过滤器钩子它要做的是通过执行过滤器函数来改变对象或变量的值,就相当于对变量或者对象进行过滤,然后再返回。
过滤器钩子相关函数:
简单地说,动作钩子要的是过程(仅仅执行代码块)而不是结果(输出值/返回值),过滤器钩子要的是结果而不是过程。apply_filters()函数的用法:
<?php
apply_filters( $tag, $value, $var ... );
//$tag 必需,过滤器钩子的名称
//$value 必需,可以被过滤器函数修改的值
//$var 可选,若干个可以传递给过滤器函数的参数
?>
同理,动作钩子有个函数是add_action,相应地,过滤器钩子也有个函数是add_filter。这两个函数的用法就完全一样了,实质上,add_action就是直接调用add_filter来实现的。add_filter函数的用法:
<?php
add_filter( $tag, $function_to_add, $priority, $accepted_args );
//$tag 必需,过滤器钩子的名称
//$function_to_add 必需,要添加的过滤器函数
//$priority 可选,过滤器函数的优先级,默认值为10
//$accepted_args 可选,过滤器函数接受的参数数量,默认值为1
?>
要注意的是,我们在前面说过,过滤器(过滤器函数)的任务是要改变对象或变量的值,所以通过add_filter函数添加的过滤器必须要有个返回值,也就是函数$function_to_add必需有返回值。
过滤器应用实例:
我们以wp_title()函数为例,为大家讲一下过滤器的实际用法,这个函数的定义在wp-includes/general-template.php文件中。在该函数的定义中,调用了apply_filters函数来执行相应的过滤器函数。代码如下:
$title = apply_filters('wp_title', $title, $sep, $seplocation);
//这里会执行过滤器函数,对变量$title进行过滤
//正因为这行代码的存在,你可以把你的过滤器函数添加进来,实现对$title的定制
那么,我们可以在该过滤器钩子(wp_title)上添加一个过滤器来改变$title的值。代码如下:
<?php
add_filter('wp_title', 'mytitle');
//把函数mytitle挂接到过滤器钩子wp_title上
//定义过滤器函数mytitle
function mytitle($title) {
$title = 'This is a demo.';
return $title;
}
?>
上面这些代码就会把wp_title()函数的返回值$title改为“This is a demo.”,调用wp_title()函数得到的输出就是“This is a demo.”了,不管在什么页面调用都是如此。把这段代码添加到主题的functions.php文件中,你就能看到效果了(如果你的主题使用了wp_title函数)。
通过本文的介绍,相信大家都明白了什么是过滤器以及过滤器的用法。
参考手册:
http://codex.wordpress.org/Function_Reference/apply_filters
http://codex.wordpress.org/Function_Reference/add_filter
http://codex.wordpress.org/Plugin_API
- WordPress过滤器(Filters):apply_filters和add_filter(转)写的太牛了
- WordPress过滤器(Filters):apply_filters和add_filter
- WordPress过滤器(Filters):apply_filters和add_filter
- wordpress 过滤器钩子add_filter作用 和 例子
- 转一篇我朋友的实习日志---和我一个实习公司!!!写的太精辟了,太详细了!!!
- Wordpress插件开发2 动作钩子函数add_action与add_filter过滤器
- 过滤器filters
- 过滤器filters
- 哪个天才写的?太精辟了
- wordpress add_filter('show_admin_bar', '__return_false'); //删除最顶部的管理横条
- 【转载】ASP.NET MVC的过滤器【Filters】
- Property-Based Filters 基于属性的过滤器:
- seo整天写文章和发外链是不是太机械了?
- 内核定制编译安装 转别人的,写的太详细了,好吧
- 程序员的情书,写的太经典了
- 【转】VC中BSTR、Char和CString类型的转换(太牛了)
- 因为写的太好了,所以转了,不知道原创是谁,感谢他
- 别人博客写的java文件操作(太全面了-转帖过来)
- java 封装\静态、构造等概念
- 系统信息获取
- Redis Benchmark 性能测试
- java获得当前方法是在哪里被调用的
- 基础知识之进程通信
- WordPress过滤器(Filters):apply_filters和add_filter(转)写的太牛了
- thinkphp 前台自定义标签中如何应对传递过来的ID?
- 反转法总结。。
- Struts到spring mvc的体会
- nginx源码剖析(2)----从main()函数开始
- 傅里叶变换
- Javascript对象相关方法
- 23种设计模式知多少
- myeclipse 在线生成注册码