WordPress 過濾器詳解：掌握50 個實用過濾器及使用技巧

gitbox 2025-06-15

1. 什麼是過濾器

在WordPress 中，過濾器是一種用於修改或過濾網站輸出結果的強大機制。它通過接收一個輸入值，對其進行處理後返回，從而實現對字符串、數字、數組、對像等數據類型的靈活操作。

過濾器可以應用於網站的各個環節，如文章標題、正文內容、元數據等，用戶也能根據需求自定義過濾器以實現特定功能。

2. 過濾器的類型

WordPress 的過濾器主要分為兩類：過濾函數和類方法過濾器。兩者實現方式有所不同，但核心原理一致，都是對數據進行攔截和處理。

2.1 過濾函數

過濾函數通常通過編寫一個簡單函數實現，使用add_filter()將函數掛載到指定過濾器上，再通過apply_filters()傳遞參數完成過濾過程。

 
function my_filter_function( $args ) {
  // 處理或修改 $args
  return $args;
}
add_filter( 'filter_name', 'my_filter_function' );

其中$args是傳入的參數，可能是字符串、數組等，經過自定義函數處理後返回修改後的值。

2.2 類方法過濾器

類方法過濾器通過類中的方法實現過濾功能，代碼組織更加規範，便於復雜項目管理。

 
class My_Filter {
  public function my_filter_method( $args ) {
    // 處理或修改 $args
    return $args;
  }
}
$my_filter = new My_Filter();
add_filter( 'filter_name', array( $my_filter, 'my_filter_method' ) );

3. WordPress 中的常用過濾器

以下是一些常用的過濾器示例及其應用場景，幫助理解過濾器的實用價值。

3.1 過濾頁面標題

wp_title過濾器用於修改頁面標題，比如添加網站名稱或更改標題分隔符。

 
function my_filter_wp_title( $title, $sep ) {
  // 在標題前添加網站名稱
  return get_bloginfo( 'name' ) . $sep . $title;
}
add_filter( 'wp_title', 'my_filter_wp_title', 10, 2 );

函數中的$title是當前頁面標題， $sep是分隔符，利用get_bloginfo()獲取站點名稱進行拼接。

3.2 過濾文章正文

the_content過濾器用於修改文章正文內容，例如插入廣告代碼或自定義HTML。

 
function my_filter_the_content( $content ) {
  // 在文章內容末尾添加廣告代碼
  return $content . '<div class="ad">廣告代碼</div>';
}
add_filter( 'the_content', 'my_filter_the_content' );

這裡$content表示文章內容，函數在末尾追加了廣告HTML代碼。

3.3 過濾文章元數據

get_post_metadata過濾器允許修改文章自定義字段的值，比如根據字段名稱調整輸出內容。

 
function my_filter_get_post_metadata( $value, $post_id, $meta_key ) {
  // 針對特定自定義字段修改其值
  if ( $meta_key == 'my_custom_field' ) {
    return $value . ' (modified)';
  }
  return $value;
}
add_filter( 'get_post_metadata', 'my_filter_get_post_metadata', 10, 3 );

函數根據$meta_key判斷是否需要修改對應字段的值。

4. 總結

WordPress 過濾器是定製網站功能的核心利器，既可以通過簡單函數實現快速過濾，也能通過類方法實現複雜功能。掌握常用過濾器並靈活應用，能夠極大提升網站開發的靈活性和擴展性。