wp_query – 小豬日常

WordPress 後台為自訂文章類型新增內容關鍵字搜尋功能

小豬 — Mon, 22 Dec 2025 22:20:38 +0000

前言

在 WordPress 後台管理自訂文章類型（此處為 solution）時，若想快速搜尋文章內容中是否包含特定關鍵字，系統預設的搜尋功能可能無法精準或方便達成此需求。這段程式碼示範如何為 solution 文章類型新增一個後台子選單，提供內容關鍵字搜尋功能，適合需要管理大量文章並快速定位內容的開發者與網站管理員。

新增後台子選單

使用 admin_menu action，先檢查 solution 文章類型是否存在，避免錯誤。接著透過 add_submenu_page 在 solution 列表底下新增「內容關鍵字搜尋」子選單，設定權限為 edit_posts，確保只有具備編輯權限的使用者能操作。

add_action( 'admin_menu', function () {
    if ( ! post_type_exists( 'solution' ) ) {
        return;
    }

    add_submenu_page(
        'edit.php?post_type=solution',
        '內容關鍵字搜尋',
        '內容關鍵字搜尋',
        'edit_posts',
        'solution-content-search',
        'solution_content_search_page_render'
    );
} );

搜尋頁面渲染與表單處理

solution_content_search_page_render 函式負責渲染搜尋表單與結果頁面。首先檢查使用者權限，避免未授權存取。接著判斷是否有表單送出，並使用 WordPress 的 nonce 機制驗證安全性。

關鍵字透過 sanitize_text_field 與 wp_unslash 清理，避免 XSS 與注入風險。

if ( isset( $_POST['solution_content_search_submit'] ) ) {
    check_admin_referer( 'solution_content_search_action', 'solution_content_search_nonce' );

    $keyword  = isset( $_POST['solution_keyword'] ) ? sanitize_text_field( wp_unslash( $_POST['solution_keyword'] ) ) : '';
    $searched = true;

    if ( $keyword !== '' ) {
        // ...
    }
}

透過 WP_Query 及字串比對精確搜尋

WordPress 內建搜尋（s 參數）會搜尋標題、內容等欄位，但可能不夠精準。此處先用 WP_Query 以關鍵字搜尋取得可能相關文章 ID，然後逐篇讀取內容，使用 mb_stripos（若有）或 stripos 做不區分大小寫的字串比對，確保內容確實包含關鍵字。

$query = new WP_Query( array(
    'post_type'      => 'solution',
    'post_status'    => 'any',
    'posts_per_page' => -1,
    's'              => $keyword,
    'fields'         => 'ids',
) );

foreach ( $query->posts as $post_id ) {
    $post = get_post( $post_id );
    if ( ! $post ) {
        continue;
    }

    $content = wp_strip_all_tags( $post->post_content );

    if ( function_exists( 'mb_stripos' ) ) {
        $pos = mb_stripos( $content, $keyword );
    } else {
        $pos = stripos( $content, $keyword );
    }

    if ( $pos !== false ) {
        $results[] = $post_id;
    }
}
wp_reset_postdata();

搜尋結果呈現與操作介面

搜尋結果會以表格形式呈現，包含文章 ID、標題（連結至編輯頁面）、前台連結與編輯按鈕，方便快速查看與編輯。若無輸入關鍵字或找不到結果，會顯示相應提示訊息。

表單使用 WordPress 內建的 wp_nonce_field 與 submit_button，確保安全與一致性。

實務應用與優化方向

此搜尋功能適合用於自訂文章類型管理，尤其是內容量大且需要精準定位文本的場景。未來可考慮加入分頁功能避免一次載入過多文章，或結合全文索引外掛提升搜尋效能。也可擴充搜尋範圍至自訂欄位或分類。

完整程式碼

 'solution',
                'post_status'    => 'any',
                'posts_per_page' => -1,
                's'              => $keyword,
                'fields'         => 'ids',
            ) );

            if ( $query->have_posts() ) {
                foreach ( $query->posts as $post_id ) {
                    $post = get_post( $post_id );
                    if ( ! $post ) {
                        continue;
                    }

                    // 從內容中做字串檢查（確保 content 真的有包含關鍵字）
                    $content = wp_strip_all_tags( $post->post_content );

                    if ( function_exists( 'mb_stripos' ) ) {
                        $pos = mb_stripos( $content, $keyword );
                    } else {
                        $pos = stripos( $content, $keyword );
                    }

                    if ( $pos !== false ) {
                        $results[] = $post_id;
                    }
                }
            }
            wp_reset_postdata();
        }
    }

    ?>
    

Solution 內容關鍵字搜尋

輸入一個關鍵字，系統會掃描 <code>solution</code>
 文章類型的內容（content），只要有包含該字串，就列出標題與編輯連結。

        
            

            


                    
                        關鍵字字串
                    


                        
                    
                
            

            
        

        

搜尋結果

            
                請輸入關鍵字。
            
                沒有找到內容包含「」的 solution 文章。
            

找到  篇文章，內容中包含「」。

                




                            ID
                            標題
                            前台連結
                            編輯
                        
                    


                    






                                
                                    
                                        
                                    
                                
                                    
                                
                            


                                
                                    
                                        檢視
                                    
                                
                                    -
                                
                            


                                
                                    
                                        編輯文章
                                    
                                
                                    -

ID	標題	前台連結	編輯
		檢視 -	編輯文章 -



WordPress 自定義文章類型相關文章顯示實作筆記
小豬 — Thu, 20 Feb 2025 07:18:16 +0000
前言
在 WordPress 開發中，常見需求是於自定義文章類型（Custom Post Type，CPT）頁面中顯示與該文章相關的一般文章。本文以名為 member_info 的 CPT 為例，示範如何利用 WP_Query 依據當前 CPT 文章標題搜尋並顯示相關文章。
程式碼實現
我們透過 WP_Query 搜尋標題或內容包含當前 member_info 文章標題的文章，並限制顯示數量。以下為範例程式碼，適合放入 single-member_info.php 或對應模板：
if (is_singular('member_info')) {
  $current_title = get_the_title(); // 取得當前 member_info 文章標題

  $args = array(
    'post_type' => 'post', // 僅搜尋一般文章
    'posts_per_page' => 5, // 限制顯示數量
    's' => $current_title, // 以標題作為搜尋關鍵字
  );

  $query = new WP_Query($args);

  if ($query->have_posts()) {
    echo '
相關文章';
    echo '
';
    while ($query->have_posts()) {
      $query->the_post();
      echo '
' . get_the_title() . '';
    }
    echo '';
  } else {
    echo '
相關文章';
    echo '
沒有找到相關文章';
  }

  wp_reset_postdata();
}
程式碼解析
1. 檢查文章類型
if (is_singular('member_info')) {
確保程式碼只在 member_info 單篇文章頁執行，避免影響其他頁面。
2. 取得當前文章標題
$current_title = get_the_title();
利用 WordPress 內建函式取得目前 CPT 文章標題，作為搜尋關鍵字。
3. 設定查詢參數
$args = array(
  'post_type' => 'post',
  'posts_per_page' => 5,
  's' => $current_title,
);

post_type 限定搜尋一般文章。
posts_per_page 限制最多顯示 5 篇。
s 參數用於全文搜尋，搜尋包含標題的文章。

4. 輸出查詢結果
if ($query->have_posts()) {
  echo '
相關文章';
  echo '
';
  while ($query->have_posts()) {
    $query->the_post();
    echo '
' . get_the_title() . '';
  }
  echo '';
} else {
  echo '
相關文章';
  echo '
沒有找到相關文章';
}
判斷是否有符合條件的文章，並以列表形式輸出標題與連結。
5. 重置查詢狀態
wp_reset_postdata();
避免自訂查詢影響後續 WordPress 迴圈或內容顯示。
實際應用與延伸

可用於產品頁面顯示與產品名稱相關的部落格文章。
課程頁面展示與課程名稱相關的學習資源。
可進一步結合自訂欄位或關聯插件，提升相關文章精準度。

常見坑

s 參數為全文搜尋，可能導致結果不夠精確。
查詢結果過多時，建議加入分頁或限制數量。
請確保模板檔案命名與 CPT 名稱一致，避免無法正確載入。

完整程式碼
 'post', // 只搜尋一般文章
    'posts_per_page' => 5, // 限制顯示數量
    's' => $current_title, // 內文搜尋關鍵字
  );

  $query = new WP_Query($args);

  if ($query->have_posts()) {
    echo '
相關文章';
    echo '
';
    while ($query->have_posts()) {
      $query->the_post();
      echo '
' . get_the_title() . '';
    }
    echo '';
  } else {
    echo '
相關文章';
    echo '
沒有找到相關文章';
  }

  wp_reset_postdata();
}
?>


利用 Shortcode 在 WordPress 頁面顯示指定 Post Type 文章教學
小豬 — Wed, 01 Nov 2017 17:24:52 +0000
前言
在使用 WordPress 建置網站時，若頁面內容多以 shortcode 方式組合，想要在頁面中靈活顯示特定文章類型（Post Type）的文章，就需要將查詢文章的功能包裝成 shortcode。這樣可以方便在任何頁面或文章中插入，提升內容管理彈性。本文適合有基礎 PHP 與 WordPress 開發經驗的工程師或自學者。
建立自訂 Shortcode 函式
我們可以在主題的 functions.php 檔案中，撰寫一個函式來查詢指定的文章類型，並輸出 HTML 結構。以下為範例關鍵程式碼說明：
function home_post_listing_shortcode( $atts ) {
    ob_start();
    // 建立 WP_Query 物件，查詢 post_type 為 'post' 的文章，限制顯示 3 篇，依標題排序（降冪）
    $query = new WP_Query( array(
        'post_type'      => 'post', // 可替換成想抓取的自訂文章類型
        'posts_per_page' => 3,      // 取出文章數量
        'order'          => 'DESC', // 排序方式 ASC(小->大), DESC(大->小)
        'orderby'        => 'title' // 依標題排序
    ) );

    if ( $query->have_posts() ) {
        echo '';
        while ( $query->have_posts() ) {
            $query->the_post();
            ?>
            >
                
                ', ''); ?>
                
            
            ';
        wp_reset_postdata();
    }

    return ob_get_clean();
}
註冊 Shortcode
將上述函式註冊為 shortcode，讓 WordPress 辨識並可在頁面中使用：
add_shortcode( 'list-posts-home', 'home_post_listing_shortcode' );
註冊後，只要在 WordPress 後台的頁面編輯器中插入 [list-posts-home]，就會顯示該 shortcode 所輸出的文章列表。
實際應用與延伸

可修改 post_type 參數為自訂文章類型，如 product、event 等。
可加入 category_name 或 tax_query 參數，篩選特定分類文章。
調整 posts_per_page 與排序條件，符合不同需求。
搭配頁面建構器（如 Visual Composer）使用，提升內容排版彈性。

常見坑點

order 參數應為 DESC（大到小），原範例中寫成 DSC 會無效。
使用 the_date() 時，若多篇文章同一天只會顯示一次日期，改用 the_time() 可避免此問題。
記得使用 wp_reset_postdata() 恢復全域文章資料，避免影響其他查詢。

完整程式碼
function home_post_listing_shortcode( $atts ) {
    ob_start();
    $query = new WP_Query( array(
        'post_type'      => 'post',
        'posts_per_page' => 3,
        'order'          => 'DESC',
        'orderby'        => 'title',
    ) );

    if ( $query->have_posts() ) {
        echo '';
        while ( $query->have_posts() ) {
            $query->the_post();
            ?>
            >
                
                ', ''); ?>
                
            
            ';
        wp_reset_postdata();
    }

    return ob_get_clean();
}

add_shortcode( 'list-posts-home', 'home_post_listing_shortcode' );