在多語網站開發中，使用 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;
}

這段 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 時，常見需求是判斷文章是否有設定存取權限，並將此狀態同步到自訂欄位（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
}

在 WordPress 開發中，有時候需要自動從文章內容擷取一部分作為預覽，方便在前台或後台顯示摘要。這段程式碼示範如何利用 PHP 的 DOMDocument 解析文章 HTML，並將第一個區塊內容存入自訂欄位，適合希望自動管理文章預覽的開發者或自學者。

主要功能說明

這段程式碼的核心目標是：

• 避免在自動儲存或文章修訂版本時重複執行
• 只處理文章(post)類型
• 取得文章內容並套用 WordPress 內建的內容過濾器（the_content）
• 使用 DOMDocument 將 HTML 內容解析為節點樹
• 擷取第一個 HTML 區塊（元素節點）作為預覽內容
• 將擷取結果寫入 Advanced Custom Fields (ACF) 的自訂欄位

這樣的設計能確保預覽內容是有效的 HTML 片段，且不會因為純文字截斷而破壞標籤結構。

程式碼解析

避免不必要的觸發

if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
if (wp_is_post_revision($post_id)) return;

這兩個判斷用來避免在 WordPress 自動儲存或文章修訂版本時執行預覽生成，減少不必要的資源消耗。

文章類型與內容驗證

$post = get_post($post_id);
if ($post->post_type !== 'post') return;
$content = $post->post_content;
if (empty($content)) return;

確保只處理標準文章(post)，且內容不為空。

套用內容過濾器

$filtered_content = apply_filters('the_content', $content);

這步驟會讓內容經過 WordPress 內建的過濾器處理，例如短碼解析、自動換行等，確保後續解析的 HTML 是完整且符合前台顯示的狀態。

使用 DOMDocument 解析 HTML

libxml_use_internal_errors(true);
$doc = new DOMDocument();
$doc->loadHTML('<?xml encoding="utf-8" ?>' . $filtered_content);
libxml_clear_errors();

因為 HTML 可能不完全符合 XML 規範，先抑制 libxml 錯誤，並在字串前加上 XML 編碼宣告，確保 UTF-8 正確處理。

擷取第一個區塊元素

$body = $doc->getElementsByTagName('body')->item(0);
$output_blocks = [];
$count = 0;
$max_blocks = 1;

foreach ($body->childNodes as $node) {
    if ($node->nodeType === XML_ELEMENT_NODE) {
        $output_blocks[] = $doc->saveHTML($node);
        $count++;
        if ($count >= $max_blocks) break;
    }
}

$preview_html = implode("\n", $output_blocks);

這段程式碼從 body 標籤下取得第一個元素節點（例如第一個段落或區塊標籤），並將其轉成 HTML 字串。這樣做的好處是避免截取不完整的 HTML，保持標籤結構完整。

寫入自訂欄位

update_field('ks_post_preview', $preview_html, $post_id);

利用 ACF 提供的 update_field 函式，將預覽內容寫入名為 ks_post_preview 的自訂欄位，方便後續在前台或後台調用。

實務應用與優化建議

• 可依需求調整 $max_blocks 參數，擷取多個區塊作為預覽
• 若文章內容包含複雜結構，DOMDocument 解析可確保 HTML 不會因截斷而破損
• 可結合 WordPress 的鉤子（如 save_post）自動更新預覽，減少手動維護成本
• 注意 ACF 欄位名稱需與後台設定一致，否則無法成功更新

常見問題與注意事項

• DOMDocument 解析 HTML 時可能因不標準標籤產生警告，使用 libxml_use_internal_errors 可避免影響
• 若文章內容過短或無有效區塊，預覽欄位可能為空，需在前端做好容錯處理
• 自動儲存與修訂版本判斷是避免重複觸發的關鍵，缺少可能導致效能問題

完整程式碼

<?php
function ks_generate_post_preview($post_id) {
    // 避免自動儲存時觸發
    if (defined('DOING_AUTOSAVE') && DOING_AUTOSAVE) return;
    if (wp_is_post_revision($post_id)) return;

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

    $content = $post->post_content;
    if (empty($content)) return;

    // 套用 the_content 濾鏡
    $filtered_content = apply_filters('the_content', $content);

    // 使用 DOMDocument 分析 HTML
    libxml_use_internal_errors(true);
    $doc = new DOMDocument();
    $doc->loadHTML('<?xml encoding="utf-8" ?>' . $filtered_content);
    libxml_clear_errors();

    $body = $doc->getElementsByTagName('body')->item(0);
    $output_blocks = [];
    $count = 0;
    $max_blocks = 1;

    foreach ($body->childNodes as $node) {
        if ($node->nodeType === XML_ELEMENT_NODE) {
            $output_blocks[] = $doc->saveHTML($node);
            $count++;
            if ($count >= $max_blocks) break;
        }
    }

    $preview_html = implode("\n", $output_blocks);

    // 寫入 ACF 欄位
    update_field('ks_post_preview', $preview_html, $post_id);
}
add_action('save_post', 'ks_generate_post_preview');

在 WordPress 網站中，常見需求是當新會員註冊時，自動建立一篇專屬於該會員的自訂文章類型（Custom Post Type, CPT），例如會員介紹頁面。本文適合具備基本 WordPress 開發經驗的工程師或自學者，說明如何利用 user_register Hook 自動建立 member_info 文章，並設定內容與 ACF 欄位。

註冊 member_info 自訂文章類型

首先，必須在主題的 functions.php 中註冊 member_info 這個自訂文章類型。以下程式碼會在 WordPress 初始化時執行：

function register_member_info_post_type() {
  $args = array(
    'labels' => array(
      'name' => '會員資訊',
      'singular_name' => '會員資訊'
    ),
    'public' => true,
    'has_archive' => true,
    'supports' => array('title', 'editor', 'author'),
    'rewrite' => array('slug' => 'member-info'),
  );
  register_post_type('member_info', $args);
}
add_action('init', 'register_member_info_post_type');

此段程式碼會建立一個公開且有存檔頁的 CPT，並支援標題、內容編輯器與作者欄位。

自動建立會員資訊文章

接著，利用 user_register Hook 監聽新會員註冊事件，當會員註冊時自動建立一篇 member_info 文章，並填入預設內容與 ACF 欄位：

function ks_create_member_info_post($user_id) {
  $user = get_userdata($user_id);
  $display_name = $user->display_name;
  $post_title = $display_name;

  $post_content = '

  <h3 class="wp-block-heading"><strong>經歷</strong>（公開資訊）</h3>

<p>公開資訊</p>

  <h3 class="wp-block-heading"><strong>專長</strong>（公開資訊）</h3>

<p>公開資訊</p>
  ';

  $post_data = array(
    'post_title' => $post_title,
    'post_content' => $post_content,
    'post_status' => 'publish',
    'post_author' => $user_id,
    'post_type' => 'member_info',
  );

  $post_id = wp_insert_post($post_data);

  if ($post_id) {
    update_field('member_content', '登入會員限定內容', $post_id);
    update_field('member_current_position', '目前任職', $post_id);
    update_field('member_experience', '（公開資訊區）<br>信箱、網站、學歷、學號？', $post_id);
  }
}
add_action('user_register', 'ks_create_member_info_post');

此函式會取得新會員的顯示名稱作為文章標題，並用 Gutenberg 格式設定文章內容。若有安裝 Advanced Custom Fields，則會填入指定欄位的預設值。

程式碼說明

• user_register Hook：會員註冊時觸發，執行自動建立文章函式。
• get_userdata($user_id)：取得會員資料。
• wp_insert_post()：建立自訂文章並回傳文章 ID。
• Gutenberg 內容格式：使用區塊編輯器標記語法，方便未來編輯。
• ACF 欄位設定：透過 update_field() 填入預設值，需先安裝並啟用 ACF 外掛。

確保程式運作正確

• 確認 member_info CPT 已成功註冊並可在後台管理。
• 確認 Advanced Custom Fields 外掛已啟用，且欄位名稱正確。
• 測試新會員註冊流程，並檢查「會員資訊」文章是否自動產生。

延伸應用與常見坑

• 若需更多欄位，可在 ACF 中擴充並同步更新 update_field()。
• 若會員資料需同步更新文章，可監聽 profile_update Hook。
• 注意文章內容格式需符合 Gutenberg 區塊語法，避免前端顯示異常。

完整程式碼

function register_member_info_post_type() {
  $args = array(
    'labels' => array(
      'name' => '會員資訊',
      'singular_name' => '會員資訊'
    ),
    'public' => true,
    'has_archive' => true,
    'supports' => array('title', 'editor', 'author'),
    'rewrite' => array('slug' => 'member-info'),
  );
  register_post_type('member_info', $args);
}
add_action('init', 'register_member_info_post_type');

function ks_create_member_info_post($user_id) {
  $user = get_userdata($user_id);
  $display_name = $user->display_name;
  $post_title = $display_name;

  $post_content = '

  <h3 class="wp-block-heading"><strong>經歷</strong>（公開資訊）</h3>

<p>公開資訊</p>

  <h3 class="wp-block-heading"><strong>專長</strong>（公開資訊）</h3>

<p>公開資訊</p>
  ';

  $post_data = array(
    'post_title' => $post_title,
    'post_content' => $post_content,
    'post_status' => 'publish',
    'post_author' => $user_id,
    'post_type' => 'member_info',
  );

  $post_id = wp_insert_post($post_data);

  if ($post_id) {
    update_field('member_content', '登入會員限定內容', $post_id);
    update_field('member_current_position', '目前任職', $post_id);
    update_field('member_experience', '（公開資訊區）<br>信箱、網站、學歷、學號？', $post_id);
  }
}
add_action('user_register', 'ks_create_member_info_post');