技術筆記 – 小豬日常

使用 Firebase Firestore 匯出抽獎資料為 CSV 檔案的實作說明

小豬 — Fri, 02 Jan 2026 22:20:44 +0000

前言

本篇文章介紹如何在 PHP 環境中結合 Firebase Firestore，實作一個前端按鈕匯出抽獎資料為 CSV 檔案的功能。此功能適合需要將 Firestore 資料批次匯出，並提供給非技術人員下載的場景。讀者需具備基本 PHP 與 JavaScript 知識，並了解 Firebase Firestore 的基本操作。

Firebase 初始化與匿名登入

在前端使用 Firebase SDK，首先透過 initializeApp 初始化 Firebase，並使用匿名登入 (signInAnonymously) 取得存取 Firestore 的權限。這樣做可以避免在伺服器端直接操作 Firebase，減少安全風險。

const app = initializeApp(firebaseConfig);
const auth = getAuth(app);
await signInAnonymously(auth);
const db = getFirestore(app);

分頁抓取 Firestore 資料

Firestore 資料量可能很大，因此使用分頁查詢避免一次讀取過多資料造成效能問題。透過 orderBy("__name__") 與 startAfter 搭配 limit，逐頁取得資料直到抓完為止。

async function fetchAllEntriesPaged(db, pageSize = 500) {
  const colRef = collection(db, ENTRY_COLLECTION_PATH);
  let all = [];
  let lastDoc = null;
  while (true) {
    let q = query(colRef, orderBy("__name__"), limit(pageSize));
    if (lastDoc) q = query(colRef, orderBy("__name__"), startAfter(lastDoc), limit(pageSize));
    const snap = await getDocs(q);
    if (snap.empty) break;
    snap.forEach(d => all.push({ id: d.id, ...d.data() }));
    lastDoc = snap.docs[snap.docs.length - 1];
    if (snap.size < pageSize) break;
  }
  return all;
}

CSV 格式處理與下載

匯出 CSV 需要將資料轉成符合格式的字串，並處理特殊字元（如逗號、雙引號、換行）。csvEscape 函式負責這部分。下載時利用 Blob 物件與 URL.createObjectURL 產生可下載的連結。

function csvEscape(val) {
  if (val === null || val === undefined) return "";
  const s = String(val);
  if (/[",\n\r]/.test(s)) return `"${s.replace(/"/g, '""')}"`;
  return s;
}

function downloadCSV(lines, filename) {
  const csv = "\uFEFF" + lines.join("\r\n");
  const blob = new Blob([csv], { type: "text/csv;charset=utf-8;" });
  const url = URL.createObjectURL(blob);
  const a = document.createElement("a");
  a.href = url;
  a.download = filename;
  document.body.appendChild(a);
  a.click();
  a.remove();
  URL.revokeObjectURL(url);
}

時間戳記格式轉換

Firestore 的時間欄位格式特殊，可能是 Timestamp 物件或其他形式，透過 tsToISO 函式統一轉成 ISO 8601 字串，方便 CSV 讀取與後續處理。

function tsToISO(v) {
  try {
    if (!v) return "";
    if (typeof v.toDate === "function") return v.toDate().toISOString();
    if (typeof v.seconds === "number") return new Date(v.seconds * 1000).toISOString();
    return String(v);
  } catch {
    return "";
  }
}

實作匯出流程

按下「下載 CSV」按鈕後，觸發 runExport 函式，依序完成初始化、登入、資料分頁抓取、CSV 組合、下載檔案與狀態更新。過程中會禁用按鈕避免重複點擊，並顯示目前狀態。

async function runExport() {
  $status.textContent = "";
  $btn.disabled = true;
  $btn.textContent = "匯出中...";
  try {
    const app = initializeApp(firebaseConfig);
    const auth = getAuth(app);
    await signInAnonymously(auth);
    const db = getFirestore(app);
    $status.textContent = "正在抓取資料...";
    const rows = await fetchAllEntriesPaged(db, 500);
    if (!rows.length) {
      $status.textContent = "沒有任何資料可匯出。";
      return;
    }
    const headers = ["docId", "name", "classroom", "teacher", "entryDate", "entryNumber", "isWinner", "drawTime", "drawnBy", "createdAt", "updatedAt"];
    const lines = [];
    lines.push(headers.map(csvEscape).join(","));
    for (const r of rows) {
      const line = [
        r.id ?? "",
        r.name ?? "",
        r.classroom ?? "",
        r.teacher ?? "",
        r.entryDate ?? "",
        r.entryNumber ?? "",
        (r.isWinner === true) ? "true" : "false",
        r.drawTime ?? "",
        r.drawnBy ?? "",
        tsToISO(r.createdAt),
        tsToISO(r.updatedAt),
      ].map(csvEscape).join(",");
      lines.push(line);
    }
    const filename = `christmas_raffle_entries_${getTodayDate()}.csv`;
    downloadCSV(lines, filename);
    $status.textContent = `匯出完成：共 ${rows.length} 筆`;
  } catch (e) {
    console.error(e);
    $status.textContent = `匯出失敗：${e.message}`;
  } finally {
    $btn.disabled = false;
    $btn.textContent = "⬇️ 下載 CSV";
  }
}

實際應用與延伸

此實作適合用於管理後台快速匯出 Firestore 資料，方便非技術人員下載報表。未來可擴充支援更多資料欄位，或改用後端匯出以保護 Firebase 金鑰安全。也可以加入進度條或分頁匯出功能，提升使用體驗。

常見問題與注意事項

Firebase 配置需正確填寫並允許匿名登入。
Firestore 權限規則需設定允許讀取資料。
大量資料匯出時，注意瀏覽器記憶體限制與執行時間。
CSV 格式需妥善處理特殊字元避免格式錯亂。

完整程式碼



    

匯出抽獎資料 CSV

在 LearnDash 課程列表新增已報名學生數欄位並優化查詢效能

小豬 — Thu, 01 Jan 2026 22:20:43 +0000

前言

這段程式碼主要解決 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，若有自訂存取邏輯需調整查詢條件。

完整程式碼

 $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);

JavaScript 實作禁止右鍵選單的簡易方法

小豬 — Tue, 30 Dec 2025 22:20:29 +0000

前言

在某些網頁應用中，開發者可能希望防止使用者透過滑鼠右鍵開啟選單，以避免內容被輕易複製或操作。這段程式碼提供了一個簡單且不影響其他滑鼠功能的解決方案，適合有基礎 JavaScript 知識且想快速實作右鍵禁用的工程師或自學者。

事件監聽與右鍵選單阻擋

核心概念是監聽瀏覽器的 contextmenu 事件，該事件會在使用者嘗試開啟右鍵選單時觸發。透過呼叫 event.preventDefault()，可以阻止預設行為，也就是禁止顯示右鍵選單。

重要程式碼片段

document.addEventListener("contextmenu", function (e) {
    e.preventDefault();
});

這段程式碼綁定全域的 contextmenu 事件監聽器，當事件發生時直接阻止預設動作。

為什麼用立即執行函式包裹？

使用立即執行函式 (IIFE) 可以避免全域變數污染，確保程式碼在嚴格模式下運行 ("use strict")，增加程式的穩定性與安全性。

實務應用與注意事項

此方法只禁止右鍵選單，不會影響左鍵點擊、文字選取或快捷鍵操作，對使用者體驗影響較小。
但此防護並非絕對安全，仍可被瀏覽器開發者工具或其他方式繞過，適合用於降低一般使用者誤操作。
若需更嚴格的內容保護，建議搭配其他前端或後端策略。

延伸優化方向

可針對特定元素綁定 contextmenu 事件，避免全域禁用造成使用不便。
結合提示訊息告知使用者右鍵功能已被禁用，提高使用者理解。

完整程式碼

(function () {
    "use strict";

    // 只鎖右鍵選單（不影響左鍵、選字、快捷鍵）
    document.addEventListener("contextmenu", function (e) {
        e.preventDefault();
    });
})();

WordPress 自訂文章類型批次內容關鍵字取代工具實作

小豬 — Mon, 29 Dec 2025 22:21:12 +0000

前言

在管理 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。

完整程式碼


 '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();
        }
    }
    ?>

Solution – 內容關鍵字取代

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

        
            

            



要搜尋的字（舊字串）


                        
                    
                



替換成（新字串）


                        
                    
                
            

            
        

        

取代結果

            
                請輸入要搜尋的舊字串。

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

            
                





ID

標題

狀態

編輯連結
                    
                    


                    









編輯

要搜尋的字（舊字串）
替換成（新字串）

ID	標題	狀態	編輯連結
			編輯



WooCommerce 後台訂單自訂欄位資料儲存實作說明
小豬 — Sun, 28 Dec 2025 22:20:33 +0000
前言
在 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 原生欄位衝突。
權限檢查不可省略，避免安全問題。

完整程式碼
update_meta_data($key, $value);
    $order->save();
}, 50);


WordPress 自動將文章 slug 設為文章 ID 的實作技巧
小豬 — Sat, 27 Dec 2025 22:20:37 +0000
前言
在 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 後可能需要清除快取。

完整程式碼
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);


修正 YouTube 影片循環播放的 iframe 參數設定技巧
小豬 — Fri, 26 Dec 2025 22:20:41 +0000
前言
在網頁中嵌入 YouTube 影片時，若希望影片能夠無限循環播放，通常需要在 iframe 的 URL 中加入特定參數。這段程式碼解決了直接設定 loop 參數無法生效的問題，適合需要動態調整或修正第三方影片嵌入參數的前端工程師與自學者。
問題背景與解決方案
YouTube 的 iframe 影片循環播放並非只靠 loop=1 參數即可生效，還必須同時指定 playlist 參數為影片 ID。這段程式碼會自動偵測所有帶有 youtube-loop 類別的 iframe，並補上正確的 loop 與 playlist 參數。
取得並解析 iframe 的 src
程式碼先取得所有符合條件的 iframe，並將 src 中可能被轉譯的 & 轉回 &，確保 URL 正確解析。
const rawSrc = iframe.getAttribute('src');
const src = rawSrc.replace(/&/g, '&');
取得影片 ID
透過字串切割方式，從 src 中擷取影片 ID，這是設定 playlist 參數的關鍵。
const videoId = src.split('/embed/')[1]?.split('?')[0];
設定 loop 與 playlist 參數
利用 URL 物件操作，設定 loop=1 與 playlist=影片ID，並避免重複設定造成無限迴圈。
const url = new URL(src);
url.searchParams.set('loop', '1');
url.searchParams.set('playlist', videoId);
const newSrc = url.toString();
if (newSrc !== src) iframe.setAttribute('src', newSrc);
實務應用與優化建議

此方法適合在頁面載入後或動態插入 iframe 後呼叫，確保所有影片都能正確設定循環播放。
透過多次延遲呼叫（setTimeout）處理 builder 或 lazy load 產生的 iframe。
若有大量 iframe，可考慮改用 MutationObserver 監控 DOM 變化，提高效能與即時性。

常見問題與坑點

直接在 iframe URL 加 loop=1 不加 playlist，影片不會循環。
URL 中的 & 需先轉回 &，否則 URL 解析會錯誤。
避免重複設定 src，否則會造成 iframe 不斷重新載入。

完整程式碼
(function () {
  function fixYouTubeLoop() {
    document.querySelectorAll('iframe.youtube-loop').forEach((iframe) => {
      const rawSrc = iframe.getAttribute('src');
      if (!rawSrc) return;

      // 你的 src 可能含有 &，先轉回正常的 &
      const src = rawSrc.replace(/&/g, '&');

      if (!src.includes('youtube.com/embed/')) return;

      const videoId = src.split('/embed/')[1]?.split('?')[0];
      if (!videoId) return;

      const url = new URL(src);
      url.searchParams.set('loop', '1');
      url.searchParams.set('playlist', videoId);

      const newSrc = url.toString();

      // 避免無限重設
      if (newSrc !== src) iframe.setAttribute('src', newSrc);
    });
  }

  document.addEventListener('DOMContentLoaded', fixYouTubeLoop);

  // 若是 builder / lazy load 後面才插入 iframe，再補一次
  setTimeout(fixYouTubeLoop, 800);
  setTimeout(fixYouTubeLoop, 2000);
})();


WordPress Polylang 多語翻譯批次複製工具實作解析
小豬 — Wed, 24 Dec 2025 22:21:27 +0000
前言
在多語網站開發中，使用 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 外掛已啟用且函式存在。

完整程式碼
Polylang API 不存在，請確認 Polylang 是否啟用。';
        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 '
通用翻譯複製工具（Polylang 官方流程）';
    echo '
來源語言固定為：' . 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;
}


WooCommerce 後台商品列表新增複製購物車連結並支援優惠券輸入功能
小豬 — Tue, 23 Dec 2025 22:21:03 +0000
前言
在 WooCommerce 後台商品列表中，管理者常需要快速取得商品的「加入購物車」連結以便分享或推廣。這段程式碼實作了在商品列表中新增一欄「複製課程連結」按鈕，點擊後可彈出視窗讓使用者輸入優惠券代碼，並將優惠券參數附加到連結中，最後將完整連結複製到剪貼簿。這對於需要快速產生帶優惠券的購物車連結的電商管理者非常實用。
新增自訂欄位顯示複製按鈕
利用 manage_edit-product_columns 過濾器新增一欄「複製課程連結」，並透過 manage_product_posts_custom_column 動作在該欄位輸出一個帶有商品加入購物車 URL 的按鈕。URL 是以網站首頁 URL 加上 /cart/?add-to-cart=商品ID 組成。
add_filter('manage_edit-product_columns', 'add_copy_link_column');
function add_copy_link_column($columns) {
    $columns['copy_add_to_cart'] = __('複製課程連結', 'woocommerce');
    return $columns;
}

add_action('manage_product_posts_custom_column', 'show_copy_link_column_content', 10, 2);
function show_copy_link_column_content($column, $post_id) {
    if ($column === 'copy_add_to_cart') {
        $product_id = (int) $post_id;
        $site_url = my_copy_cart_site_url();
        $add_to_cart_url = $site_url . '/cart/?add-to-cart=' . $product_id;
        echo '';
    }
}
客製化 JavaScript 處理複製邏輯與優惠券輸入
在後台商品列表頁尾插入 JavaScript 和 CSS，當使用者點擊「複製」按鈕時：

透過 window.prompt 詢問是否輸入優惠券代碼，可留空。
根據輸入結果組合最終 URL，若有優惠券則加上 &wt_coupon=優惠券代碼。
使用 Clipboard API 複製連結，若不支援則使用傳統 execCommand 備援。
複製成功會顯示成功提示，失敗則顯示錯誤提示並提供手動複製。

function buildFinalUrl(baseUrl) {
    var coupon = window.prompt('是否要加入優惠券？\n(可留空，直接按確定即可)', '');
    if (coupon === null) return baseUrl;
    coupon = String(coupon || '').trim();
    if (!coupon) return baseUrl;
    var joiner = (baseUrl.indexOf('?') === -1) ? '?' : '&';
    return baseUrl + joiner + 'wt_coupon=' + encodeURIComponent(coupon);
}

$(document).on('click', '.copy-cart-link', function(e) {
    e.preventDefault();
    var button = $(this);
    var baseUrl = button.data('url');
    var originalHtml = button.html();
    if (button.hasClass('copying')) return;
    button.addClass('copying');
    var finalUrl = buildFinalUrl(baseUrl);
    if (navigator.clipboard && window.isSecureContext) {
        navigator.clipboard.writeText(finalUrl).then(function() {
            showCopySuccess(button, originalHtml);
        }).catch(function() {
            fallbackCopyTextToClipboard(finalUrl, button, originalHtml);
        });
    } else {
        fallbackCopyTextToClipboard(finalUrl, button, originalHtml);
    }
});
快速動作連結整合
除了欄位按鈕外，也在商品標題下方的快速動作連結加入「複製購物車連結」，提升操作便利性。此連結同樣帶有商品加入購物車的 URL，並套用相同的 JavaScript 行為。
add_filter('post_row_actions', 'add_copy_link_quick_action', 10, 2);
function add_copy_link_quick_action($actions, $post) {
    if ($post->post_type === 'product') {
        $product_id = (int) $post->ID;
        $site_url = my_copy_cart_site_url();
        $add_to_cart_url = $site_url . '/cart/?add-to-cart=' . $product_id;
        $actions['copy_cart_link'] = '📋 複製購物車連結';
    }
    return $actions;
}
實務應用與優化建議
此功能適合需要快速產生帶優惠券的購物車連結的 WooCommerce 商店管理員，方便推廣或客服回覆。未來可優化：

將網站 URL 改為動態取得，避免硬編碼。
增加複製成功的視覺動畫提升 UX。
支援多種優惠券參數或其他自訂參數。
對於大量商品列表，可考慮優化前端效能。

完整程式碼

                 複製
              ';
    }
}

// 添加 JavaScript 和 CSS
add_action('admin_footer', 'copy_link_admin_script');
function copy_link_admin_script() {
    $screen = get_current_screen();
    if (!$screen || $screen->id !== 'edit-product') {
        return;
    }
    ?>



    
    post_type === 'product') {
        $product_id = (int) $post->ID;

        $site_url = my_copy_cart_site_url();
        $add_to_cart_url = $site_url . '/cart/?add-to-cart=' . $product_id;

        $actions['copy_cart_link'] = '📋 複製購物車連結';
    }
    return $actions;
}



WordPress 後台為自訂文章類型新增內容關鍵字搜尋功能
小豬 — Mon, 22 Dec 2025 22:20:38 +0000
前言
在 WordPress 後台管理自訂文章類型（此處為 solution）時，若想快速搜尋文章內容中是否包含特定關鍵字，系統預設的搜尋功能可能無法精準或方便達成此需求。這段程式碼示範如何為 solution 文章類型新增一個後台子選單，提供內容關鍵字搜尋功能，適合需要管理大量文章並快速定位內容的開發者與網站管理員。
新增後台子選單
使用 admin_menu action，先檢查 solution 文章類型是否存在，避免錯誤。接著透過 add_submenu_page 在 solution 列表底下新增「內容關鍵字搜尋」子選單，設定權限為 edit_posts，確保只有具備編輯權限的使用者能操作。
add_action( 'admin_menu', function () {
    if ( ! post_type_exists( 'solution' ) ) {
        return;
    }

    add_submenu_page(
        'edit.php?post_type=solution',
        '內容關鍵字搜尋',
        '內容關鍵字搜尋',
        'edit_posts',
        'solution-content-search',
        'solution_content_search_page_render'
    );
} );
搜尋頁面渲染與表單處理
solution_content_search_page_render 函式負責渲染搜尋表單與結果頁面。首先檢查使用者權限，避免未授權存取。接著判斷是否有表單送出，並使用 WordPress 的 nonce 機制驗證安全性。
關鍵字透過 sanitize_text_field 與 wp_unslash 清理，避免 XSS 與注入風險。
if ( isset( $_POST['solution_content_search_submit'] ) ) {
    check_admin_referer( 'solution_content_search_action', 'solution_content_search_nonce' );

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

    if ( $keyword !== '' ) {
        // ...
    }
}
透過 WP_Query 及字串比對精確搜尋
WordPress 內建搜尋（s 參數）會搜尋標題、內容等欄位，但可能不夠精準。此處先用 WP_Query 以關鍵字搜尋取得可能相關文章 ID，然後逐篇讀取內容，使用 mb_stripos（若有）或 stripos 做不區分大小寫的字串比對，確保內容確實包含關鍵字。
$query = new WP_Query( array(
    'post_type'      => 'solution',
    'post_status'    => 'any',
    'posts_per_page' => -1,
    's'              => $keyword,
    'fields'         => 'ids',
) );

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

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

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

    if ( $pos !== false ) {
        $results[] = $post_id;
    }
}
wp_reset_postdata();
搜尋結果呈現與操作介面
搜尋結果會以表格形式呈現，包含文章 ID、標題（連結至編輯頁面）、前台連結與編輯按鈕，方便快速查看與編輯。若無輸入關鍵字或找不到結果，會顯示相應提示訊息。
表單使用 WordPress 內建的 wp_nonce_field 與 submit_button，確保安全與一致性。
實務應用與優化方向
此搜尋功能適合用於自訂文章類型管理，尤其是內容量大且需要精準定位文本的場景。未來可考慮加入分頁功能避免一次載入過多文章，或結合全文索引外掛提升搜尋效能。也可擴充搜尋範圍至自訂欄位或分類。
完整程式碼
 'solution',
                'post_status'    => 'any',
                'posts_per_page' => -1,
                's'              => $keyword,
                'fields'         => 'ids',
            ) );

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

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

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

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

    ?>
    

Solution 內容關鍵字搜尋

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

        
            

            


                    
                        關鍵字字串
                    


                        
                    
                
            

            
        

        

搜尋結果

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

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

                




                            ID
                            標題
                            前台連結
                            編輯
                        
                    


                    






                                
                                    
                                        
                                    
                                
                                    
                                
                            


                                
                                    
                                        檢視
                                    
                                
                                    -
                                
                            


                                
                                    
                                        編輯文章
                                    
                                
                                    -
                                
                            
                        
                    
                    
                
            
        
    
    



WordPress 自訂文章類型批次內容關鍵字取代工具實作
小豬 — Sun, 21 Dec 2025 22:20:56 +0000
前言
在 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 或多語系複雜處理。

完整程式碼
 '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();
        }
    }
    ?>



Solution – 內容關鍵字取代

        
            

            



要搜尋的字（舊字串）


                        
                    
                



替換成（新字串）


                        
                    
                
            

            
        

        

取代結果

            
                請輸入要搜尋的舊字串。

            
                沒有任何文章包含「」。

            
                





ID

標題

狀態

編輯連結
                    
                    


                    









編輯
                        
                    
                    
                
            

        
    

    



使用 Polylang 官方流程批量複製 WordPress 文章翻譯
小豬 — Sat, 20 Dec 2025 22:21:10 +0000
前言
這段 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 的語言設定。

完整程式碼
Polylang API 不存在，請確認外掛是否啟用。';
        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 '
Investor Relations 翻譯複製工具（官方流程版）';
    echo '
來源語言固定為：' . 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 '
單筆測試結果';

    if ( ! $post_id || ! get_post( $post_id ) ) {
        echo '找不到文章 ID：' . esc_html( $post_id ) . '';
        return;
    }

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

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

/* =========================
 * 批量處理所有中文文章（官方流程）
 * ========================= */
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 '
批次執行結果（目標語言：' . esc_html( strtoupper( $target_lang ) ) . '）';

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

    $output = [];

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

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

/* =========================
 * 核心：官方流程複製一篇文章 → 目標語言翻譯
 * ========================= */
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;
}