伏龙阁资源网

详解WordPress中创建和添加过滤器的相关PHP函数
站长资源 2024/11/27 佚名
2 0

apply_filters()（创建过滤器）
apply_filters() 函数用来创建一个过滤器，大多数被用在函数中，是 WordPress 插件机制中非常重要的一个函数，能让其它的主题和插件对一个值进行修改过滤。

用法

apply_filters( $tag, $value, $var... );

参数

$tag

（字符串）（必须）过滤器的名字。

默认值：None

$value

（混合）（必须）要过滤的值，如果没人过滤则直接返回这个值。

$var

（混合） （可选）传给过滤函数额外的变量参数，辅助过滤函数对返回值进行操作，可以添加无限个。

返回值

（混合）过滤后的值，如果没人过滤则直接返回 $value 的值。

例子

没人过滤：

echo apply_filters( 'test', '可以被修改的值' );

打印结果：

可以被修改的值

有人过滤：

function test_func(){
  return '修改值';
}
add_filter( 'test', 'test_func' );
echo apply_filters( 'test', '可以被修改的值' );

打印结果：

修改值

接收参数：

function test_func(){
  return '修改值';
}
add_filter( 'test', 'test_func' );
function test_func2( $text ){
  return $text . '2';
}
add_filter( 'test', 'test_func2' );
echo apply_filters( 'test', '可以被修改的值' );

多个参数：

function test_func( $text, $var, $var2 ){
  return '修改值' . $var1 . $var2;
}
add_action( 'test', 'test_func', 10, 3 );
echo apply_filters( 'test', '可以被修改的值', '辅助值1', '辅助值2' );

其它

此函数位于：wp-includes/plugin.php

add_filter()（添加过滤器）
add_filter() 可以挂载一个函数到指定的过滤器上。

用法

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

参数

$tag

（字符串）（必须）所挂载的过滤器名字（和目标 apply_filters() 函数的 $tag 属性一样）。

默认值：None

$function_to_add

（回调）（必须）要挂载的回调函数，参考 PHP 回调函数类型文档。

默认值：None

$priority

（整数）（可选）执行顺序，越小函数越先被执行。

默认值：10

$accepted_args

（整数）（可选）回调函数接收的参数数量，设置多个可以接收更多 apply_filters() 函数传进来的参数。

默认值：1

返回值

（布尔）总是 True

例子

function test_func( $text, $var1, $var2 ){
  return $text . $var1 . $var2;
}
add_action( 'test', 'test_func', 10, 3 );
echo apply_filters( 'test', '参数2', '参数3', '参数4' );

打印：

test参数2参数3

其它

该函数位于：wp-includes/plugin.php

广告合作：本站广告合作请联系QQ：858582 申请时备注：广告合作（否则不回）
免责声明：本站资源来自互联网收集,仅供用于学习和交流,请遵循相关法律法规,本站一切资源不代表本站立场,如有侵权、后门、不妥请联系本站删除！
www.wwsws.com 伏龙阁资源网
39,976影音资源
44,792技术资源
21,817软件资源
651,128站长资源

更新日志

友情链接

杰晶网络 DDR爱好者之家 桃源资源网 杰网资源 富贵资源网 南强小屋 铁雪资源网 幽灵资源网 万梅资源网 狼山资源网 白云岛资源网 昆仑资源网 相思资源网 明霞山资源网 内蒙古资源网 黑松山资源网 茶园资源网 饿虎岗资源网 大旗谷资源网 常春岛资源网 岱庙资源网 兴国资源网 快活林资源网 蝙蝠岛资源网 帝王谷资源网 白云城资源网 伏龙阁资源网 清风细雨楼 天枫庄资源网 圆月山庄资源网 无争山庄资源网 神水资源网 移花宫资源网 神剑山庄资源网 无为清净楼资源网 金钱帮资源网 丐帮资源网 华山资源网 极乐门资源网 小李飞刀资源网 凤求凰客栈 风云阁资源网 金狮镖局 鸳鸯亭资源网 千金楼资源网 更多链接