這篇文章主要介紹了WordPress中創建和添加過濾器的相關PHP函數,分別是apply_filters()函數和add_filter()函數的使用,需要的朋友可以參考下

apply_filters()（創建過濾器）

apply_filters() 函數用來創建一個過濾器，大多數被用在函數中，是 WordPress 插件機制中非常重要的一個函數，能讓其它的主題和插件對一個值進行修改過濾。

用法

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

參數

$tag

（字符串）（必須）過濾器的名字。

默認值：None

$value

（混合）（必須）要過濾的值，如果沒人過濾則直接返回這個值。

$var

（混合） （可選）傳給過濾函數額外的變量參數，輔助過濾函數對返回值進行操作，可以添加無限個。

返回值

（混合）過濾后的值，如果沒人過濾則直接返回 $value 的值。

例子

沒人過濾：

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

打印結果：

可以被修改的值

有人過濾：

1. function test_func(){ 
2.   return '修改值'; 
3. } 
4. add_filter( 'test', 'test_func' ); 
5. echo apply_filters( 'test', '可以被修改的值' ); 

打印結果：

修改值

接收參數：

1. function test_func(){ 
2.   return '修改值'; 
3. } 
4. add_filter( 'test', 'test_func' ); 
5. function test_func2( $text ){ 
6.   return $text . '2'; 
7. } 
8. add_filter( 'test', 'test_func2' ); 
9. echo apply_filters( 'test', '可以被修改的值' ); 

多個參數：

1. function test_func( $text, $var, $var2 ){ 
2.   return '修改值' . $var1 . $var2; 
3. } 
4. add_action( 'test', 'test_func', 10, 3 ); 
5. 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

例子

1. function test_func( $text, $var1, $var2 ){ 
2.   return $text . $var1 . $var2; 
3. } 
4. add_action( 'test', 'test_func', 10, 3 ); 
5. echo apply_filters( 'test', '參數2', '參數3', '參數4' ); 

打?。?/p>

test參數2參數3

其它

該函數位于：wp-includes/plugin.php