wordpress 功能集成(三):基础知识 -wordpress 过滤器

本贴最后更新于 4281 天前,其中的信息可能已经时过境迁

前一篇文章已经将了wordrpess钩子,过滤器和同样重要,也是插件开发的一个重要接口,过滤器原理跟钩子差不过,只不过功能不一样,“动作钩子”我之前面加个动作,是因为过滤器其实也叫"过滤器钩子"(filter hooks)。动作钩子功能更多的偏向于执行一系列函数,而过滤器的功能是用来在输出一个变量给你一次修改它的机会。

与动作钩子相对应,过滤器基本函数也有两个:apply_filters()\add_filter,这些个函数都位于wp-include/plugin.php文件中。

  1. <?php      
  2.     apply_filters($tag,$value);      
  3.     //$tag  必需、你想创建的过滤器的名称      
  4.     //$value 必需,挂在这个过滤器可以修改的值(参数)      
  5.     //这两个参数是必须的,后面还可以带参数可道官网查看      
  6. ?>    
  1. <?php      
  2.     add_filter($tag,$function_to_add,$priority,$accepted_args);      
  3.     //$tag 必需,钩子名      
  4.     //$function 必需,调用的函数      
  5.     //优先级      
  6.     //接受参数数量,默认1      
  7.     //需要注意的是,用add_filter添加的过滤器必须要有个返回值      
  8. ?>    

apply_filters()函数也是创建并执行一个过滤器,和动作的参数一样,不过它的两个参数都是必需的,因为过滤器的功能是改变变量的值,所以必需传递一个或多个变量。add_filter()往钩子上面挂函数,这些函数必需有个返回值,如果给你修改个参数,然后改没了那是要报错的。
也就是说一个变量如果提供了修改过滤器,那么在输出之前,你可以通过函数再修改它N次。这个最常见的应用应该是seo插件了,通过过滤器来修改页面的信息。
这里再通过一个简单的实例来说明过滤器,以后的教程中再提供几个实例应用。
好吧,那我们也来修改一下网站的title信息。输出title一般都使用了函数wp_title();这个函数位于wp-includes/general-template.php文件第528行。我们查看函数,前面那一大截都是些判断,用来判断当前是什么页面,当前页面标题是什么。看到609行有代码:

 
  1. $title = apply_filters('wp_title', $title, $sep, $seplocation);  

然后这一句的后面就是判断要不要输出了。这里创建并执行了一个名为wp_title的过滤器,然后传递3个参数,$titile就是标题,$sep就是标题的前面或后面截个字符,比如“|”,$seplocation决定字符$sep(“|”)显示在标题左边还是标题右边。这里apply_filers虽然传递了3个参数,但是注意了,主要的是修改$titile这个变量,后面两个是附加提供的参数,一般让你修改的时候还可以使用那两个参数,虽然他传递了3个参数,但是我们的返回值只能是一个,问?函数能返回3个值吗?

下面往主题functions.php文件中添加下面代码来修改$titile信息

  1. add_filter('wp_title','custom_title',10,3);   
  2. function custom_title($title,$a,$b){   
  3.     if( $b === 'right' ){   
  4.         $title = '阿树工作室'.$a;   
  5.     }else{   
  6.         $title = $b.'阿树工作室';   
  7.     }   
  8.     return $title;   
  9. }  

ok咧。就这样,就成功修改了title值,这一篇可能只有一个实例,也许讲的不够细,如果有地方有疑问,你可以查看前一篇,应为动作钩子和过滤器钩子很多地方都一样。
过滤器钩子也有其它函数,例如:has_filter() current_filter() merge_filters() remove_filter() remove_all_filters()...要想继续深入,还是去官网查看

  • WordPress

    WordPress 是一个使用 PHP 语言开发的博客平台,用户可以在支持 PHP 和 MySQL 数据库的服务器上架设自己的博客。也可以把 WordPress 当作一个内容管理系统(CMS)来使用。WordPress 是一个免费的开源项目,在 GNU 通用公共许可证(GPLv2)下授权发布。

    66 引用 • 114 回帖 • 223 关注

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...

推荐标签 标签

  • TGIF

    Thank God It's Friday! 感谢老天,总算到星期五啦!

    288 引用 • 4485 回帖 • 663 关注
  • AngularJS

    AngularJS 诞生于 2009 年,由 Misko Hevery 等人创建,后为 Google 所收购。是一款优秀的前端 JS 框架,已经被用于 Google 的多款产品当中。AngularJS 有着诸多特性,最为核心的是:MVC、模块化、自动化双向数据绑定、语义化标签、依赖注入等。2.0 版本后已经改名为 Angular。

    12 引用 • 50 回帖 • 483 关注
  • Ant-Design

    Ant Design 是服务于企业级产品的设计体系,基于确定和自然的设计价值观上的模块化解决方案,让设计者和开发者专注于更好的用户体验。

    17 引用 • 23 回帖 • 4 关注
  • 禅道

    禅道是一款国产的开源项目管理软件,她的核心管理思想基于敏捷方法 scrum,内置了产品管理和项目管理,同时又根据国内研发现状补充了测试管理、计划管理、发布管理、文档管理、事务管理等功能,在一个软件中就可以将软件研发中的需求、任务、bug、用例、计划、发布等要素有序的跟踪管理起来,完整地覆盖了项目管理的核心流程。

    5 引用 • 15 回帖 • 101 关注
  • Oracle

    Oracle(甲骨文)公司,全称甲骨文股份有限公司(甲骨文软件系统有限公司),是全球最大的企业级软件公司,总部位于美国加利福尼亚州的红木滩。1989 年正式进入中国市场。2013 年,甲骨文已超越 IBM,成为继 Microsoft 后全球第二大软件公司。

    105 引用 • 127 回帖 • 370 关注
  • 区块链

    区块链是分布式数据存储、点对点传输、共识机制、加密算法等计算机技术的新型应用模式。所谓共识机制是区块链系统中实现不同节点之间建立信任、获取权益的数学算法 。

    91 引用 • 751 回帖 • 1 关注
  • 服务器

    服务器,也称伺服器,是提供计算服务的设备。由于服务器需要响应服务请求,并进行处理,因此一般来说服务器应具备承担服务并且保障服务的能力。

    125 引用 • 588 回帖
  • Ngui

    Ngui 是一个 GUI 的排版显示引擎和跨平台的 GUI 应用程序开发框架,基于
    Node.js / OpenGL。目标是在此基础上开发 GUI 应用程序可拥有开发 WEB 应用般简单与速度同时兼顾 Native 应用程序的性能与体验。

    7 引用 • 9 回帖 • 394 关注
  • VirtualBox

    VirtualBox 是一款开源虚拟机软件,最早由德国 Innotek 公司开发,由 Sun Microsystems 公司出品的软件,使用 Qt 编写,在 Sun 被 Oracle 收购后正式更名成 Oracle VM VirtualBox。

    10 引用 • 2 回帖
  • Bug

    Bug 本意是指臭虫、缺陷、损坏、犯贫、窃听器、小虫等。现在人们把在程序中一些缺陷或问题统称为 bug(漏洞)。

    76 引用 • 1737 回帖 • 1 关注
  • SOHO

    为成为自由职业者在家办公而努力吧!

    7 引用 • 55 回帖 • 5 关注
  • 30Seconds

    📙 前端知识精选集,包含 HTML、CSS、JavaScript、React、Node、安全等方面,每天仅需 30 秒。

    • 精选常见面试题,帮助您准备下一次面试
    • 精选常见交互,帮助您拥有简洁酷炫的站点
    • 精选有用的 React 片段,帮助你获取最佳实践
    • 精选常见代码集,帮助您提高打码效率
    • 整理前端界的最新资讯,邀您一同探索新世界
    488 引用 • 384 回帖
  • sts
    2 引用 • 2 回帖 • 196 关注
  • SEO

    发布对别人有帮助的原创内容是最好的 SEO 方式。

    35 引用 • 200 回帖 • 27 关注
  • 微软

    微软是一家美国跨国科技公司,也是世界 PC 软件开发的先导,由比尔·盖茨与保罗·艾伦创办于 1975 年,公司总部设立在华盛顿州的雷德蒙德(Redmond,邻近西雅图)。以研发、制造、授权和提供广泛的电脑软件服务业务为主。

    8 引用 • 44 回帖
  • 脑图

    脑图又叫思维导图,是表达发散性思维的有效图形思维工具 ,它简单却又很有效,是一种实用性的思维工具。

    30 引用 • 96 回帖 • 1 关注
  • 黑曜石

    黑曜石是一款强大的知识库工具,支持本地 Markdown 文件编辑,支持双向链接和关系图。

    A second brain, for you, forever.

    16 引用 • 130 回帖
  • LaTeX

    LaTeX(音译“拉泰赫”)是一种基于 ΤΕΧ 的排版系统,由美国计算机学家莱斯利·兰伯特(Leslie Lamport)在 20 世纪 80 年代初期开发,利用这种格式,即使使用者没有排版和程序设计的知识也可以充分发挥由 TeX 所提供的强大功能,能在几天,甚至几小时内生成很多具有书籍质量的印刷品。对于生成复杂表格和数学公式,这一点表现得尤为突出。因此它非常适用于生成高印刷质量的科技和数学类文档。

    12 引用 • 54 回帖 • 49 关注
  • 开源

    Open Source, Open Mind, Open Sight, Open Future!

    407 引用 • 3578 回帖 • 1 关注
  • Jenkins

    Jenkins 是一套开源的持续集成工具。它提供了非常丰富的插件,让构建、部署、自动化集成项目变得简单易用。

    53 引用 • 37 回帖 • 3 关注
  • 新人

    让我们欢迎这对新人。哦,不好意思说错了,让我们欢迎这位新人!
    新手上路,请谨慎驾驶!

    52 引用 • 228 回帖
  • Unity

    Unity 是由 Unity Technologies 开发的一个让开发者可以轻松创建诸如 2D、3D 多平台的综合型游戏开发工具,是一个全面整合的专业游戏引擎。

    25 引用 • 7 回帖 • 158 关注
  • CodeMirror
    1 引用 • 2 回帖 • 129 关注
  • Git

    Git 是 Linux Torvalds 为了帮助管理 Linux 内核开发而开发的一个开放源码的版本控制软件。

    209 引用 • 358 回帖
  • PHP

    PHP(Hypertext Preprocessor)是一种开源脚本语言。语法吸收了 C 语言、 Java 和 Perl 的特点,主要适用于 Web 开发领域,据说是世界上最好的编程语言。

    179 引用 • 407 回帖 • 491 关注
  • Chrome

    Chrome 又称 Google 浏览器,是一个由谷歌公司开发的网页浏览器。该浏览器是基于其他开源软件所编写,包括 WebKit,目标是提升稳定性、速度和安全性,并创造出简单且有效率的使用者界面。

    62 引用 • 289 回帖
  • 七牛云

    七牛云是国内领先的企业级公有云服务商,致力于打造以数据为核心的场景化 PaaS 服务。围绕富媒体场景,七牛先后推出了对象存储,融合 CDN 加速,数据通用处理,内容反垃圾服务,以及直播云服务等。

    27 引用 • 225 回帖 • 162 关注