将函数或方法挂钩到特定的过滤器操作。

原型

add_filter( string $tag, callable $function_to_add, int $priority = 10, int $accepted_args = 1 )

描述

WordPress提供过滤器挂钩,允许插件在运行时修改各种类型的内部数据。

参数

$tag (string) (Required) 用于挂钩$ function_to_add回调的过滤器的名称。

$function_to_add (callable) (Required) 应用过滤器时要运行的回调。

$priority (int) (Optional)  用于指定与特定操作关联的功能的执行顺序。较低的数字与先前的执行相对应,具有相同优先级的函数按照它们添加到操作的顺序执行。

$accepted_args (int) (Optional)  函数接受的参数数量。

返回值

(true)  

源文件

路径:wp-includes/plugin.php

<?php
...
function add_filter( $tag, $function_to_add, $priority = 10, $accepted_args = 1 ) {
	global $wp_filter;
	if ( ! isset( $wp_filter[ $tag ] ) ) {
		$wp_filter[ $tag ] = new WP_Hook();
	}
	$wp_filter[ $tag ]->add_filter( $tag, $function_to_add, $priority, $accepted_args );
	return true;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/add_filter/