這段程式碼主要解決 LearnDash 後台課程列表無法直接查看每門課程已報名學生數的問題。對於管理大量課程與學員的教學平台管理員來說，快速掌握報名狀況非常重要。本文適合熟悉 WordPress 與 LearnDash 且想自訂後台介面與效能優化的工程師或自學者。

新增自訂欄位到課程列表

透過 WordPress 提供的 manage_edit-{$post_type}_columns 過濾器，我們在 sfwd-courses（LearnDash 課程）後台列表中插入一個「已報名學生」欄位。此欄位被放置在標題欄位後面，方便管理者一目了然。

add_filter('manage_edit-sfwd-courses_columns', function ($columns) {
    $new = [];
    foreach ($columns as $k => $v) {
        $new[$k] = $v;
        if ($k === 'title') {
            $new['ld_enrolled_count'] = '已報名學生';
        }
    }
    if (!isset($new['ld_enrolled_count'])) {
        $new['ld_enrolled_count'] = '已報名學生';
    }
    return $new;
}, 20);

顯示欄位內容與計數邏輯

使用 manage_sfwd-courses_posts_custom_column 動作鉤子，根據課程 ID 呼叫自訂函式取得報名學生數並輸出。計數邏輯透過 WP_UserQuery 查詢所有有 usermeta 中 `course{course_id}_access_from` 欄位存在的使用者數量，這是 LearnDash 判斷學員是否有課程存取權的標準做法。

add_action('manage_sfwd-courses_posts_custom_column', function ($column, $post_id) {
    if ($column !== 'ld_enrolled_count')
        return;

    $count = vs_ld_get_enrolled_count($post_id);

    echo esc_html((string) $count);
}, 10, 2);

快取機制提升效能

為避免課程列表頁面每筆課程都執行重複且昂貴的資料庫查詢，使用 WordPress 內建快取（wp_cache）暫存結果 10 分鐘。這樣可以大幅減少對資料庫的負擔，避免後台卡頓。

function vs_ld_get_enrolled_count($course_id)
{
    $course_id = (int) $course_id;
    if ($course_id <= 0)
        return 0;

    $cache_key = 'course_enrolled_' . $course_id;
    $cached = wp_cache_get($cache_key, 'ld_course_enroll_count');
    if ($cached !== false) {
        return (int) $cached;
    }

    $meta_key = 'course_' . $course_id . '_access_from';

    $uq = new WP_User_Query([
        'fields' => 'ID',
        'number' => 1,
        'paged' => 1,
        'count_total' => true,
        'meta_query' => [
            [
                'key' => $meta_key,
                'compare' => 'EXISTS',
            ],
        ],
    ]);

    $count = (int) $uq->get_total();

    wp_cache_set($cache_key, $count, 'ld_course_enroll_count', 10 * MINUTE_IN_SECONDS);

    return $count;
}

課程更新時清除快取

為確保報名數字不會因快取而過時，當課程內容被更新時，會自動刪除對應快取，讓下一次查詢能取得最新資料。

add_action('save_post_sfwd-courses', function ($post_id) {
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE)
        return;
    $post_id = (int) $post_id;
    wp_cache_delete('course_enrolled_' . $post_id, 'ld_course_enroll_count');
}, 20);

實務應用與延伸

這種方式適合需要在 LearnDash 後台快速掌握各課程報名狀況的管理者，尤其是課程數量龐大時，快取機制可有效減少資料庫負擔。未來可延伸加入排序功能，或結合 AJAX 即時更新報名數，提升使用體驗。

常見問題與注意事項

• 快取時間設定過短會增加資料庫查詢頻率，過長可能導致數據不即時，需依實際需求調整。
• 使用 WP_User_Query 查詢大量用戶時，仍需注意資料庫效能，建議搭配適當索引。
• 本範例假設 LearnDash 使用標準 usermeta key，若有自訂存取邏輯需調整查詢條件。

完整程式碼

<?php
if (!defined('ABSPATH'))
    exit;

/**
 * LearnDash：後台課程清單新增「已報名學生數」欄位
 * - post_type: sfwd-courses
 * - 計數依據：usermeta key = course_{course_id}_access_from EXISTS
 * - 有短暫快取，避免清單頁卡爆
 */

/** 1) 加欄位 */
add_filter('manage_edit-sfwd-courses_columns', function ($columns) {
    // 插在標題後面（你也可以改位置）
    $new = [];
    foreach ($columns as $k => $v) {
        $new[$k] = $v;
        if ($k === 'title') {
            $new['ld_enrolled_count'] = '已報名學生';
        }
    }
    if (!isset($new['ld_enrolled_count'])) {
        $new['ld_enrolled_count'] = '已報名學生';
    }
    return $new;
}, 20);

/** 2) 顯示欄位內容 */
add_action('manage_sfwd-courses_posts_custom_column', function ($column, $post_id) {
    if ($column !== 'ld_enrolled_count')
        return;

    $count = vs_ld_get_enrolled_count($post_id);

    echo esc_html((string) $count);
}, 10, 2);

/** 3) 計數函式（含快取） */
function vs_ld_get_enrolled_count($course_id)
{
    $course_id = (int) $course_id;
    if ($course_id <= 0)
        return 0;

    // 快取 10 分鐘（避免列表頁每一列都打一次 users table）
    $cache_key = 'course_enrolled_' . $course_id;
    $cached = wp_cache_get($cache_key, 'ld_course_enroll_count');
    if ($cached !== false) {
        return (int) $cached;
    }

    // LearnDash 最常用的課程存取 key
    $meta_key = 'course_' . $course_id . '_access_from';

    // 用 WP_User_Query 計數 meta_key EXISTS 的使用者
    $uq = new WP_User_Query([
        'fields' => 'ID',
        'number' => 1,        // 只要 count_total，不要真的撈一堆 ID
        'paged' => 1,
        'count_total' => true,
        'meta_query' => [
            [
                'key' => $meta_key,
                'compare' => 'EXISTS',
            ],
        ],
    ]);

    $count = (int) $uq->get_total();

    wp_cache_set($cache_key, $count, 'ld_course_enroll_count', 10 * MINUTE_IN_SECONDS);

    return $count;
}

/** 4) 當課程更新時，清掉該課程快取（避免顯示太久舊數字） */
add_action('save_post_sfwd-courses', function ($post_id) {
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE)
        return;
    $post_id = (int) $post_id;
    wp_cache_delete('course_enrolled_' . $post_id, 'ld_course_enroll_count');
}, 20);

在管理 WordPress 自訂文章類型（Custom Post Type）時，常會遇到需要批次替換文章內容或摘要中的特定字串的需求。手動逐篇修改不僅耗時，也容易出錯。這段程式碼示範如何在 WordPress 後台為名為 solution 的自訂文章類型新增一個子選單，提供一個簡單介面讓管理員輸入舊字串與新字串，並自動搜尋所有 solution 文章的內容與摘要進行批次替換。

這篇文章適合有基本 WordPress 開發經驗，想要了解如何擴充後台功能並操作自訂文章內容的工程師與自學者。

新增後台子選單

使用 add_action('admin_menu', ...) 來掛載函式，先判斷 solution 文章類型是否存在，避免錯誤。接著用 add_submenu_page 在 solution 文章列表下新增「內容關鍵字取代」的子選單，權限設定為可編輯文章的用戶。

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

    add_submenu_page(
        'edit.php?post_type=solution',
        '內容關鍵字取代',
        '內容關鍵字取代',
        'edit_posts',
        'solution-content-replace',
        'solution_content_replace_page'
    );
});

這段程式碼確保只有在 solution 文章類型存在時才新增選單，避免後台出現無效連結。

後台頁面與表單設計

solution_content_replace_page 函式負責渲染後台頁面。首先檢查使用者權限，防止未授權存取。頁面包含一個表單，讓使用者輸入「舊字串」與「新字串」，並使用 WordPress 的 nonce 機制防止 CSRF 攻擊。

if (!current_user_can('edit_posts')) {
    wp_die('沒有權限。');
}

// 表單中使用 wp_nonce_field 產生安全碼

表單送出後會執行字串替換邏輯。

批次搜尋與替換邏輯說明

當表單送出且 nonce 驗證通過後，程式會取得輸入的舊字串與新字串，並用 WP_Query 撈出所有 solution 文章的 ID。

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

接著逐篇文章讀取內容（post_content）與摘要（post_excerpt），利用 mb_strpos（若可用）或 strpos 檢查舊字串是否存在。若存在，則用 str_replace 替換。

if ($content_pos !== false) {
    $updated_content = str_replace($old, $new, $content);
    if ($updated_content !== $content) {
        $update_args['post_content'] = $updated_content;
        $status_parts[] = '內容';
    }
}

替換完成後，只有在內容或摘要確實有變動時才呼叫 wp_update_post 進行更新，避免不必要的資料庫寫入。

結果呈現與使用者體驗

執行完替換後，頁面會顯示替換結果列表，包括文章 ID、標題、替換狀態（內容、摘要或兩者）以及快速編輯連結，方便管理者後續檢查與微調。

若未輸入舊字串，會顯示警告；若找不到符合條件的文章，則提示資訊，提升使用者體驗。

實務應用與優化建議

此工具適合用於需要大量文字修正的場景，例如品牌名稱變更、產品名稱更新或錯字修正。未來可擴充功能，如：

• 支援正規表達式替換
• 限制替換範圍（例如只替換內容或摘要）
• 增加替換前預覽功能
• 加入替換記錄與回滾機制

此外，批次更新大量文章時，建議搭配分批處理避免伺服器超時。

常見問題與注意事項

• 請確認使用者權限設定正確，避免無權限使用此工具。
• 替換字串為空白時，會將舊字串刪除，請謹慎操作。
• 使用 mb_strpos 可避免多字節字串判斷錯誤，若環境不支援會退回 strpos。

完整程式碼

<?php
// 在 solution post type 底下新增子選單：內容關鍵字取代
add_action('admin_menu', function () {
    if (!post_type_exists('solution')) {
        return;
    }

    add_submenu_page(
        'edit.php?post_type=solution',
        '內容關鍵字取代',
        '內容關鍵字取代',
        'edit_posts',
        'solution-content-replace',
        'solution_content_replace_page'
    );
});

// 後台頁面
function solution_content_replace_page() {
    if (!current_user_can('edit_posts')) {
        wp_die('沒有權限。');
    }

    $old = '';
    $new = '';
    $results = [];
    $executed = false;

    if (isset($_POST['solution_replace_submit'])) {
        check_admin_referer('solution_replace_action', 'solution_replace_nonce');

        $old = isset($_POST['old_keyword']) ? sanitize_text_field($_POST['old_keyword']) : '';
        $new = isset($_POST['new_keyword']) ? sanitize_text_field($_POST['new_keyword']) : '';

        $executed = true;

        if ($old !== '') {
            $query = new WP_Query([
                'post_type'      => 'solution',
                'post_status'    => 'any',
                'posts_per_page' => -1,
                'fields'         => 'ids',
            ]);

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

                $content = $post->post_content;
                $excerpt = $post->post_excerpt;

                // 檢查舊字串是否存在（內容＋摘要）
                if (function_exists('mb_strpos')) {
                    $content_pos = ($content !== '') ? mb_strpos($content, $old) : false;
                    $excerpt_pos = ($excerpt !== '') ? mb_strpos($excerpt, $old) : false;
                } else {
                    $content_pos = ($content !== '') ? strpos($content, $old) : false;
                    $excerpt_pos = ($excerpt !== '') ? strpos($excerpt, $old) : false;
                }

                if ($content_pos !== false || $excerpt_pos !== false) {
                    $update_args = [
                        'ID' => $post_id,
                    ];
                    $status_parts = [];

                    // 內容替換
                    if ($content_pos !== false) {
                        $updated_content = str_replace($old, $new, $content);
                        if ($updated_content !== $content) {
                            $update_args['post_content'] = $updated_content;
                            $status_parts[] = '內容';
                        }
                    }

                    // 摘要替換
                    if ($excerpt_pos !== false) {
                        $updated_excerpt = str_replace($old, $new, $excerpt);
                        if ($updated_excerpt !== $excerpt) {
                            $update_args['post_excerpt'] = $updated_excerpt;
                            $status_parts[] = '摘要';
                        }
                    }

                    // 真的有需要更新才存
                    if (!empty($status_parts)) {
                        wp_update_post($update_args);

                        $results[] = [
                            'id'     => $post_id,
                            'title'  => $post->post_title,
                            'status' => '已替換：' . implode('、', $status_parts),
                        ];
                    }
                }
            }
            wp_reset_postdata();
        }
    }
    ?>

<h1>Solution – 內容關鍵字取代</h1>

<p>此工具會掃描所有 <code>solution 文章的內容與摘要，將符合的字串批次替換。


        
            

            




要搜尋的字（舊字串）


                        <input type="text" id="old_keyword" name="old_keyword" class="regular-text"
                               value=""
                               placeholder="例如：舊字串">
                    
                



替換成（新字串）


                        <input type="text" id="new_keyword" name="new_keyword" class="regular-text"
                               value=""
                               placeholder="例如：新字串（可空白）">
                    
                
            

            
        

        

取代結果

            
                
請輸入要搜尋的舊字串。

            
                
沒有任何文章的內容或摘要包含「」。

            
                






ID

標題

狀態

編輯連結
                    
                    


                    









<a href="" class="button button-small">編輯
                        
                    
                    
                
            

        

    <?php
}

在 WooCommerce 訂單後台管理時，常會需要額外新增自訂欄位以收集特定資訊，例如客戶的聯絡電話。這段程式碼示範如何在訂單編輯頁面保存自訂欄位資料，確保資料能正確存入訂單元資料中。適合已熟悉 WooCommerce 且想擴充後台訂單欄位功能的工程師或自學者。

為什麼需要自訂欄位儲存機制

WooCommerce 預設訂單資料結構無法涵蓋所有業務需求，因此經常會透過自訂欄位來擴充。這些欄位必須在後台訂單編輯時能夠被正確讀取與保存，否則資料會遺失。

使用 woocommerce_process_shop_order_meta 鉤子

這個 action 鉤子會在 WooCommerce 處理訂單後台編輯表單時觸發，適合用來攔截並保存自訂欄位資料。

add_action('woocommerce_process_shop_order_meta', function ($order_id) {
    // 權限檢查，避免非授權使用者修改訂單
    if (!current_user_can('edit_shop_order', $order_id))
        return;

    $key = '_shipping_phone'; // 自訂欄位名稱

    // 確認表單有送出該欄位
    if (!isset($_POST[$key]))
        return;

    // 清理輸入資料，避免 XSS 或其他注入風險
    $value = wc_clean(wp_unslash($_POST[$key]));

    // 取得訂單物件
    $order = wc_get_order($order_id);
    if (!$order)
        return;

    // 使用 WC_Order API 更新訂單元資料
    $order->update_meta_data($key, $value);
    $order->save(); // 必須呼叫 save() 才會寫入資料庫
}, 50);

關鍵說明

• current_user_can 用來確保只有有編輯訂單權限的使用者能執行更新。
• wc_clean 和 wp_unslash 是 WordPress 與 WooCommerce 提供的安全函式，確保輸入資料安全。
• 使用 update_meta_data 與 save 是 WooCommerce 推薦的寫入方式，兼容新版 HPOS（高效訂單存儲系統）與舊版 postmeta。

實務應用與延伸

此方法可擴充至任何自訂欄位，只要對應修改 $key 與表單名稱即可。實務中，還可搭配後台欄位輸入介面（如使用 woocommerce_admin_order_data_after_billing_address 鉤子）來完整實作自訂欄位的讀寫。

常見問題與注意事項

• 忘記呼叫 $order->save() 將導致資料無法寫入。
• 欄位名稱建議加底線開頭避免與 WooCommerce 原生欄位衝突。
• 權限檢查不可省略，避免安全問題。

完整程式碼

<?php
add_action('woocommerce_process_shop_order_meta', function ($order_id) {
    if (!current_user_can('edit_shop_order', $order_id))
        return;

    $key = '_shipping_phone';

    if (!isset($_POST[$key]))
        return;

    $value = wc_clean(wp_unslash($_POST[$key]));

    $order = wc_get_order($order_id);
    if (!$order)
        return;

    $order->update_meta_data($key, $value);
    $order->save();
}, 50);

在 WordPress 中，文章的 slug（網址別名）預設是根據標題自動產生，或由使用者手動設定。有時候為了簡化網址管理或避免重複 slug，會想將 slug 固定為文章的 ID。這段程式碼示範如何在文章發佈或排程時，自動將 slug 設為文章 ID，適合需要統一網址格式的開發者或網站管理者。

為什麼要用文章 ID 當 slug？

文章 ID 是 WordPress 中每篇文章的唯一識別碼，使用 ID 當 slug 可以避免重複 slug 的問題，也方便在程式中直接以 ID 取用文章，提升網址的穩定性與一致性。

程式碼解析

1. 使用 save_post Hook

程式碼利用 WordPress 的 save_post action，這個鉤子會在文章儲存時觸發，能即時修改文章資料。

add_action('save_post', function ($post_id, $post, $update) {
    // 程式內容
}, 20, 3);

這裡設定優先權為 20，並且接受三個參數：文章 ID、文章物件、是否為更新。

2. 基本保護條件

避免對修訂版本（revision）或自動儲存（autosave）執行，減少不必要的處理。

if (wp_is_post_revision($post_id) || wp_is_post_autosave($post_id)) return;
if (!is_object($post)) return;

3. 限制只對文章類型生效

確保只對 post 文章類型操作，不影響其他自訂文章類型。

if ($post->post_type !== 'post') return;

4. 限制文章狀態

只對「已發佈（publish）」與「排程（future）」的文章改寫 slug，避免草稿或其他狀態執行。

$allowed_status = ['publish', 'future'];
if (!in_array($post->post_status, $allowed_status, true)) return;

5. 判斷是否已是目標 slug

如果 slug 已經是文章 ID，則不再重寫，避免重複操作。

$target_slug = (string) $post_id;
if ($post->post_name === $target_slug) return;

6. 防止無限迴圈

wp_update_post 會再次觸發 save_post，容易造成無限迴圈。使用靜態變數 $running 作為旗標，避免重複執行。

static $running = false;
if ($running) return;
$running = true;

7. 更新 slug

呼叫 wp_update_post 更新文章的 post_name 欄位為文章 ID。

wp_update_post([
    'ID'        => $post_id,
    'post_name' => $target_slug,
]);
$running = false;

實務應用與延伸

• 適合網站需要簡潔、唯一的網址結構，或是避免標題相同導致 slug 重複的情況。
• 可擴充支援更多文章類型或狀態，只要調整條件判斷即可。
• 若需保留原本 slug，可改成在自訂欄位或其他欄位存 ID。
• 注意排程文章的 slug 會在排程時間前就設定完成。

常見問題與注意事項

• 無限迴圈問題是此類操作常見的陷阱，務必使用旗標避免。
• 使用文章 ID 當 slug 可能不利 SEO，需評估是否符合網站策略。
• 若網站有使用快取或重寫規則，更新 slug 後可能需要清除快取。

完整程式碼

<?php
/**
 * Post 發佈時固定把 slug 設為文章 ID
 * - 只針對 post（文章）
 * - 避免無限迴圈
 * - 若已是 ID slug 就不重寫
 * - 支援 publish / future（排程）/ 更新時維持
 */

add_action('save_post', function ($post_id, $post, $update) {

    // 1) 基本保護
    if (wp_is_post_revision($post_id) || wp_is_post_autosave($post_id)) return;
    if (!is_object($post)) return;

    // 2) 只針對文章 post
    if ($post->post_type !== 'post') return;

    // 3) 只在這些狀態下固定（你也可以只留 publish）
    $allowed_status = ['publish', 'future']; // future = 排程
    if (!in_array($post->post_status, $allowed_status, true)) return;

    // 4) 目標 slug = 文章 ID
    $target_slug = (string) $post_id;

    // 5) 已經是目標 slug 就不做事
    if ($post->post_name === $target_slug) return;

    // 6) 防止 save_post -> wp_update_post -> save_post 無限迴圈
    static $running = false;
    if ($running) return;
    $running = true;

    // 7) 更新 slug
    wp_update_post([
        'ID'        => $post_id,
        'post_name' => $target_slug,
    ]);

    $running = false;

}, 20, 3);

在多語網站開發中，使用 Polylang 外掛管理翻譯文章是一種常見做法。但當需要將大量文章從某一語言批次複製到另一語言時，手動操作效率低且容易出錯。這段程式碼提供一個獨立於特定文章類型的批次翻譯複製工具，適合有基礎 WordPress 與 Polylang 使用經驗的工程師或自學者，幫助快速複製文章並保持翻譯關聯。

工具功能與設計架構

1. 固定來源語言與多目標語言選擇

程式碼中定義常數 IR_SOURCE_LANG 為來源語言（此處固定為中文 zh），目標語言則可從下拉選單選擇（預設有英文 en、日文 ja），方便擴充其他語言。

2. 獨立後台介面

透過 add_submenu_page 將工具掛載於 WordPress 後台「工具」選單下，並提供兩種操作模式：

• 單筆測試：指定文章 ID，快速測試複製功能。
• 批次複製：依選定文章類型，批次複製該語言下所有文章。

3. 使用 Polylang 官方 API 確保語言設定與翻譯關聯

核心複製流程依序使用 wp_insert_post 建立新文章，pll_set_post_language 設定語言，最後用 pll_save_post_translations 儲存翻譯群組關聯，確保與 Polylang 外掛的正確整合。

核心複製流程解析

Step 1: 確認來源文章與語言

先取得來源文章，確認文章類型與來源語言是否符合設定，避免誤複製。

ir_set_lang_official( $source_id, IR_SOURCE_LANG );

這行確保來源文章語言正確。

Step 2: 建立新文章

使用 wp_insert_post 複製文章標題、內容、狀態、作者、日期等基本欄位，確保新文章與原文一致。

Step 3: 設定新文章語言

新文章建立後，設定為目標語言，保持語言一致性。

Step 4: 儲存翻譯關聯

將新文章加入翻譯群組，讓 Polylang 知道這是原文的翻譯版本。

Step 5: 複製分類法（Taxonomy）

複製原文文章所屬的分類與標籤，但排除語言相關的 taxonomy，避免衝突。

Step 6: 複製特色圖片

如果原文有設定特色圖片，將同一張圖片設定給新文章，保持視覺一致性。

Step 7: 複製 ACF 自訂欄位

利用 Advanced Custom Fields (ACF) 官方 API 安全複製所有自訂欄位，避免欄位名稱變動造成錯誤。

實務應用與優化建議

• 資料備份：批次操作前務必備份資料庫，避免誤操作造成資料遺失。
• 語言擴充：可依需求擴充 $allowed_target_langs 陣列，支援更多語言。
• 效能考量：批次複製大量文章時，可能造成伺服器負擔，可分批執行或加入排程。
• 錯誤處理：目前以回傳日誌方式呈現，可擴充為錯誤通知或記錄檔。

常見問題與注意事項

• 複製後的文章不會自動翻譯內容，僅複製原文內容，需後續人工或機器翻譯。
• Polylang API 函式必須存在，否則功能無法使用。
• ACF 複製需確保 ACF 外掛已啟用且函式存在。

完整程式碼

<?php
/**
 * Universal Polylang Bulk Copy Tool (Final Version - FIXED)
 * - 獨立在「工具 → Bulk Copy Translations」底下（不綁每個 post type）
 * - 任意 Post Type 下拉選單選擇
 * - 來源語言固定 zh
 * - 目標語言下拉選（en / ja，可自行擴充）
 * - 單筆測試 / 批次處理
 * - 已存在翻譯自動跳過
 * - Polylang 官方流程：wp_insert_post + pll_set_post_language + pll_save_post_translations
 * - taxonomy / featured image / ACF 全欄位複製（ACF 安全寫法）
 *

if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

define( 'IR_SOURCE_LANG', 'zh' ); // 固定來源語言（Polylang code）

/* =========================
 * 共用：設定語言（官方 API）
 * ========================= */
function ir_set_lang_official( $post_id, $lang_code ) {
    if ( function_exists( 'pll_set_post_language' ) ) {
        pll_set_post_language( $post_id, $lang_code );
    }
}

/* =========================
 * 後台選單（獨立於 post type）
 * ========================= */
add_action( 'admin_menu', function () {
    add_submenu_page(
        'tools.php',                         // 掛在「工具」
        'Bulk Copy Translations (Official)', // 頁面標題
        'Bulk Copy Translations',            // 左側選單名稱
        'manage_options',                    // 權限
        'ir-bulk-translations',              // slug
        'ir_bulk_translations_page'          // callback
    );
});

/* =========================
 * 後台頁面
 * ========================= */
function ir_bulk_translations_page() {

    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( '沒有權限。' );
    }

    // Polylang API 檢查
    if ( ! function_exists( 'pll_set_post_language' ) || ! function_exists( 'pll_save_post_translations' ) ) {
        echo '<div class="notice notice-error"><p>Polylang API 不存在，請確認 Polylang 是否啟用。</p></div>';
        return;
    }

    // 允許的目標語言（依照 Polylang 的 code）
    $allowed_target_langs = [ 'en', 'ja' ];

    // 可選 post types（public）
    $post_types = get_post_types( [ 'public' => true ], 'objects' );

    // 預設值
    $current_post_type = isset( $_POST['ir_post_type'] ) ? sanitize_text_field( wp_unslash( $_POST['ir_post_type'] ) ) : 'post';
    if ( ! isset( $post_types[ $current_post_type ] ) ) {
        $current_post_type = 'post';
    }

    $current_target = isset( $_POST['ir_target_lang'] ) ? sanitize_text_field( wp_unslash( $_POST['ir_target_lang'] ) ) : 'en';
    if ( ! in_array( $current_target, $allowed_target_langs, true ) ) {
        $current_target = 'en';
    }

    echo '
<h1>通用翻譯複製工具（Polylang 官方流程）</h1>';
    echo '
<p>來源語言固定為：<code>' . esc_html( IR_SOURCE_LANG ) . '
';
    echo '
⚠️ 執行前請先備份資料庫
';

    echo '

        .ir-box{background:#fff;border:1px solid #ccd0d4;padding:12px 14px;margin:12px 0;}
        .ir-row{margin:10px 0;}
        .ir-row label{display:inline-block;min-width:90px;font-weight:600;}
        .ir-pre{background:#fff;border:1px solid #ccd0d4;padding:10px;max-height:520px;overflow:auto;white-space:pre-wrap;}
    ';

    /* =========================
     * 單筆測試
     * ========================= */
    echo '
';
    echo '
單筆測試
';
    echo '';
    wp_nonce_field( 'ir_single' );

    echo '
Post Type ';
    echo '';
    foreach ( $post_types as $pt ) {
        printf(
            '%s (%s)',
            esc_attr( $pt->name ),
            selected( $current_post_type, $pt->name, false ),
            esc_html( $pt->labels->singular_name ),
            esc_html( $pt->name )
        );
    }
    echo '
';

    echo '
文章 ID ';
    echo '
';

    echo '
目標語言 ';
    echo '';
    foreach ( $allowed_target_langs as $lang ) {
        printf(
            '%s',
            esc_attr( $lang ),
            selected( $current_target, $lang, false ),
            esc_html( strtoupper( $lang ) )
        );
    }
    echo '
';

    submit_button( '測試複製', 'secondary', 'ir_single_run' );
    echo '';
    echo '
';

    /* =========================
     * 批次處理
     * ========================= */
    echo '
';
    echo '
批次複製（來源語言：' . esc_html( IR_SOURCE_LANG ) . '）
';
    echo '';
    wp_nonce_field( 'ir_bulk' );

    echo '
Post Type ';
    echo '';
    foreach ( $post_types as $pt ) {
        printf(
            '%s (%s)',
            esc_attr( $pt->name ),
            selected( $current_post_type, $pt->name, false ),
            esc_html( $pt->labels->singular_name ),
            esc_html( $pt->name )
        );
    }
    echo '
';

    echo '
目標語言 ';
    echo '';
    foreach ( $allowed_target_langs as $lang ) {
        printf(
            '%s',
            esc_attr( $lang ),
            selected( $current_target, $lang, false ),
            esc_html( strtoupper( $lang ) )
        );
    }
    echo '
';

    submit_button( '執行批次複製', 'primary', 'ir_bulk_run' );
    echo '';
    echo '
';

    /* =========================
     * 執行
     * ========================= */
    if ( isset( $_POST['ir_single_run'] ) ) {
        check_admin_referer( 'ir_single' );

        $post_id   = isset( $_POST['ir_test_id'] ) ? absint( $_POST['ir_test_id'] ) : 0;
        $target    = $current_target;
        $post_type = $current_post_type;

        echo '
單筆結果
';
        $log = ir_clone_post( $post_id, $target, $post_type );

        echo '
' . esc_html( implode( "\n", $log ) ) . '
';
    }

    if ( isset( $_POST['ir_bulk_run'] ) ) {
        check_admin_referer( 'ir_bulk' );

        $target    = $current_target;
        $post_type = $current_post_type;

        echo '
批次結果（Post Type：' . esc_html( $post_type ) . '，目標語言：' . esc_html( strtoupper( $target ) ) . '）
';

        $posts = get_posts( [
            'post_type'      => $post_type,
            'posts_per_page' => -1,
            'post_status'    => 'any',
            'lang'           => IR_SOURCE_LANG, // Polylang 的語言 query var
            'fields'         => 'ids',
        ] );

        if ( empty( $posts ) ) {
            echo '
找不到來源語言（' . esc_html( IR_SOURCE_LANG ) . '）的文章。
';
        } else {
            $output = [];
            foreach ( $posts as $id ) {
                $output = array_merge( $output, ir_clone_post( $id, $target, $post_type ) );
            }
            echo '
' . esc_html( implode( "\n", $output ) ) . '
';
        }
    }

}

/* =========================
 * 核心：複製一篇文章 → 目標語言翻譯
 * ========================= */
function ir_clone_post( $source_id, $target_lang, $post_type ) {

    $log = [];

    if ( ! $source_id ) {
        return [ '❌ 文章 ID 不可為 0' ];
    }

    $src = get_post( $source_id );
    if ( ! $src ) {
        return [ "❌ 找不到文章 {$source_id}" ];
    }

    // 確保來源文章屬於選定的 post type（避免拿錯）
    if ( $src->post_type !== $post_type ) {
        return [ "❌ 文章 {$source_id} 的 post_type 是 {$src->post_type}，不是你選的 {$post_type}，已中止。" ];
    }

    // Step 1) 確保原文語言
    ir_set_lang_official( $source_id, IR_SOURCE_LANG );
    $log[] = "Step 1) 設定原文語言：{$source_id} → " . IR_SOURCE_LANG;

    // 取得翻譯群組
    $translations = function_exists( 'pll_get_post_translations' )
        ? pll_get_post_translations( $source_id )
        : [];

    if ( empty( $translations[ IR_SOURCE_LANG ] ) ) {
        $translations[ IR_SOURCE_LANG ] = $source_id;
    }

    // 已存在目標語言 → 跳過
    if ( ! empty( $translations[ $target_lang ] ) ) {
        $existing = (int) $translations[ $target_lang ];
        $log[] = "⚠️ 已存在 {$target_lang} 翻譯（ID {$existing}），跳過。";

        // debug 狀態
        if ( function_exists( 'pll_get_post_language' ) ) {
            $lang_debug = [];
            foreach ( $translations as $code => $pid ) {
                $lang_debug[] = $code . ':' . $pid . '(' . pll_get_post_language( $pid ) . ')';
            }
            $log[] = '🧪 目前語言狀態：' . implode( ', ', $lang_debug );
        }

        return $log;
    }

    // Step 2) 建立新文章
    $new_id = wp_insert_post( [
        'post_type'      => $post_type,
        'post_status'    => $src->post_status,
        'post_title'     => $src->post_title,
        'post_content'   => $src->post_content,
        'post_excerpt'   => $src->post_excerpt,
        'post_author'    => $src->post_author,
        'post_date'      => $src->post_date,
        'post_date_gmt'  => $src->post_date_gmt,
        'menu_order'     => $src->menu_order,
        'post_parent'    => $src->post_parent,
    ], true );

    if ( is_wp_error( $new_id ) ) {
        $log[] = '❌ wp_insert_post 錯誤：' . $new_id->get_error_message();
        return $log;
    }
    $log[] = "Step 2) 建立新文章：{$new_id}";

    // Step 3) 設定新文章語言
    ir_set_lang_official( $new_id, $target_lang );
    $log[] = "Step 3) 設定新文章語言：{$new_id} → {$target_lang}";

    // Step 4) 儲存翻譯關聯
    $translations[ $target_lang ] = $new_id;
    pll_save_post_translations( $translations );
    $log[] = 'Step 4) 儲存翻譯關聯：' . wp_json_encode( $translations );

    // Step 5) 複製 taxonomy（排除語言 taxonomy）
    $taxes = get_object_taxonomies( $post_type );
    $taxes = array_diff( $taxes, [ 'language', 'pll_language' ] );

    foreach ( $taxes as $tax ) {
        $terms = wp_get_object_terms( $source_id, $tax, [ 'fields' => 'ids' ] );
        if ( ! is_wp_error( $terms ) ) {
            wp_set_object_terms( $new_id, $terms, $tax, false );
        }
    }
    $log[] = 'Step 5) Taxonomy 複製完成';

    // Step 6) 複製特色圖片
    $thumb = get_post_thumbnail_id( $source_id );
    if ( $thumb ) {
        set_post_thumbnail( $new_id, $thumb );
        $log[] = 'Step 6) Featured Image 複製完成';
    } else {
        $log[] = 'Step 6) 原文沒有 Featured Image';
    }

    // Step 7) 複製 ACF 全欄位（官方安全寫法）
    if ( function_exists( 'get_field_objects' ) && function_exists( 'update_field' ) ) {
        $fields = get_field_objects( $source_id );
        $count  = 0;

        if ( $fields ) {
            foreach ( $fields as $field ) {
                // 用 field key 複製最穩（不怕改欄位 name）
                update_field( $field['key'], $field['value'], $new_id );
                $count++;
            }
        }

        $log[] = "Step 7) ACF 全欄位複製完成（{$count} 個欄位）";
    } else {
        $log[] = 'Step 7) ACF API 不存在（get_field_objects / update_field），跳過 ACF 複製';
    }

    // 最後：語言檢查
    if ( function_exists( 'pll_get_post_language' ) ) {
        $src_lang_real = pll_get_post_language( $source_id );
        $new_lang_real = pll_get_post_language( $new_id );
        $log[] = "🧪 實際語言檢查：原文 {$source_id} 語言：{$src_lang_real}；新文 {$new_id} 語言：{$new_lang_real}";
    }

    $log[] = "✅ 完成：原文 {$source_id} → {$target_lang} 翻譯 {$new_id}";
    return $log;
}

在 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，確保安全與一致性。

實務應用與優化方向

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

完整程式碼

<?php
// 在「solution」這個 post type 底下新增一個後台子選單：內容關鍵字搜尋
add_action( 'admin_menu', function () {
    // 確保有這個 post type
    if ( ! post_type_exists( 'solution' ) ) {
        return;
    }

    add_submenu_page(
        'edit.php?post_type=solution',          // 父層 (solution 列表底下)
        '內容關鍵字搜尋',                        // 頁面標題
        '內容關鍵字搜尋',                        // 左側選單名稱
        'edit_posts',                           // 權限
        'solution-content-search',              // slug
        'solution_content_search_page_render'   // callback
    );
} );

// 後台頁面：渲染搜尋表單與結果
function solution_content_search_page_render() {
    if ( ! current_user_can( 'edit_posts' ) ) {
        wp_die( '沒有權限檢視此頁面。' );
    }

    $keyword  = '';
    $results  = array();
    $searched = false;

    // 處理表單送出
    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 找出可能包含關鍵字的文章 (全文搜尋)
            $query = new WP_Query( array(
                'post_type'      => '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();
        }
    }

    ?>
    <div class="wrap">

<h1>Solution 內容關鍵字搜尋</h1>

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

        <form method="post" style="margin-top: 1em; margin-bottom: 2em;">
            <?php wp_nonce_field( 'solution_content_search_action', 'solution_content_search_nonce' ); ?>

            <table class="form-table" role="presentation">

<tr>
                    <th scope="row">
                        <label for="solution_keyword">關鍵字字串</label>
                    </th>

<td>
                        <input
                            type="text"
                            id="solution_keyword"
                            name="solution_keyword"
                            class="regular-text"
                            value="<?php echo esc_attr( $keyword ); ?>"
                            placeholder="例如：API、某段程式碼、特定中文句子"
                        />
                    </td>
                </tr>
            </table>

            <?php submit_button( '開始搜尋', 'primary', 'solution_content_search_submit' ); ?>
        </form>

        <?php if ( $searched ) : ?>

<h2>搜尋結果</h2>

            <?php if ( $keyword === '' ) : ?>
                <div class="notice notice-warning"><p>請輸入關鍵字。</p></div>
            <?php elseif ( empty( $results ) ) : ?>
                <div class="notice notice-info"><p>沒有找到內容包含「<?php echo esc_html( $keyword ); ?>」的 solution 文章。</p></div>
            <?php else : ?>

<p>找到 <?php echo esc_html( count( $results ) ); ?> 篇文章，內容中包含「<?php echo esc_html( $keyword ); ?>」。</p>

                <table class="widefat fixed striped">

<thead>

<tr>
                            <th scope="col" style="width: 50px;">ID</th>
                            <th scope="col">標題</th>
                            <th scope="col" style="width: 200px;">前台連結</th>
                            <th scope="col" style="width: 150px;">編輯</th>
                        </tr>
                    </thead>

<tbody>
                    <?php foreach ( $results as $post_id ) :
                        $title     = get_the_title( $post_id );
                        $view_link = get_permalink( $post_id );
                        $edit_link = get_edit_post_link( $post_id, '' );
                    ?>

<tr>

<td><?php echo esc_html( $post_id ); ?></td>

<td>
                                <?php if ( $edit_link ) : ?>
                                    <a href="<?php echo esc_url( $edit_link ); ?>">
                                        <?php echo esc_html( $title ); ?>
                                    </a>
                                <?php else : ?>
                                    <?php echo esc_html( $title ); ?>
                                <?php endif; ?>
                            </td>

<td>
                                <?php if ( $view_link ) : ?>
                                    <a href="<?php echo esc_url( $view_link ); ?>" target="_blank" rel="noopener noreferrer">
                                        檢視
                                    </a>
                                <?php else : ?>
                                    -
                                <?php endif; ?>
                            </td>

<td>
                                <?php if ( $edit_link ) : ?>
                                    <a href="<?php echo esc_url( $edit_link ); ?>" class="button button-small">
                                        編輯文章
                                    </a>
                                <?php else : ?>
                                    -
                                <?php endif; ?>
                            </td>
                        </tr>
                    <?php endforeach; ?>
                    </tbody>
                </table>
            <?php endif; ?>
        <?php endif; ?>
    </div>
    <?php
}

在 WordPress 後台管理自訂文章類型（Custom Post Type）時，有時需要快速批次更新文章內容中的特定字串。這段程式碼示範如何在名為 solution 的自訂文章類型新增一個子選單，提供後台管理者輸入舊字串與新字串，並批次替換所有相關文章內容中的文字。適合有基本 WordPress 開發經驗，想要自訂後台功能以提升內容維護效率的工程師或自學者。

新增子選單介面

利用 admin_menu action 新增子選單，並限定該選單只在 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-replace',
        'solution_content_replace_page'
    );
});

這段程式碼確保子選單只會在 solution 文章類型的管理頁面出現，並且點擊後會呼叫 solution_content_replace_page 函式來渲染頁面。

後台頁面與表單處理

solution_content_replace_page 函式負責顯示輸入表單與處理替換邏輯。首先檢查使用者權限，避免未授權存取。接著使用 WordPress 的 Nonce 機制保障表單安全。

if (!current_user_can('edit_posts')) {
    wp_die('沒有權限。');
}

if (isset($_POST['solution_replace_submit'])) {
    check_admin_referer('solution_replace_action', 'solution_replace_nonce');

    $old = isset($_POST['old_keyword']) ? sanitize_text_field($_POST['old_keyword']) : '';
    $new = isset($_POST['new_keyword']) ? sanitize_text_field($_POST['new_keyword']) : '';

    // 進行批次替換
}

使用者輸入的舊字串與新字串會經過 sanitize_text_field 清理，避免 XSS 或其他安全問題。

批次搜尋與替換邏輯

當舊字串不為空時，使用 WP_Query 撈取所有 solution 文章的 ID，並逐篇讀取內容。若文章內容包含舊字串，則使用 str_replace 替換後，呼叫 wp_update_post 更新文章。

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

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

    $content = $post->post_content;

    if (mb_strpos($content, $old) !== false) {
        $updated_content = str_replace($old, $new, $content);

        wp_update_post([
            'ID'           => $post_id,
            'post_content' => $updated_content
        ]);

        $results[] = [
            'id'     => $post_id,
            'title'  => $post->post_title,
            'status' => '已替換'
        ];
    }
}
wp_reset_postdata();

結果呈現與使用者體驗

頁面會根據執行狀態顯示不同訊息：

• 若未輸入舊字串，提醒使用者必須填寫。
• 若找不到包含舊字串的文章，顯示資訊提示。
• 若有替換成功的文章，列出文章 ID、標題、狀態與編輯連結，方便管理者後續檢視。

這樣的設計讓使用者能清楚知道批次操作的結果，並快速跳轉編輯。

實務應用與優化建議

此功能適合內容量大且需定期文字修正的網站，如產品說明、技術文件等。未來可擴充：

• 支援正則表達式替換，提高靈活度。
• 加入替換前後內容差異預覽，降低誤替換風險。
• 加入分頁或批次處理，避免大量文章一次更新造成伺服器負擔。

常見問題與注意事項

• 請確認使用者權限設定正確，避免誤用。
• 替換操作無法還原，建議先備份資料庫。
• 文字替換為純字串，不支援 HTML 或多語系複雜處理。

完整程式碼

<?php
// 在 solution post type 底下新增子選單：內容關鍵字取代
add_action('admin_menu', function () {
    if (!post_type_exists('solution')) {
        return;
    }

    add_submenu_page(
        'edit.php?post_type=solution',
        '內容關鍵字取代',
        '內容關鍵字取代',
        'edit_posts',
        'solution-content-replace',
        'solution_content_replace_page'
    );
});

// 後台頁面
function solution_content_replace_page() {
    if (!current_user_can('edit_posts')) {
        wp_die('沒有權限。');
    }

    $old = '';
    $new = '';
    $results = [];
    $executed = false;

    if (isset($_POST['solution_replace_submit'])) {
        check_admin_referer('solution_replace_action', 'solution_replace_nonce');

        $old = isset($_POST['old_keyword']) ? sanitize_text_field($_POST['old_keyword']) : '';
        $new = isset($_POST['new_keyword']) ? sanitize_text_field($_POST['new_keyword']) : '';

        $executed = true;

        if ($old !== '') {
            $query = new WP_Query([
                'post_type'      => 'solution',
                'post_status'    => 'any',
                'posts_per_page' => -1,
                'fields'         => 'ids',
            ]);

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

                $content = $post->post_content;

                // 檢查舊字串是否存在
                if (mb_strpos($content, $old) !== false) {
                    // 替換
                    $updated_content = str_replace($old, $new, $content);

                    // 更新文章
                    wp_update_post([
                        'ID'           => $post_id,
                        'post_content' => $updated_content
                    ]);

                    $results[] = [
                        'id'     => $post_id,
                        'title'  => $post->post_title,
                        'status' => '已替換'
                    ];
                }
            }
            wp_reset_postdata();
        }
    }
    ?>

<div class="wrap">

<h2>Solution – 內容關鍵字取代</h2>

        <form method="post">
            <?php wp_nonce_field('solution_replace_action', 'solution_replace_nonce'); ?>

            <table class="form-table">

<tr>

<th><label for="old_keyword">要搜尋的字（舊字串）</label></th>

<td>
                        <input type="text" id="old_keyword" name="old_keyword" class="regular-text"
                               value="<?php echo esc_attr($old); ?>"
                               placeholder="例如：舊字串">
                    </td>
                </tr>

<tr>

<th><label for="new_keyword">替換成（新字串）</label></th>

<td>
                        <input type="text" id="new_keyword" name="new_keyword" class="regular-text"
                               value="<?php echo esc_attr($new); ?>"
                               placeholder="例如：新字串（可空白）">
                    </td>
                </tr>
            </table>

            <?php submit_button('開始批次取代', 'primary', 'solution_replace_submit'); ?>
        </form>

        <?php if ($executed): ?>

<h2>取代結果</h2>

            <?php if ($old === ''): ?>
                <div class="notice notice-warning"><p>請輸入要搜尋的舊字串。</p></div>

            <?php elseif (empty($results)): ?>
                <div class="notice notice-info"><p>沒有任何文章包含「<?php echo esc_html($old); ?>」。</p></div>

            <?php else: ?>
                <table class="widefat striped">

<thead>

<tr>

<th>ID</th>

<th>標題</th>

<th>狀態</th>

<th>編輯連結</th>
                    </tr>
                    </thead>

<tbody>
                    <?php foreach ($results as $r): ?>

<tr>

<td><?php echo esc_html($r['id']); ?></td>

<td><?php echo esc_html($r['title']); ?></td>

<td><?php echo esc_html($r['status']); ?></td>

<td><a href="<?php echo get_edit_post_link($r['id']); ?>" class="button button-small">編輯</a></td>
                        </tr>
                    <?php endforeach; ?>
                    </tbody>
                </table>
            <?php endif; ?>

        <?php endif; ?>
    </div>

    <?php
}

這段 PHP 程式碼是為了解決 WordPress 使用 Polylang 多語系外掛時，如何批量將特定文章類型的內容從一種語言複製到另一種語言，並建立正確的翻譯關聯。適合需要管理大量多語系內容的網站管理員或開發者，尤其是想自動化翻譯文章複製流程的技術人員。

Polylang 官方 API 的使用背景

Polylang 提供了多個官方函式來管理文章語言與翻譯關聯，如 pll_set_post_language 設定文章語言，pll_save_post_translations 儲存翻譯群組，這是官方推薦的做法，能確保多語系資料完整且一致。

後台介面設計與操作流程

後台子選單與頁面

程式碼透過 add_submenu_page 在自訂文章類型「investor_relations」的管理頁面下新增子選單，提供單筆測試與批量複製兩種操作介面。使用者可選擇目標語言（目前限制為英文與日文），並執行對應動作。

權限與安全檢查

頁面載入時會檢查使用者是否有 manage_options 權限，並確認 Polylang API 函式存在，避免外掛未啟用或權限不足導致錯誤。

核心功能：複製文章並建立翻譯關聯

1. 確認來源文章及語言設定

函式 ir_clone_post_official 會先取得來源文章，並用 pll_set_post_language 強制設定來源文章語言，確保語言標記正確。

ir_set_lang_official( $source_id, $source_lang );

2. 檢查目標語言翻譯是否已存在

利用 pll_get_post_translations 取得該文章的所有語言版本，若目標語言已存在翻譯文章，則跳過建立，避免重複。

3. 建立新文章（翻譯版本）

使用 WordPress 官方函式 wp_insert_post 複製文章內容與屬性，並設定新文章的語言為目標語言。

$new_id = wp_insert_post([...]);
ir_set_lang_official( $new_id, $target_lang );

4. 儲存翻譯關聯

將來源文章與新文章的語言關聯資料更新至 Polylang，確保前台語言切換功能正常。

$translations[ $target_lang ] = $new_id;
pll_save_post_translations( $translations );

5. 複製分類法與特色圖片

排除語言分類法後，複製其他自訂分類法的關聯，並複製特色圖片，保持內容一致性。

6. 複製 ACF 自訂欄位資料

若有安裝 Advanced Custom Fields 外掛，會將所有欄位資料一併複製，包含上傳檔案，避免資料遺失。

實務應用與優化建議

• 備份資料庫：執行批量複製前務必備份，避免誤操作導致資料錯亂。
• 單筆測試：先用單筆測試功能確保流程正常，再進行批量操作。
• 擴充語言：可依需求新增允許的目標語言陣列。
• 錯誤處理：可加強錯誤回報與日誌紀錄，方便除錯與維護。

常見問題與注意事項

• Polylang API 函式不存在時，需確認外掛是否啟用。
• 複製文章時，若有其他外掛影響文章資料，可能需要額外處理。
• 語言分類法不應被複製，以免覆寫 Polylang 的語言設定。

完整程式碼

<?php
/**
 * Investor Relations 單語言批量翻譯複製工具（最終版）
 * - 完全走 Polylang 官方流程：
 *   wp_insert_post + pll_set_post_language + pll_save_post_translations
 * - 自動跳過「已經有目標語言翻譯」的文章
 */

define( 'IR_SOURCE_LANG', 'zh' );                  // 來源語言：中文
define( 'IR_POST_TYPE', 'investor_relations' );    // Post type：investor_relations

/* =========================
 * 共用：設定語言（官方 API）
 * ========================= */
function ir_set_lang_official( $post_id, $lang_code ) {
    if ( function_exists( 'pll_set_post_language' ) ) {
        pll_set_post_language( $post_id, $lang_code );
    }
}

/* =========================
 * 後台子選單
 * ========================= */
add_action( 'admin_menu', function () {
    add_submenu_page(
        'edit.php?post_type=' . IR_POST_TYPE,
        'Bulk Copy Translations (Official)',
        'Bulk Copy Translations (Official)',
        'manage_options',
        'ir-bulk-translations-official',
        'ir_bulk_translations_official_page'
    );
});

/* =========================
 * 後台頁面 + 控制流程
 * ========================= */
function ir_bulk_translations_official_page() {

    // 允許的目標語言（依照 Polylang 的 code）
    $allowed_target_langs = [ 'en', 'ja' ];

    if ( ! current_user_can( 'manage_options' ) ) {
        wp_die( '沒有權限。' );
    }

    if ( ! function_exists( 'pll_set_post_language' ) || ! function_exists( 'pll_save_post_translations' ) ) {
        echo '<div class="notice notice-error"><p>Polylang API 不存在，請確認外掛是否啟用。</p></div>';
        return;
    }

    // 目前選擇的目標語言（預設 en）
    $current_target = isset( $_POST['ir_target_lang'] )
        ? sanitize_text_field( $_POST['ir_target_lang'] )
        : 'en';

    if ( ! in_array( $current_target, $allowed_target_langs, true ) ) {
        $current_target = 'en';
    }

    echo '
<h1>Investor Relations 翻譯複製工具（官方流程版）</h1>';
    echo '
<p>來源語言固定為：<code>' . esc_html( IR_SOURCE_LANG ) . '
';
    echo '
⚠️ 執行前務必先備份資料庫！
';

    echo '
.ir-lang-select{margin-left:8px;}';

    /* ------------ 單筆測試表單 ------------- */
    echo '
單筆文章測試
';
    echo '';
    wp_nonce_field( 'ir_single_test_official' );
    echo '輸入文章 ID：';

    echo '目標語言：';
    echo '';
    foreach ( $allowed_target_langs as $code ) {
        printf(
            '%s',
            esc_attr( $code ),
            selected( $current_target, $code, false ),
            esc_html( strtoupper( $code ) )
        );
    }
    echo ' ';

    submit_button( '測試複製此文章', 'secondary', 'ir_single_test', false );
    echo '';

    /* ------------ 批次表單 ------------- */
    echo '
批量複製所有中文文章
';
    echo '';
    wp_nonce_field( 'ir_bulk_official' );

    echo '目標語言：';
    echo '';
    foreach ( $allowed_target_langs as $code ) {
        printf(
            '%s',
            esc_attr( $code ),
            selected( $current_target, $code, false ),
            esc_html( strtoupper( $code ) )
        );
    }
    echo ' ';

    submit_button( '執行批次複製（請先單筆測試）', 'primary', 'ir_bulk_run', false );
    echo '';

    /* ------------ 執行動作 ------------- */

    // 單筆
    if ( isset( $_POST['ir_single_test'] ) ) {
        check_admin_referer( 'ir_single_test_official' );
        $post_id = isset( $_POST['ir_test_id'] ) ? intval( $_POST['ir_test_id'] ) : 0;
        $target  = isset( $_POST['ir_target_lang'] ) ? sanitize_text_field( $_POST['ir_target_lang'] ) : 'en';
        ir_run_single_copy_official( $post_id, $target );
    }

    // 批次
    if ( isset( $_POST['ir_bulk_run'] ) ) {
        check_admin_referer( 'ir_bulk_official' );
        $target = isset( $_POST['ir_target_lang'] ) ? sanitize_text_field( $_POST['ir_target_lang'] ) : 'en';
        ir_run_bulk_copy_official( $target );
    }

}

function ir_run_single_copy_official( $post_id, $target_lang ) {
    echo '
<h3>單筆測試結果</h3>';

    if ( ! $post_id || ! get_post( $post_id ) ) {
        echo '<p style="color:red;">找不到文章 ID：' . esc_html( $post_id ) . '</p>';
        return;
    }

    $report = ir_clone_post_official( $post_id, $target_lang );

    echo '<pre style="background:white; padding:10px; border:1px solid #ccc;">';
    echo esc_html( implode( "\n", $report ) );
    echo '</pre>';
}

/* =========================
 * 批量處理所有中文文章（官方流程）
 * ========================= */
function ir_run_bulk_copy_official( $target_lang ) {
    $posts = get_posts( [
        'post_type'      => IR_POST_TYPE,
        'posts_per_page' => -1,
        'post_status'    => 'any',
        'lang'           => IR_SOURCE_LANG, // Polylang 的語言 query var
        'fields'         => 'ids',
    ] );

    echo '
<h2>批次執行結果（目標語言：' . esc_html( strtoupper( $target_lang ) ) . '）</h2>';

    if ( empty( $posts ) ) {
        echo '
<p>沒有找到來源語言（' . esc_html( IR_SOURCE_LANG ) . '）的文章。</p>';
        return;
    }

    $output = [];

    foreach ( $posts as $post_id ) {
        $report  = ir_clone_post_official( $post_id, $target_lang );
        $output  = array_merge( $output, $report );
    }

    echo '<pre style="background:white; max-height:450px; overflow:auto; padding:10px; border:1px solid #ccc;">';
    echo esc_html( implode( "\n", $output ) );
    echo '</pre>';
}

/* =========================
 * 核心：官方流程複製一篇文章 → 目標語言翻譯
 * ========================= */
function ir_clone_post_official( $source_id, $target_lang ) {
    $report = [];

    $source_post = get_post( $source_id );
    if ( ! $source_post ) {
        $report[] = "❌ 原文 {$source_id} 不存在";
        return $report;
    }

    $source_lang = IR_SOURCE_LANG;

    // Step 1) 先確保原文語言正確
    ir_set_lang_official( $source_id, $source_lang );
    $report[] = "Step 1) 設定原文語言：{$source_id} → {$source_lang}";

    // 取得現有翻譯 group
    $translations = function_exists( 'pll_get_post_translations' )
        ? pll_get_post_translations( $source_id )
        : [];

    if ( empty( $translations[ $source_lang ] ) ) {
        $translations[ $source_lang ] = $source_id;
    }

    // ✅ 若已存在該語言翻譯 → 自動跳過
    if ( ! empty( $translations[ $target_lang ] ) ) {
        $existing = $translations[ $target_lang ];
        $report[] = "⚠️ 原文 {$source_id} 已有 {$target_lang} 翻譯（ID {$existing}），跳過建立新文章。";

        // 做個語言 debug
        $lang_debug = [];
        foreach ( $translations as $code => $pid ) {
            $lang_debug[] = $code . ':' . $pid . '(' . pll_get_post_language( $pid ) . ')';
        }
        $report[] = '🧪 目前語言狀態：' . implode( ', ', $lang_debug );

        return $report;
    }

    // Step 2) 使用 wp_insert_post 建立新文章（官方建議做法）
    $new_id = wp_insert_post( [
        'post_type'      => $source_post->post_type,
        'post_status'    => $source_post->post_status,
        'post_title'     => $source_post->post_title,
        'post_content'   => $source_post->post_content,
        'post_excerpt'   => $source_post->post_excerpt,
        'post_author'    => $source_post->post_author,
        'post_date'      => $source_post->post_date,
        'post_date_gmt'  => $source_post->post_date_gmt,
        'menu_order'     => $source_post->menu_order,
    ], true );

    if ( is_wp_error( $new_id ) ) {
        $report[] = "❌ wp_insert_post 錯誤：" . $new_id->get_error_message();
        return $report;
    }
    $report[] = "Step 2) 建立新文章：{$new_id}";

    // Step 3) 官方建議：先設定新文章語言
    ir_set_lang_official( $new_id, $target_lang );
    $report[] = "Step 3) 設定新文章語言：{$new_id} → {$target_lang}";

    // Step 4) 官方建議：建立翻譯關聯（保留既有語言）
    $translations[ $target_lang ] = $new_id;
    pll_save_post_translations( $translations );
    $report[] = "Step 4) 儲存翻譯關聯：" . json_encode( $translations );

    // Step 5) 複製 taxonomy（排除語言 taxonomy，避免覆寫語言）
    $taxes = get_object_taxonomies( IR_POST_TYPE );
    $taxes = array_diff( $taxes, [ 'language', 'pll_language' ] );

    foreach ( $taxes as $tax ) {
        $terms = wp_get_object_terms( $source_id, $tax, [ 'fields' => 'ids' ] );
        if ( ! is_wp_error( $terms ) ) {
            wp_set_object_terms( $new_id, $terms, $tax, false );
        }
    }

    // Step 6) 複製特色圖片
    $thumb = get_post_thumbnail_id( $source_id );
    if ( $thumb ) {
        set_post_thumbnail( $new_id, $thumb );
    }

    // Step 7) 複製 ACF 欄位（包含上傳檔案）
    if ( function_exists( 'get_field_objects' ) && function_exists( 'update_field' ) ) {
        $fields = get_field_objects( $source_id );
        if ( $fields ) {
            foreach ( $fields as $field ) {
                update_field( $field['key'], $field['value'], $new_id );
            }
        }
    }

    // 最後：實際語言檢查
    $src_lang_real = pll_get_post_language( $source_id );
    $new_lang_real = pll_get_post_language( $new_id );

    $report[] = "🧪 實際語言檢查：原文 {$source_id} 語言：{$src_lang_real}；新文 {$new_id} 語言：{$new_lang_real}";
    $report[] = "✅ 完成：原文 {$source_id} → {$target_lang} 翻譯 {$new_id}";

    return $report;
}

這段程式碼示範如何在 WordPress 使用 MemberPress 交易完成事件鉤子，自動寄送訂閱方案的確認電子郵件。適合使用 MemberPress 管理會員訂閱，並希望自動化寄送付款成功通知的工程師或自學者。

交易完成事件監聽

透過 add_action 監聽 mepr-event-transaction-completed 事件，當交易完成時觸發自訂函式。函式內部先檢查事件與交易物件有效性，避免錯誤執行。

add_action('mepr-event-transaction-completed', function($event) {
  if(!is_object($event)) return;

  $txn = $event->get_data();
  if(!is_object($txn)) return;
  // ...
});

交易資料擷取與條件判斷

取得交易相關資訊如使用者 ID、方案 ID、交易 ID、付款狀態與金額，並做以下條件過濾：

• 使用者、方案、交易 ID 必須有效
• 交易狀態必須為 complete
• 可選擇只寄首次付款通知（此範例預設為每次付款皆寄）
• 防止重複寄送，透過交易文章 meta 標記

這些判斷確保只有有效且未重複的交易會觸發郵件寄送。

根據方案選擇郵件模板

根據方案 ID（範例中為 626 月付方案與 639 年付方案）選擇對應的郵件主旨與 HTML 內容。郵件內容包含隱藏文字供郵件摘要使用，以及簡潔的訂閱資訊與操作連結。

if($membership_id === 626) {
  $subject = $subject_626;
  $message = $message_626;
} elseif($membership_id === 639) {
  $subject = $subject_639;
  $message = $message_639;
} else {
  return;
}

寄送郵件與防重複標記

使用 WordPress 內建的 wp_mail 函式寄送 HTML 格式郵件，並在成功寄出後，透過 update_post_meta 設定交易文章的自訂 meta，避免重複寄信。

$headers = ['Content-Type: text/html; charset=UTF-8'];
$sent = wp_mail($user->user_email, $subject, $message, $headers);

if($sent) {
  update_post_meta($txn_id, '_custom_plan_email_sent', 'yes');
}

實務應用與優化建議

• 可依照不同方案擴充更多模板，提升客製化體驗
• 建議搭配會員資料完整性檢查，確保郵件內容正確
• 若有多語系需求，可整合翻譯函式動態產生郵件內容
• 透過設定參數控制是否只寄首次付款通知，靈活調整行銷策略

常見問題與注意事項

• 確認 MemberPress 交易狀態名稱是否與程式碼一致，避免漏寄
• 郵件內容中圖片 URL 請替換成實際可用路徑
• 測試時注意交易狀態與交易金額，避免誤寄測試郵件

完整程式碼

<?php
add_action('mepr-event-transaction-completed', function($event) {
  if(!is_object($event)) return;

  // true = 只寄首次；false = 每次扣款都寄
  $SEND_FIRST_PAYMENT_ONLY = false;

  $txn = $event->get_data();
  if(!is_object($txn)) return;

  // 交易基本資訊
  $user_id       = intval($txn->user_id ?? 0);
  $membership_id = intval($txn->product_id ?? 0);
  $txn_id        = intval($txn->id ?? 0); // MemberPress 交易文章 ID
  $total         = floatval($txn->total ?? 0);
  $status        = strval($txn->status ?? '');

  if($user_id <= 0 || $membership_id <= 0 || $txn_id <= 0) return;

  // 僅完成交易才寄（雙保險）
  if($status !== 'complete') return;

  // 避免 $0 交易（試用 / 全額折扣）也發信
//   if($total <= 0) return;

  // 只寄首次付款？
  if($SEND_FIRST_PAYMENT_ONLY === true && method_exists($txn,'is_first_payment') && !$txn->is_first_payment()) {
    return;
  }

  // 防重複寄送：用交易 ID 做旗標
  if(get_post_meta($txn_id, '_custom_plan_email_sent', true) === 'yes') {
    return;
  }

  $user = get_user_by('id', $user_id);
  if(!$user || empty($user->user_email)) return;

  $product_name = get_the_title($membership_id);

  // ===== 月付 626 =====
  $subject_626 = '感謝您購買 '.$product_name;
  $message_626 = <<<HTML
<div style="display: none; overflow: hidden; line-height: 1px; opacity: 0; max-height: 0; max-width: 0;">你已成功訂閱 。你的訂閱方案將會自動續訂：月付 $129，可隨時取消。</div>
<table style="width: 100%; background: #f5f6f8; margin: 0; padding: 0;" role="presentation">
<tr><td align="center">
<table style="width: 600px; margin: 0 auto;" role="presentation">
<tr><td style="padding: 0px 24px; background: #ffffff;" align="left">
<img src="" width="200" />
</td></tr>
<tr><td style="padding: 32px 24px; background: #ffffff; font-family: Helvetica, Arial, 'PingFang TC', 'Microsoft JhengHei', sans-serif; color: #111827;">
<table role="presentation" width="100%">
<tr><td valign="top" width="6">
<div style="width: 3px; height: 22px; background: #39A297; border-radius: 2px; margin-top: 6px;"></div>
</td>
<td style="padding-left: 10px;">
<p style="font-size: 16px; line-height: 1.75; margin: 0;">你已成功訂閱 <strong></strong> 。</p>
</td></tr></table>

<div style="height: 16px;"></div>
<p style="font-size: 16px; line-height: 1.75; margin: 0;">你的訂閱方案將會自動續訂：<strong>月付 $129</strong><br>你可以隨時取消。</p>

<div style="height: 16px;"></div>
<a style="background: #39A297; border-radius: 8px; padding: 12px 18px; display: inline-block; color: #ffffff; text-decoration: none;" href="https://.com/account/" target="_blank">點擊這裡登入</a>

<div style="height: 28px;"></div>
<p style="font-size: 14px; color: #6b7280;">如有任何問題，請於聯絡我們留言你的需求。</p>
<p style="font-size: 16px;"> 團隊</p>
</td></tr></table>
</td></tr></table>
HTML;

  // ===== 年付 639 =====
  $subject_639 = '感謝您購買 '.$product_name;
  $message_639 = <<<HTML
<div style="display: none;overflow: hidden;line-height: 1px;opacity: 0;max-height: 0;max-width: 0">你已成功訂閱 。你的訂閱方案將會自動續訂：年付 $1,290，可隨時取消。</div>
<table style="width: 100%;background: #f5f6f8;margin: 0;padding: 0" role="presentation">
<tr><td align="center">
<table style="width: 600px;margin: 0 auto" role="presentation">
<tr><td style="padding: 0 24px;background: #ffffff" align="left">
<img src="https://.com/wp-content/uploads/2025/10/forGoogleLogo.png" width="200" />
</td></tr>
<tr><td style="padding: 32px 24px;background: #ffffff;font-family: Helvetica, Arial, 'PingFang TC', 'Microsoft JhengHei', sans-serif;color: #111827">
<table role="presentation" width="100%"><tr><td valign="top" width="6">
<div style="width: 3px;height: 22px;background: #16a34a;border-radius: 2px;margin-top: 6px"></div>
</td>
<td style="padding-left: 10px">
<p style="font-size: 16px;line-height: 1.75;margin: 0">你已成功訂閱 <strong></strong> 。</p>
</td></tr></table>

<div style="height: 16px"></div>
<p style="font-size: 16px;line-height: 1.75;margin: 0">你的訂閱方案將會自動續訂：<strong>年付 $1,290</strong>
<br />你可以隨時取消。</p>

<div style="height: 16px"></div>
<p style="font-size: 16px;line-height: 1.75;margin: 0">別忘了到會員資訊裡留下你的收件資料，<br />讓我們能夠把贈品正確地寄送到你手上。</p>

<div style="height: 16px"></div>
<a style="background: #39A297;border-radius: 8px;padding: 12px 18px;display: inline-block;color: #ffffff;text-decoration: none" href="#" target="_blank">設定你的收件資料</a>

<div style="height: 28px"></div>
<p style="font-size: 14px;color: #6b7280;">如有任何問題，請於聯絡我們留言你的需求。</p>
<p style="font-size: 16px;"> 團隊</p>
</td></tr></table>
</td></tr></table>
HTML;

  // 套用對應模板
  if($membership_id === 626) {
    $subject = $subject_626;
    $message = $message_626;
  } elseif($membership_id === 639) {
    $subject = $subject_639;
    $message = $message_639;
  } else {
    return;
  }

  // 寄送
  $headers = ['Content-Type: text/html; charset=UTF-8'];
  $sent = wp_mail($user->user_email, $subject, $message, $headers);

  // 設定防重複旗標（只有寄成功才標記）
  if($sent) {
    update_post_meta($txn_id, '_custom_plan_email_sent', 'yes');
  }
});

這段 PHP 程式碼主要用於 WordPress 的 MemberPress 外掛會員管理頁面，目的是在會員列表中新增電話、地址、贈品寄送狀態及一鍵複製欄位。適合需要擴充會員管理功能、提升後台操作效率的工程師與自學者。

新增會員列表欄位表頭

透過 mepr-admin-members-cols 過濾器，將電話、地址、贈品已寄送與複製按鈕四個欄位加入會員列表的表頭。這樣可以讓後台管理員一目了然看到更多會員資訊。

add_filter('mepr-admin-members-cols', function($cols){
  $cols['mepr_phone']   = __('電話', 'memberpress');
  $cols['mepr_address'] = __('地址', 'memberpress');
  $cols['mepr_sent']    = __('贈品已寄送', 'memberpress');
  $cols['mepr_copy']    = __('複製', 'memberpress');
  return $cols;
});

渲染會員列表每列的欄位內容

使用 mepr_members_list_table_row 過濾器，依照欄位名稱輸出對應的會員資料：

• 電話與地址從使用者 meta 取得，地址欄位會截斷顯示並加上完整 tooltip。
• 贈品已寄送欄位為 checkbox，狀態可即時切換並透過 AJAX 更新。
• 複製欄位提供一鍵複製會員姓名、電話與地址的功能，方便快速取得會員聯絡資訊。

add_filter('mepr_members_list_table_row', function($attributes, $rec, $column_name, $column_display_name){
  $user = get_user_by('login', $rec->username);
  if(!$user){ return; }

  $first = get_user_meta($user->ID, 'first_name', true);
  $last  = get_user_meta($user->ID, 'last_name', true);
  $full  = trim(implode(' ', array_filter([$first, $last])));
  if($full === '') { $full = $user->display_name ?: $user->user_login; }

  $phone = get_user_meta($user->ID, 'mepr_phone', true);
  $addr  = get_user_meta($user->ID, 'mepr_address', true);

  if($column_name === 'mepr_phone'){
    echo '<td '.$attributes.'>'.esc_html($phone ?: '—').'</td>';
  }

  if($column_name === 'mepr_address'){
    $short = mb_strimwidth(wp_strip_all_tags((string)$addr), 0, 80, '…', 'UTF-8');
    echo '<td '.$attributes.' title="'.esc_attr($addr).'">'.esc_html($short ?: '—').'</td>';
  }

  if($column_name === 'mepr_sent'){
    $checked = get_user_meta($user->ID, 'mepr_sent', true) ? 'checked' : '';
    $nonce   = wp_create_nonce('mepr_sent_nonce');
    echo '<td '.$attributes.' style="text-align:center">
      <label style="display:inline-flex;align-items:center;gap:.4em;cursor:pointer;">
        <input type="checkbox" class="mepr-sent-toggle"
               data-user="'.esc_attr($user->ID).'"
               data-nonce="'.esc_attr($nonce).'" '.$checked.' />
        <span>'.($checked ? esc_html__('Yes','memberpress') : esc_html__('No','memberpress')).'</span>
      </label>
    </td>';
  }

  if($column_name === 'mepr_copy'){
    $copy_text = "Full Name: {$full}\nPhone: " . ($phone ?: '') . "\nAddress: " . ($addr ? wp_strip_all_tags($addr) : '');
    echo '<td '.$attributes.' style="text-align:center">
      <button type="button" class="button button-small mepr-copy-btn"
              data-copy="'.esc_attr($copy_text).'"
              title="'.esc_attr__('Copy Full Name / Phone / Address','memberpress').'">
        '.esc_html__('複製','memberpress').'
      </button>
    </td>';
  }
}, 10, 4);

後台頁尾加入 JavaScript 強化互動

透過 admin_print_footer_scripts 動作，在會員頁面插入 JavaScript：

• 切換「贈品已寄送」checkbox 時，使用 AJAX 非同步更新後端資料，並即時更新 UI 狀態。
• 複製按鈕則利用 Clipboard API 或備援方案將會員資訊複製到剪貼簿，並顯示複製成功提示。

此設計提升管理者操作便利性，避免頻繁刷新頁面。

AJAX 後端處理贈品寄送狀態更新

使用 wp_ajax_mepr_toggle_sent 來驗證權限與 nonce，確保安全後更新使用者 meta。若驗證失敗或使用者不存在，會回傳錯誤訊息。

add_action('wp_ajax_mepr_toggle_sent', function(){
  if( ! current_user_can('manage_options') ){
    wp_send_json_error(['message' => '無權限'], 403);
  }
  if( ! check_ajax_referer('mepr_sent_nonce', '_wpnonce', false) ){
    wp_send_json_error(['message' => 'Nonce 驗證失敗'], 400);
  }
  $user_id = isset($_POST['user_id']) ? absint($_POST['user_id']) : 0;
  $value   = isset($_POST['value']) ? sanitize_text_field($_POST['value']) : '0';
  if( !$user_id || ! get_user_by('id', $user_id) ){
    wp_send_json_error(['message' => '使用者不存在'], 404);
  }
  update_user_meta($user_id, 'mepr_sent', $value === '1' ? 1 : 0);
  wp_send_json_success(['nonce' => wp_create_nonce('mepr_sent_nonce')]);
});

簡單的後台樣式調整

為了讓新增欄位版面更整齊，使用 admin_head 動作插入 CSS，調整欄寬與置中對齊。

實務應用與延伸

這套擴充方案適合需要在 MemberPress 後台快速查看會員詳細聯絡資訊並標記贈品寄送狀態的情境。未來可延伸加入更多欄位或改為前端 AJAX 分頁載入，提升大會員數的效能。

常見問題與注意事項

• AJAX 權限與 nonce 驗證不可少，避免安全漏洞。
• 複製功能在非 HTTPS 或不支援 Clipboard API 的環境會退回使用 textarea 方案。
• 地址欄位截斷避免版面過長，但完整資料仍可透過 tooltip 查看。

完整程式碼

<?php
/**
 * MemberPress Members 列表欄位：電話/地址/贈品已寄送/複製（可即時切換）
 * 放 WPCode（PHP Snippet，Run Everywhere）
 */

/* === 1) 新增欄位表頭（mepr-admin-members-cols） === */
add_filter('mepr-admin-members-cols', function($cols){
  $cols['mepr_phone']   = __('電話', 'memberpress');
  $cols['mepr_address'] = __('地址', 'memberpress');
  $cols['mepr_sent']    = __('贈品已寄送', 'memberpress');
  $cols['mepr_copy']    = __('複製', 'memberpress'); // 一鍵複製按鈕
  return $cols;
});

/* === 2) 渲染每一列內容（mepr_members_list_table_row） === */
add_filter('mepr_members_list_table_row', function($attributes, $rec, $column_name, $column_display_name){
  $user = get_user_by('login', $rec->username);
  if(!$user){ return; }

  // 共用：取 Full Name / Phone / Address
  $first = get_user_meta($user->ID, 'first_name', true);
  $last  = get_user_meta($user->ID, 'last_name', true);
  $full  = trim(implode(' ', array_filter([$first, $last])));
  if($full === '') { $full = $user->display_name ?: $user->user_login; }

  $phone = get_user_meta($user->ID, 'mepr_phone', true);
  $addr  = get_user_meta($user->ID, 'mepr_address', true);

  if($column_name === 'mepr_phone'){
    echo '<td '.$attributes.'>'.esc_html($phone ?: '—').'</td>';
  }

  if($column_name === 'mepr_address'){
    $short = mb_strimwidth(wp_strip_all_tags((string)$addr), 0, 80, '…', 'UTF-8');
    echo '<td '.$attributes.' title="'.esc_attr($addr).'">'.esc_html($short ?: '—').'</td>';
  }

  if($column_name === 'mepr_sent'){
    $checked = get_user_meta($user->ID, 'mepr_sent', true) ? 'checked' : '';
    $nonce   = wp_create_nonce('mepr_sent_nonce');
    echo '<td '.$attributes.' style="text-align:center">
      <label style="display:inline-flex;align-items:center;gap:.4em;cursor:pointer;">
        <input type="checkbox" class="mepr-sent-toggle"
               data-user="'.esc_attr($user->ID).'"
               data-nonce="'.esc_attr($nonce).'" '.$checked.' />
        <span>'.($checked ? esc_html__('Yes','memberpress') : esc_html__('No','memberpress')).'</span>
      </label>
    </td>';
  }

  if($column_name === 'mepr_copy'){
    $copy_text = "Full Name: {$full}\nPhone: " . ($phone ?: '') . "\nAddress: " . ($addr ? wp_strip_all_tags($addr) : '');
    echo '<td '.$attributes.' style="text-align:center">
      <button type="button" class="button button-small mepr-copy-btn"
              data-copy="'.esc_attr($copy_text).'"
              title="'.esc_attr__('Copy Full Name / Phone / Address','memberpress').'">
        '.esc_html__('複製','memberpress').'
      </button>
    </td>';
  }
}, 10, 4);

/* === 3) 後台頁尾插入 JS（僅 Members 頁） === */
add_action('admin_print_footer_scripts', function(){
  if( ! is_admin() ) return;
  if( ! (isset($_GET['page']) && $_GET['page'] === 'memberpress-members') ) return;

  $ajax_url = admin_url('admin-ajax.php');
  ?>
  <script>
  (function(){
    // 已寄送：切換寫入
    function setSentLabel(td, checked){
      var s = td.querySelector('span');
      if(s){ s.textContent = checked ? 'Yes' : 'No'; }
    }

    document.addEventListener('change', function(e){
      var el = e.target;
      if(!el.classList.contains('mepr-sent-toggle')) return;

      var td    = el.closest('td');
      var uid   = el.getAttribute('data-user');
      var nonce = el.getAttribute('data-nonce');
      var val   = el.checked ? '1' : '0';
      setSentLabel(td, el.checked); // 先行更新 UI

      var xhr = new XMLHttpRequest();
      var fd = new FormData();
      fd.append('action', 'mepr_toggle_sent');
      fd.append('user_id', uid);
      fd.append('value', val);
      fd.append('_wpnonce', nonce);
      xhr.open('POST', '<?php echo esc_js($ajax_url); ?>', true);
      xhr.onreadystatechange = function(){
        if(xhr.readyState === 4){
          try{
            var res = JSON.parse(xhr.responseText||'{}');
            if(!res.success){
              el.checked = !el.checked; setSentLabel(td, el.checked);
              alert(res.data && res.data.message ? res.data.message : '更新失敗');
            }else if(res.data && res.data.nonce){
              el.setAttribute('data-nonce', res.data.nonce);
            }
          }catch(err){
            el.checked = !el.checked; setSentLabel(td, el.checked);
            alert('伺服器回應格式錯誤');
          }
        }
      };
      xhr.send(fd);
    }, false);

    // 一鍵複製
    document.addEventListener('click', async function(e){
      var btn = e.target.closest('.mepr-copy-btn');
      if(!btn) return;
      var text = btn.getAttribute('data-copy') || '';
      try{
        if(navigator.clipboard && window.isSecureContext){
          await navigator.clipboard.writeText(text);
        }else{
          var ta = document.createElement('textarea');
          ta.value = text;
          ta.style.position = 'fixed';
          ta.style.opacity = '0';
          document.body.appendChild(ta);
          ta.focus();
          ta.select();
          document.execCommand('copy');
          document.body.removeChild(ta);
        }
        btn.classList.add('mepr-copied');
        btn.textContent = '已複製';
        setTimeout(function(){ btn.classList.remove('mepr-copied'); btn.textContent = '複製'; }, 1200);
      }catch(err){
        alert('複製失敗，請手動複製。\n\n' + text);
      }
    }, false);
  })();
  </script>
  <?php
});

/* === 4) AJAX 後端：儲存 mepr_sent === */
add_action('wp_ajax_mepr_toggle_sent', function(){
  if( ! current_user_can('manage_options') ){
    wp_send_json_error(['message' => '無權限'], 403);
  }
  if( ! check_ajax_referer('mepr_sent_nonce', '_wpnonce', false) ){
    wp_send_json_error(['message' => 'Nonce 驗證失敗'], 400);
  }
  $user_id = isset($_POST['user_id']) ? absint($_POST['user_id']) : 0;
  $value   = isset($_POST['value']) ? sanitize_text_field($_POST['value']) : '0';
  if( !$user_id || ! get_user_by('id', $user_id) ){
    wp_send_json_error(['message' => '使用者不存在'], 404);
  }
  update_user_meta($user_id, 'mepr_sent', $value === '1' ? 1 : 0);
  wp_send_json_success(['nonce' => wp_create_nonce('mepr_sent_nonce')]);
});

/* === 5) 簡單樣式 === */
add_action('admin_head', function(){
  if( ! (isset($_GET['page']) && $_GET['page'] === 'memberpress-members') ) return;
  echo '
<style>
    th#mepr_phone{width:140px}
    th#mepr_address{width:260px}
    th#mepr_sent{width:110px;text-align:center}
    th#mepr_copy{width:90px;text-align:center}
    td.column-mepr_sent, td.column-mepr_copy{text-align:center}
    .mepr-copy-btn.button-small{line-height:22px;height:24px;padding:0 8px}
    .mepr-copy-btn.mepr-copied{opacity:.8}
  </style>';
});

在使用 WordPress 的 Gutenberg 編輯器時，預設的區塊寬度可能不符合特定網站設計需求，尤其是針對文章（post）類型。這段程式碼示範如何透過後台樣式調整，限制文章區塊的最大寬度，讓編輯介面更貼近前端顯示效果，適合想優化編輯體驗的開發者與自學者。

為什麼要調整 Gutenberg 編輯器的區塊寬度？

Gutenberg 編輯器的區塊寬度預設較寬，可能導致編輯時排版與前端顯示不一致，影響內容編輯的直觀感受。透過限制最大寬度，可以讓編輯時的視覺效果更接近實際網站呈現，減少排版錯誤。

程式碼解析

1. 透過 admin_head 動作掛載自訂樣式

add_action( 'admin_head', 'custom_post_gutenberg_editor_width' );

這行程式碼將自訂函式掛載到 WordPress 後台的 head 區塊，確保樣式只在後台生效。

2. 目標限定為文章(post)類型的區塊

.post-type-post .wp-block {
    max-width: 600px !important;
}

這段 CSS 限制所有文章類型的區塊最大寬度為 600px，避免編輯器區塊過寬。

3. 調整 “wide” 對齊方式的寬度

.post-type-post .wp-block[data-align="wide"] {
    max-width: 600px !important;
}

將 “wide” 對齊的區塊同樣限制在 600px，避免因預設寬度過寬而影響排版。

4. 保留 “full” 對齊的全寬效果

.post-type-post .wp-block[data-align="full"] {
    max-width: none !important;
}

讓 “full” 對齊的區塊維持編輯器全寬，符合使用者預期的全屏展示。

實務應用與延伸

• 可依需求調整 max-width 數值，配合網站前端設計寬度。
• 若需針對其他自訂文章類型，也可複製此函式並修改 .post-type-post 選擇器。
• 若想更細緻控制不同區塊類型寬度，可增加更多 CSS 選擇器與規則。

常見問題與注意事項

• 使用 !important 是為了覆蓋 Gutenberg 預設樣式，避免無效。
• 此方法只影響後台編輯器，不會改變前端顯示。
• 若有快取或 CSS 優先權問題，請清除快取或調整掛載優先順序。

完整程式碼

<?php
function custom_post_gutenberg_editor_width() {
    echo '
<style>
        /* Target ONLY the standard "post" post type in the editor */
        .post-type-post .wp-block {
            max-width: 600px !important; 
        }

        /* Optionally, set the "wide" alignment to the same narrow width */
        .post-type-post .wp-block[data-align="wide"] {
            max-width: 600px !important; 
        }

        /* Ensure "full" alignment still goes full width of the editor screen */
        .post-type-post .wp-block[data-align="full"] {
            max-width: none !important;
        }
    </style>';
}
add_action( 'admin_head', 'custom_post_gutenberg_editor_width' );

在使用 WordPress 搭配會員管理外掛 MemberPress 時，常見需求是判斷文章是否有設定存取權限，並將此狀態同步到自訂欄位（ACF）中，方便前端或查詢邏輯使用。這段程式碼示範如何在文章儲存時自動檢查 MemberPress 的存取規則，並更新 ACF 的 True/False 欄位，適合熟悉 WordPress 開發並使用 MemberPress 與 ACF 的工程師。

文章儲存時自動同步存取權限

透過 save_post 鉤子，在文章儲存或更新時觸發檢查。程式碼會先排除自動儲存與修訂版本，避免重複執行。接著確認文章類型是否為支援的 post 或 page，並檢查 MemberPress 與 ACF 是否存在。

重要程式碼片段

if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
    return;
}

$post_type = get_post_type($post_id);
if (!in_array($post_type, array('post', 'page'))) {
    return;
}

if (!class_exists('MeprRule') || !function_exists('update_field')) {
    return;
}

接著使用 MeprRule::get_rules($post) 取得該文章的 MemberPress 存取規則，判斷是否有規則存在，並更新 ACF 的 ks_post_access 欄位。

$rules = MeprRule::get_rules($post);
$has_rule = !empty($rules);

update_field('ks_post_access', $has_rule, $post_id);

當 MemberPress 規則變更時批次更新所有文章

除了單篇文章儲存時更新，也會在 MemberPress 規則新增、修改或刪除時觸發批次更新所有文章的存取狀態，確保資料一致。

function ks_update_all_posts_access_status() {
    if (!function_exists('update_field')) {
        return;
    }
    $posts = get_posts(array(
        'post_type' => 'post',
        'post_status' => 'publish',
        'numberposts' => -1,
        'fields' => 'ids'
    ));
    foreach ($posts as $post_id) {
        $post = get_post($post_id);
        $rules = MeprRule::get_rules($post);
        $has_rule = !empty($rules);
        update_field('ks_post_access', $has_rule, $post_id);
    }
}

後台介面批次更新功能

為方便管理，新增 WordPress 後台子選單，讓管理者可以手動觸發更新所有文章的存取權限狀態，並提供操作說明。

function ks_add_bulk_update_access_status() {
    add_submenu_page(
        'edit.php',
        'Update Access Status',
        'Update Access Status',
        'manage_options',
        'ks-bulk-update-access-status',
        'ks_bulk_update_access_status_page'
    );
}
add_action('admin_menu', 'ks_add_bulk_update_access_status');

介面中包含按鈕與確認提示，確保操作安全。

實務應用與延伸

• 透過 ACF 的 ks_post_access 欄位，前端查詢可以輕鬆過濾有存取限制的文章。
• 可結合 GreenShift Query Loop 或其他查詢工具，提升前端顯示效率。
• 若會員規則較複雜，建議優化批次更新邏輯，避免效能瓶頸。
• 可加入快取機制或非同步處理，減少儲存時的阻塞。

常見問題與注意事項

• 請確保已建立名為 ks_post_access 的 True/False ACF 欄位，且欄位名稱與程式碼一致。
• 若 MemberPress 或 ACF 外掛未啟用，程式會自動跳過，避免錯誤。
• 批次更新文章時，若文章數量龐大，可能會耗時較久，建議在低流量時段執行。

完整程式碼

<?php
// 在文章儲存/更新時自動檢查並更新 ACF 欄位
function ks_update_mepr_access_status($post_id) {
    // 避免自動儲存時執行
    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
        return;
    }

    // 檢查是否為支援的文章類型
    $post_type = get_post_type($post_id);
    if (!in_array($post_type, array('post', 'page'))) {
        return;
    }

    // 檢查是否有 MemberPress 和 ACF
    if (!class_exists('MeprRule') || !function_exists('update_field')) {
        return;
    }

    $post = get_post($post_id);
    if (!$post) {
        return;
    }

    // 檢查該文章是否有 MemberPress 規則
    $rules = MeprRule::get_rules($post);
    $has_rule = !empty($rules);

    // 更新 ACF 欄位
    update_field('ks_post_access', $has_rule, $post_id);

    // 可選：記錄 log 用於除錯
    error_log("KS Post ID: $post_id - Access Rule Status: " . ($has_rule ? 'Yes' : 'No'));
}

// 掛載到文章儲存的 hook
add_action('save_post', 'ks_update_mepr_access_status', 20, 1);

// 也可以掛載到 MemberPress 規則更新時
add_action('mepr-rule-saved', 'ks_update_all_posts_access_status');
add_action('mepr-rule-deleted', 'ks_update_all_posts_access_status');

// 當 MemberPress 規則變更時，更新所有相關文章
function ks_update_all_posts_access_status() {
    if (!function_exists('update_field')) {
        return;
    }

    $posts = get_posts(array(
        'post_type' => 'post',
        'post_status' => 'publish',
        'numberposts' => -1,
        'fields' => 'ids'
    ));

    foreach ($posts as $post_id) {
        $post = get_post($post_id);
        $rules = MeprRule::get_rules($post);
        $has_rule = !empty($rules);

        update_field('ks_post_access', $has_rule, $post_id);
    }
}

// 管理後台增加批量更新功能
function ks_add_bulk_update_access_status() {
    add_submenu_page(
        'edit.php',
        'Update Access Status',
        'Update Access Status',
        'manage_options',
        'ks-bulk-update-access-status',
        'ks_bulk_update_access_status_page'
    );
}
add_action('admin_menu', 'ks_add_bulk_update_access_status');

function ks_bulk_update_access_status_page() {
    if (isset($_POST['ks_update_all'])) {
        ks_update_all_posts_access_status();
        echo '<div class="notice notice-success"><p>所有文章的存取權限狀態已更新完成！</p></div>';
    }

    ?>
    <div class="wrap">

<h1>KS 更新文章存取權限狀態</h1>

<p>此功能會檢查所有文章的 MemberPress 存取權限設定，並更新對應的 ACF 欄位。</p>

        <form method="post">
            <input type="submit" name="ks_update_all" class="button-primary" value="更新所有文章狀態" 
                   onclick="return confirm('確定要更新所有文章的存取權限狀態嗎？');">
        </form>
    </div>
    <?php
}