首页>建站相关>Wordpress的过滤器add_filter与apply_filters

Wordpress的过滤器add_filter与apply_filters

对Wordpress的这个filters的概念一直是一知半解(其实半解也算不上,只能算知道有这么个函数),最近遇到了Wordpress的头像问题,无可避免的又遇到过滤器。刚好在CSDN上看到某篇文章写得比较清楚,摘录顺便自己动手尝试一下,以加深一些印象。apply_filters有点儿类似一个卧底,被提前安排打入了黑帮内部,但他并不清楚自己需要做些什么,而add_filter则是他的联络人,出任务的时候,两人约定由add_filter将任务清单(回调函数)放入大众浴室的9527号储物箱内,所以apply_filters参与黑帮团建之前总会先去大众浴室看看储物箱内有没有新任务。

apply_filters()函数的用法

apply_filters(string $tag, mixed $value)

参数

$tag:过滤器的名字,官方为很多用户有需求修改的参数都设置了过滤器,需要修改某个函数的参数,首先要做的是确定其是否预埋了过滤器,该过滤器的正确名称又是什么;

$value:用户想要修改(过滤)的参数值,如果用户没有定义过滤函数则值得返回这个值;

$var:传给过滤函数额外的变量参数,辅助过滤函数对返回值进行操作,可以添加无限个;

返回值:过滤后的值,如果没人过滤则直接返回$value的值。

add_filter()函数的用法

add_filter($tag, $function_to_add, $priority, $accepted_args)

参数

$tag:(必需)所挂载的过滤器名字(和目标apply_filters()函数的$tag属性一样);

$function_to_add:(必需)要挂载的回调函数,参考PHP回调函数类型文档;

$priority:(可选)执行顺序,越小函数越先被执行。默认值:10;

$accepted_args:(可选)回调函数接收的参数数量,设多个可以接收更多apply_filters()函数传进来的参数。默认值:1

返回值:(布尔)总是True。

动手练习

不传递参数

Wordpress_filters_add_filter_and_apply_filters_p1

利用2个空白文件粗暴构建了一个极简的wp主题,在index.php文件里输入如上命令,最后输出结果是“继续伪装”,因为这里的唯一联络人add_filter同志在卧底行动之后才去修改任务,所以错失了良机,所以以上命令应该修改如下,当然实际使用中,我们一般仅需要利用add_filter分配任务,执行顺序是官方考虑的事情。

<?php
function test_function(){
    return '身份已泄露,尽快离开。';
}
add_filter('misson','test_function');

echo apply_filters('misson','继续伪装');
?>

传递参数时

<?php
function test_function($var1,$var2,$var3){
    return '身份已泄露,尽快离开。'.$var1.'很危险,'.'务必不要去'.$var2.$var3.'。';
}
add_filter('misson','test_function',10,3);

echo apply_filters('misson','继续伪装','九龙','码头');
?>

程序输出结果如下:

身份已泄露,尽快离开。继续伪装很危险,务必不要去九龙码头。

上文add_filter最后的3代表本次传递3个参数,包含允许修改值以及2个辅助参数,如果这里不慎修改为了2,您可能会喜提这样一个错误:

Wordpress_filters_add_filter_and_apply_filters_p2

传参的时候用上面的逻辑似乎有点讲不通,恩,可能卧底先在储物箱里放了张纸条:“地区:九龙,地点:码头”,然后在一边旁边若无其事的假装洗澡,一边等联络人查看储物箱,最后才决定下一步行动吧。

标签: wordpress

移动端可扫我直达哦~

推荐阅读

wordpress 2024-03-28

Wordpress中Gravatar头像不显示的解决方案

Wordpress是个老牌的博客软件,版本迭代至今,几乎已经是市占率最高的一款建站工具。一直觉得一款软件,它的用户越多,使用就会越人性化,因为用户的使用水平不同,会遇到不同层次的问题,通过收集与筛选用户反馈,更可以有的放矢的去完善软件...

建站相关 wordpress

wordpress 2023-09-05

关于get_the_post_thumbnail函数

与the_post_thumbnail直接输出不同,get开头的函数,包括但不限于get_the_post_thumbnail,往往会返回一些值。在需要对这些值进行操作,比如转存或修改时,我们需要使用get系的函数。<?php ...

建站相关 wordpress

wordpress 2023-06-19

save_post的可接受参数与add_action语法

想在主页的文章列表中,为每一篇文章配置一张缩略图,之前修改twentyten主题的时候尝试过类似的实现,只是某天一个不小心“rm -rf wordpress”,连主题带所有图片都被删得一干二净。只记得是一个较为复杂的判断语句,先判断有...

建站相关 wordpress

wordpress 2023-06-10

customize自定义项目被保存后的后续处理

在自定义项目中设置了一组幻灯片的数据,本来准备直接在输入完成后对数据进行重组,利用换行符号分割数据,利用“||”符号区分连接与图片地址,在保存设置项时将输入数据直接组装为html语句。实际测试过程中极其不方便,一有更改就需要重新输入源...

建站相关 wordpress

wordpress 2023-05-07

Wordpress添加设置项目后如何修改项目值

使用add_option添加了一部分自定义设置,采用了数组的形式。希望其中部分设置能在保存或者修改文章之后自动获取新数据并更新,所以准备在“save_post”(编辑或发布后)执行一个更新数据的操作。Wordpress的函数命名很规范...

建站相关 wordpress

wordpress 2023-05-07

Wordpress生成标签云的函数wp_tag_cloud

很多站点上都会展现彩色的标签云,从个人浏览经验来看,相对于分类目录,文章标签反而更适合用户快速定位到意向查看的文章。一方面目录分类范围较大,一方面目录一般位于页眉,而标签云往往会被布局于页面底部,下意识的就近原则,也会让标签得到更多的...

建站相关 wordpress

wordpress 2023-04-30

wordpress自定义组件add_setting的回调测试

在后台设置了一个站点logo图片地址的参数,考虑到后期可能更换,有手动输入的需求,所以准备设计成仅输入文件名称,指定文件的文件夹,当用户输入后由系统组装文件夹地址与图片名称,从而得到完整的图片地址。虽然知道add_setting支持回...

建站相关 wordpress

wordpress 2023-04-28

wordpress的后台图标库dashicons

wordpress后台有许多精致的图标,这些图标是由一个名为dashicons的图标库实现的,目前这套图标大约包含300多个icon。即便将之应用于前端,也是绰绰有余。官方的图标总览页面https://developer.wordpr...

建站相关 wordpress