PHP – 小豬日常

使用 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

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 自訂文章類型批次內容關鍵字取代工具實作
小豬 — 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

標題

狀態

編輯連結
                    
                    


                    









編輯
                        
                    
                    
                
            

        
    

    



WordPress 取得用戶留言過文章列表與留言數量的實作教學
小豬 — Tue, 16 Dec 2025 22:21:39 +0000
前言
本篇文章介紹如何在 WordPress 中取得特定用戶曾留言過的文章列表，並且顯示該用戶在每篇文章的留言數量。這段程式碼適合用於會員系統或社群互動功能，方便開發者在會員後台展示用戶的互動紀錄。目標讀者為具備 PHP 和 WordPress 基礎，想了解如何結合資料庫查詢與文章篩選的工程師或自學者。
取得用戶留言過的文章 ID
透過 WordPress 的全域變數 $wpdb，使用 SQL 查詢 comments 資料表，取得指定用戶的留言所對應的文章 ID，並去除重複。此函式回傳整數陣列。
function ks_get_user_commented_post_ids( $user_id ) {
    global $wpdb;

    $query = $wpdb->prepare(
        "SELECT DISTINCT comment_post_ID FROM {$wpdb->comments} WHERE user_id = %d",
        $user_id
    );

    $results = $wpdb->get_col( $query );
    return array_map( 'intval', $results );
}
為什麼使用 SQL 查詢？
直接查詢資料庫效率較高，避免使用 WordPress 內建函式多次查詢留言，尤其用戶留言量大時更具效能優勢。
取得用戶留言過且仍有效的文章物件
此函式會先取得用戶留言過的文章 ID，再逐一檢查文章狀態是否為「已發佈」且文章類型為「post」，最後使用 get_posts 取得完整文章物件陣列，並以發佈日期排序。
function ks_get_user_commented_posts( $user_id = 0 ) {
    if ( ! $user_id ) {
        $user_id = get_current_user_id();
    }

    if ( ! $user_id ) {
        return array();
    }

    $commented_post_ids = ks_get_user_commented_post_ids( $user_id );

    if ( empty( $commented_post_ids ) ) {
        return array();
    }

    $valid_post_ids = array();
    foreach ($commented_post_ids as $post_id) {
        $post = get_post($post_id);
        if ($post && $post->post_status === 'publish' && $post->post_type === 'post') {
            $valid_post_ids[] = $post_id;
        }
    }

    if (empty($valid_post_ids)) {
        return array();
    }

    $posts = get_posts( array(
        'post_type'      => 'post',
        'post_status'    => 'publish',
        'posts_per_page' => -1,
        'post__in'       => $valid_post_ids,
        'orderby'        => 'date',
        'order'          => 'DESC'
    ) );

    return $posts;
}
為什麼要篩選文章狀態？
確保只顯示目前可見的文章，避免用戶看到草稿或已刪除的文章，提升使用體驗與資料正確性。
取得用戶在指定文章的留言數量
同樣利用 $wpdb 執行 SQL 查詢，計算該用戶在特定文章的留言數，回傳整數。
function ks_get_user_comment_count_for_post( $post_id, $user_id = 0 ) {
    if ( ! $user_id ) {
        $user_id = get_current_user_id();
    }

    if ( ! $user_id ) {
        return 0;
    }

    global $wpdb;

    $count = $wpdb->get_var( $wpdb->prepare(
        "SELECT COUNT(*) FROM {$wpdb->comments} WHERE comment_post_ID = %d AND user_id = %d",
        $post_id,
        $user_id
    ) );

    return intval($count);
}
在 MemberPress 會員後台新增「我的留言」分頁
透過 mepr_account_nav 與 mepr_account_nav_content 兩個鉤子，分別新增導覽選單與內容區塊，顯示用戶留言過的文章列表。
導覽選單新增項目
add_action('mepr_account_nav', function($action) {
    $active = (isset($_GET['action']) && $_GET['action'] === 'user-commented') ? 'mepr-active-nav-tab' : '';
    echo '';
    echo '我的留言';
    echo '';
});
顯示留言文章列表內容

先取得當前用戶留言過的文章
無留言時顯示提示文字
有留言時列出文章縮圖、分類、留言數與標題連結
若文章有額外權限設定，顯示鎖頭圖示

add_action('mepr_account_nav_content', function($action) {
    if ($action !== 'user-commented') {
        return;
    }

    $current_user_id = get_current_user_id();
    $commented_posts = ks_get_user_commented_posts($current_user_id);

    if (empty($commented_posts)) {
        echo '';
        echo '
尚無留言過的文章';
        echo '';
        return;
    }

    echo <<

我的留言

HTML;

    echo '';

    foreach ($commented_posts as $post) {
        $post_id = $post->ID;

        $thumbnail = has_post_thumbnail($post_id) ? get_the_post_thumbnail($post_id, 'medium', array('class' => 'post-thumb', 'loading' => 'lazy')) : '';

        $categories = get_the_category($post_id);
        $category_name = (!empty($categories)) ? $categories[0]->name : '文章';

        $comment_count = ks_get_user_comment_count_for_post($post_id, $current_user_id);

        $post_title = get_the_title($post_id);
        $post_link = get_permalink($post_id);
        $has_access = get_field('ks_post_access', $post_id);

        echo '';
        echo '';
        echo $thumbnail;
        echo '' . esc_html($category_name) . '';
        if ($has_access) {
            echo '';
        }
        echo '';
        echo '';

        echo '';
        echo '';
        echo '' . esc_html($post_title) . '';
        echo '';
        echo '';
        echo '' . $comment_count . ' 則留言';
        echo '';
        echo '';

        echo '';
    }

    echo '';
});
實務應用與優化方向

可結合 AJAX 實現分頁或動態載入，避免一次載入大量文章造成頁面卡頓
留言數量可用快取機制減少資料庫查詢次數
依需求擴充篩選條件，如文章分類、日期區間等
針對會員權限做更細緻的存取控制，提升安全性

完整程式碼
prepare(
        "SELECT DISTINCT comment_post_ID FROM {$wpdb->comments} WHERE user_id = %d",
        $user_id
    );

    $results = $wpdb->get_col( $query );
    return array_map( 'intval', $results );
}

/**
 * 獲取用戶留言過的文章
 */
function ks_get_user_commented_posts( $user_id = 0 ) {
    if ( ! $user_id ) {
        $user_id = get_current_user_id();
    }

    if ( ! $user_id ) {
        return array();
    }

    $commented_post_ids = ks_get_user_commented_post_ids( $user_id );

    if ( empty( $commented_post_ids ) ) {
        return array();
    }

    $valid_post_ids = array();
    foreach ($commented_post_ids as $post_id) {
        $post = get_post($post_id);
        if ($post && $post->post_status === 'publish' && $post->post_type === 'post') {
            $valid_post_ids[] = $post_id;
        }
    }

    if (empty($valid_post_ids)) {
        return array();
    }

    $posts = get_posts( array(
        'post_type'      => 'post',
        'post_status'    => 'publish',
        'posts_per_page' => -1,
        'post__in'       => $valid_post_ids,
        'orderby'        => 'date',
        'order'          => 'DESC'
    ) );

    return $posts;
}

/**
 * 獲取用戶在特定文章的留言數量
 */
function ks_get_user_comment_count_for_post( $post_id, $user_id = 0 ) {
    if ( ! $user_id ) {
        $user_id = get_current_user_id();
    }

    if ( ! $user_id ) {
        return 0;
    }

    global $wpdb;

    $count = $wpdb->get_var( $wpdb->prepare(
        "SELECT COUNT(*) FROM {$wpdb->comments} WHERE comment_post_ID = %d AND user_id = %d",
        $post_id,
        $user_id
    ) );

    return intval($count);
}

// MemberPress 會員後台整合
add_action('mepr_account_nav', function($action) {
    $active = (isset($_GET['action']) && $_GET['action'] === 'user-commented') ? 'mepr-active-nav-tab' : '';
    echo '';
    echo '我的留言';
    echo '';
});

add_action('mepr_account_nav_content', function($action) {
    if ($action !== 'user-commented') {
        return;
    }

    $current_user_id = get_current_user_id();
    $commented_posts = ks_get_user_commented_posts($current_user_id);

    if (empty($commented_posts)) {
        echo '';
        echo '
尚無留言過的文章';
        echo '';
        return;
    }

    echo <<

我的留言

HTML;

    echo '';

    foreach ($commented_posts as $post) {
        $post_id = $post->ID;

        $thumbnail = '';
        if (has_post_thumbnail($post_id)) {
            $thumbnail = get_the_post_thumbnail($post_id, 'medium', array(
                'class' => 'post-thumb',
                'loading' => 'lazy'
            ));
        } else {
            $thumbnail = '';
        }

        $categories = get_the_category($post_id);
        $category_name = (!empty($categories)) ? $categories[0]->name : '文章';

        $comment_count = ks_get_user_comment_count_for_post($post_id, $current_user_id);

        $post_title = get_the_title($post_id);
        $post_link = get_permalink($post_id);
        $has_access = get_field('ks_post_access', $post_id);

        echo '';

        echo '';
        echo $thumbnail;
        echo '
        ' . esc_html($category_name) . '';
                if ($has_access) { 
                    echo ''; 
                }
       echo '';
        echo '';

        echo '';
        echo '';
        echo '' . esc_html($post_title) . '';
        echo '';
        echo '';
        echo '' . $comment_count . ' 則留言';
        echo '';
        echo '';

        echo '';
    }

    echo '';
});


自訂 MemberPress 貨幣格式為無小數點整數顯示
小豬 — Sun, 14 Dec 2025 22:20:27 +0000
前言
在使用 MemberPress 這類會員付費外掛時，預設的貨幣格式通常會包含小數點，像是「$123.00」。有些商業需求或設計風格希望價格以整數顯示，去除小數點部分。本文示範如何透過 WordPress 的 filter 機制，將 MemberPress 的貨幣格式調整成無小數點的整數顯示，並保留貨幣符號原本的位置。
這篇文章適合對 WordPress 外掛開發有基礎認識，並且需要自訂 MemberPress 付款顯示格式的工程師或自學者。
透過 filter 自訂貨幣格式
MemberPress 提供 mepr_format_currency 這個 filter，可以攔截並修改貨幣字串的輸出。這段程式碼利用匿名函式接收三個參數：

$rstr：原始格式化後的貨幣字串
$number：數字部分
$show_symbol：是否顯示貨幣符號

接著使用 MemberPress 內建的 MeprUtils::format_currency_float 函式，將數字四捨五入到 0 位小數，轉成字串。
$no_decimals = (string) MeprUtils::format_currency_float((float) $number, 0);
保留貨幣符號原本位置
為了不破壞原本貨幣符號的位置（有些貨幣符號在前，有些在後），程式碼判斷原字串 $rstr 是否以貨幣符號開頭：
if (strpos($rstr, $symbol) === 0) {
  return $symbol . $no_decimals;
} else {
  return $no_decimals . ' ' . $symbol;
}
這樣可以維持「$123」或「123 $」的格式一致性。
實務應用與注意事項

適用於價格不需要小數點顯示的場景，例如整數金額訂閱方案。
若未來有多種貨幣符號，需確認 MeprOptions::fetch() 取得的符號是否正確。
由於是使用匿名函式，若需移除此 filter，需注意無法直接使用 remove_filter。

延伸優化方向

可根據不同貨幣類型動態調整小數位數。
加入千分位分隔符號增強可讀性。
支援多語系貨幣格式。

完整程式碼
currency_symbol;
  if (strpos($rstr, $symbol) === 0) {
    // 原本是「$123.00」這種前置符號
    return $symbol . $no_decimals;
  } else {
    // 原本是「123.00 $」這種後置符號
    return $no_decimals . ' ' . $symbol;
  }
}, 10, 3);


WordPress 會員中心新增追蹤文章清單功能實作
小豬 — Sat, 13 Dec 2025 22:20:48 +0000
前言
這段 PHP 程式碼用於在 WordPress 會員中心（使用 MemberPress 插件）新增一個「追蹤文章」的分頁，讓使用者可以快速查看自己收藏或追蹤的文章列表。適合需要在會員系統中提供個人化內容管理的網站開發者與自學者。
新增會員中心導覽標籤
透過 mepr_account_nav action，程式碼在會員中心導覽列新增一個名為「追蹤文章」的標籤。當使用者點擊此標籤時，會帶入 action=user-follow 的 URL 參數，並且根據當前頁面狀態動態加上 CSS 樣式以標示為當前選中狀態。
add_action('mepr_account_nav', function($action){
  $active = (isset($_GET['action']) && $_GET['action'] === 'user-follow') ? 'mepr-active-nav-tab' : '';
  echo '追蹤文章';
});
顯示追蹤文章清單內容
使用 mepr_account_nav_content action 來判斷是否為 user-follow 頁面，若是則取得該會員收藏的文章 ID。此處利用 get_user_favorites 函式（需額外插件或自訂函式支持）取得文章列表，並以 Flexbox 版型顯示。
文章資料與版型處理

透過 get_the_post_thumbnail 取得文章縮圖，若無縮圖則顯示預設佔位元素。
文章分類顯示為角標，若無分類則顯示「文章」。
若文章有特定欄位 ks_post_access 標示有權限，則在角標旁顯示鎖頭圖示。

文章列表輸出範例
foreach ($post_ids as $post_id) {
  $has_access = get_field('ks_post_access', $post_id);
  $thumb_html = get_the_post_thumbnail($post_id, 'medium_large', ['class' => 'fi-img', 'loading'=>'lazy', 'decoding'=>'async']);
  if(empty($thumb_html)) {
    $thumb_html = '';
  }
  $cats = get_the_category($post_id);
  $badge = (!empty($cats) && !is_wp_error($cats)) ? $cats[0]->name : '文章';
  $permalink = get_permalink($post_id);
  $title = get_the_title($post_id);

  echo ''
       . '' . $thumb_html
       . '' . esc_html($badge) . '';
  if ($has_access) {
    echo '(鎖頭 SVG)';
  }
  echo ''
       . '' . esc_html($title) . ''
       . '';
}
實務應用與延伸
此功能適合用於會員制網站，讓使用者能方便管理自己感興趣的文章。可進一步結合 AJAX 技術實現無刷新更新，或加入取消追蹤功能提升互動性。若文章有付費限制，鎖頭圖示能明確提示使用者權限狀態。
常見問題與注意事項

get_user_favorites 函式需確認是否有安裝相應收藏功能插件，否則會回傳空陣列。
權限欄位 ks_post_access 為自訂欄位，需確保文章有正確設定。
SVG 圖示直接內嵌於 HTML，方便自訂樣式與顯示，避免外部資源依賴。

完整程式碼
// Account > 追蹤清單 tab
add_action('mepr_account_nav', function($action){
  $active = (isset($_GET['action']) && $_GET['action'] === 'user-follow') ? 'mepr-active-nav-tab' : '';
  echo '追蹤文章';
});

// Account > 追蹤清單內容：Flex 版型
add_action('mepr_account_nav_content', function($action){
  if($action !== 'user-follow') return;

  // Favorite Posts
  $filters = [
    'post_type' => ['post'],
    'status'    => ['publish'],
  ];
  $post_ids = function_exists('get_user_favorites')
    ? get_user_favorites(get_current_user_id(), null, $filters)
    : [];

  if (empty($post_ids)) {
    echo '
尚無追蹤的文章';
    return;
  }

  echo '我的追蹤文章';

  echo '';
  foreach ($post_ids as $post_id) {
    // 檢查是否有 access 權限
    $has_access = get_field('ks_post_access', $post_id);

    // 縮圖
    $thumb_html = get_the_post_thumbnail(
      $post_id,
      'medium_large',
      ['class' => 'fi-img', 'loading'=>'lazy', 'decoding'=>'async']
    );
    if(empty($thumb_html)){
      $thumb_html = '';
    }

    // 角標：第一個分類，無則顯示「文章」
    $cats  = get_the_category($post_id);
    $badge = (!empty($cats) && !is_wp_error($cats)) ? $cats[0]->name : '文章';
    $permalink = get_permalink($post_id);
    $title     = get_the_title($post_id);

    echo ''
         . ''
         .   $thumb_html .   
        '
        ' . esc_html($badge) . '';
        // 如果有 access 權限，顯示鎖頭圖標 
        if ($has_access) { 
            echo ''; 
    }

            echo '';

    echo   ''
         . ''
         .   '' . esc_html($title) . ''
         . ''
         . '';
  }
  echo '';
});


使用 PHP 與 DOMDocument 自動產生 WordPress 文章預覽內容
小豬 — Fri, 12 Dec 2025 22:20:47 +0000
前言
在 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('' . $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 可避免影響
若文章內容過短或無有效區塊，預覽欄位可能為空，需在前端做好容錯處理
自動儲存與修訂版本判斷是避免重複觸發的關鍵，缺少可能導致效能問題

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


利用短碼控制內容顯示：結合 MemberPress 權限判斷的實作範例
小豬 — Thu, 11 Dec 2025 22:20:38 +0000
前言
在 WordPress 網站中，常見需求是根據使用者的會員權限來控制內容的顯示。這段 PHP 程式碼示範如何利用短碼（shortcode）結合 MemberPress 的存取規則，根據不同的權限狀態呈現不同內容。適合已有 WordPress 和 MemberPress 基礎，想自訂內容權限顯示的工程師或自學者。
短碼設計與參數說明
此短碼名稱為 ks_mepr_access_view，接受一個參數 type，用來決定顯示的內容類型：

public：公開內容，無需會員權限
member：會員專屬內容，需通過 MemberPress 規則授權
noaccess：未授權會員或訪客看到的內容

使用範例：
[ks_mepr_access_view type="member"]會員專屬內容[/ks_mepr_access_view]
權限判斷流程解析
取得文章與規則
$post = get_post();
$rules = MeprRule::get_rules($post);
先取得當前文章物件，再用 MemberPress API 取得該文章綁定的存取規則。
判斷使用者登入與權限
$user = wp_get_current_user();
$is_logged_in = is_user_logged_in();
$has_access = false;

if ($is_logged_in && !empty($rules)) {
    $member = new MeprUser($user->ID);
    foreach ($rules as $rule) {
        if ($member->has_access_from_rule($rule->ID)) {
            $has_access = true;
            break;
        }
    }
}
確認使用者是否登入，且文章有設定規則，接著檢查使用者是否符合任一規則，若符合即標記為有存取權限。
根據條件回傳內容
if (!$has_rule && $type === 'public') {
    return do_shortcode($content); // 無保護，公開內容
}

if ($has_rule && $has_access && $type === 'member') {
    return do_shortcode($content); // 有保護且有權限，顯示會員內容
}

if ($has_rule && !$has_access && $type === 'noaccess') {
    return do_shortcode($content); // 有保護但無權限，顯示無權限內容
}

return '';
依據是否有規則、是否有權限，以及 type 參數決定是否顯示內容，未符合條件則回傳空字串。
實務應用與擴充建議

可用於文章、頁面或自訂文章類型中，靈活控制不同會員等級的內容呈現。
可結合前端樣式或 JavaScript，提升使用者體驗，例如顯示提示訊息或引導登入。
若需更複雜的權限判斷，可擴充短碼參數，或搭配其他會員系統 API。

常見問題與注意事項

確保 MemberPress 已正確設定存取規則並綁定文章。
使用者權限判斷依賴 MemberPress API，若插件更新需確認相容性。
短碼內容內仍可使用其他短碼，do_shortcode 可確保內嵌短碼正常解析。

完整程式碼
 'public', // 可為 public, member, noaccess
    ], $atts);

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

    $type = strtolower($atts['type']);
    $rules = MeprRule::get_rules($post);
    $has_rule = !empty($rules);

    $user = wp_get_current_user();
    $is_logged_in = is_user_logged_in();
    $has_access = false;

    if ($is_logged_in && $has_rule) {
        $member = new MeprUser($user->ID);
        foreach ($rules as $rule) {
            if ($member->has_access_from_rule($rule->ID)) {
                $has_access = true;
                break;
            }
        }
    }

    // 顯示條件
    if (!$has_rule && $type === 'public') {
        return do_shortcode($content); // 沒有保護 → 公開
    }

    if ($has_rule && $has_access && $type === 'member') {
        return do_shortcode($content); // 有保護+通過 → 會員
    }

    if ($has_rule && !$has_access && $type === 'noaccess') {
        return do_shortcode($content); // 有保護+沒通過（不論登入與否）→ 無權限
    }

    return '';
}
add_shortcode('ks_mepr_access_view', 'ks_mepr_access_view_shortcode');


WordPress 單篇文章瀏覽次數計數器實作
小豬 — Thu, 11 Dec 2025 02:50:35 +0000
前言
在許多網站中，追蹤文章的瀏覽次數是一個常見需求，可以用來分析內容受歡迎程度或作為推薦依據。這段 PHP 程式碼示範如何在 WordPress 單篇文章頁面中，利用文章自訂欄位（post meta）記錄瀏覽次數，適合有基本 WordPress 開發經驗的工程師或自學者。
透過 wp_head 鉤子更新瀏覽次數
WordPress 提供了多種鉤子（hook）讓開發者在不同時機點執行程式碼。這裡選擇使用 wp_head，代表每次載入頁面時會執行計數函式。
add_action( 'wp_head', 'ks_track_post_views' );
這樣可以確保在文章頁面載入時，瀏覽次數會即時更新。
計數函式邏輯解析
函式 ks_track_post_views 主要做以下幾件事：

使用 is_single() 判斷目前是否為單篇文章頁，避免在首頁或列表頁誤計數。
取得當前文章 ID。
從文章自訂欄位 ks_post_views 讀取目前瀏覽次數。
若已有數值，將其轉為整數後加一；若無則初始化為 1。
更新文章自訂欄位，寫入新的瀏覽次數。

function ks_track_post_views() {
    if ( is_single() ) {
        global $post;
        $post_id = $post->ID;

        $views = get_post_meta( $post_id, 'ks_post_views', true );
        $views = $views ? intval( $views ) + 1 : 1;
        update_post_meta( $post_id, 'ks_post_views', $views );
    }
}
這段程式碼利用 WordPress 內建的 get_post_meta 和 update_post_meta 函式操作文章自訂欄位，避免直接操作資料庫，維持良好的相容性。
實務應用與優化建議

緩存問題：如果網站使用快取機制，可能會導致瀏覽次數無法即時更新，建議搭配 Ajax 或其他非快取方式更新計數。
防止重複計數：目前邏輯無法區分同一用戶多次刷新，若需更精確的統計，可結合 Cookie 或 Session 控制。
效能考量：大量文章同時更新 meta 可能影響效能，必要時可考慮批次更新或使用專門的統計外掛。

常見問題與注意事項

使用 wp_head 會在每次頁面載入時執行，若頁面包含大量資源，可能會稍微增加伺服器負擔。
確保文章自訂欄位名稱不與其他外掛或主題衝突，這裡使用 ks_post_views 作為前綴。

完整程式碼
ID;

        $views = get_post_meta( $post_id, 'ks_post_views', true );
        $views = $views ? intval( $views ) + 1 : 1;
        update_post_meta( $post_id, 'ks_post_views', $views );
    }
}
add_action( 'wp_head', 'ks_track_post_views' );



自訂 WordPress 登入頁面 Logo 與連結設定教學
小豬 — Wed, 10 Dec 2025 10:23:35 +0000
前言
WordPress 預設的登入頁面 Logo 通常是 WordPress 自身標誌，對於品牌一致性或客製化需求來說，常常需要替換成自家 Logo。這篇文章針對有基本 PHP 與 WordPress 鉤子（Hook）概念的工程師，說明如何透過簡單的程式碼修改登入頁面 Logo 及其連結與標題。
修改登入頁面 Logo 的方法
WordPress 提供了 login_enqueue_scripts 動作鉤子，可以在登入頁面載入自訂 CSS。利用這個鉤子，我們可以注入 CSS 來改變 Logo 背景圖。
主要程式碼片段
function ks_custom_login_logo() { ?>
    

這段程式碼將登入頁面中 Logo 的背景圖片改為指定路徑的 SVG，並調整尺寸與顯示方式，確保圖片完整且置中。
自訂 Logo 點擊連結與標題
預設 WordPress 登入頁 Logo 點擊會導向 wordpress.org，且滑鼠移到 Logo 上會顯示 “Powered by WordPress”。若想改為導向自己網站首頁，並顯示網站名稱，可以使用以下兩個過濾器：
function ks_custom_login_logo_url( $url ) {
    return home_url( '/' );
}
add_filter( 'login_headerurl', 'ks_custom_login_logo_url' );

function ks_custom_login_logo_title( $title ) {
    return get_bloginfo( 'name' );
}
add_filter( 'login_headertext', 'ks_custom_login_logo_title' );
這樣使用者點擊 Logo 就會回到網站首頁，且滑鼠懸停時顯示網站名稱，提升品牌辨識度。
實務應用與優化建議

Logo 圖片路徑：請確保 background-image 的 URL 是正確且可存取的路徑，通常放在 WordPress 媒體庫或主題資料夾。
尺寸調整：根據 Logo 圖檔比例調整 width 與 height，避免變形。
響應式設計：可進一步用媒體查詢調整不同裝置的尺寸。
安全性：避免在登入頁面加入過多外部資源，確保載入速度與安全。

常見問題與注意事項

若修改後 Logo 不顯示，請檢查圖片路徑是否正確，並清除瀏覽器快取。
使用 SVG 時，確保檔案安全且無惡意程式碼。
若有快取外掛或 CDN，請同步清除快取。

完整程式碼

    



自訂 WordPress 摘要結尾文字的簡易方法
小豬 — Wed, 10 Dec 2025 10:23:14 +0000
前言
在 WordPress 主題開發或客製化時，常會需要調整文章摘要（excerpt）結尾的文字，預設為「[…]」的顯示可能不符合設計需求。這段 PHP 程式碼示範如何用最簡單的方式修改摘要結尾文字，適合有基本 WordPress 開發經驗的工程師或自學者。
為什麼要修改摘要結尾文字
WordPress 預設的摘要結尾通常是「[…]」，這是用來表示文章內容被截斷。若想讓網站風格更統一或更符合閱讀體驗，可以透過過濾器（filter）自訂這段文字。
透過 add_filter 修改 excerpt_more
關鍵在於 WordPress 提供的 excerpt_more 過濾器，可以攔截並改寫摘要結尾文字。以下是程式碼片段：
add_filter('excerpt_more', function($more) {
    return '…';
});
這段程式碼使用匿名函式（Closure）直接回傳一個單一的省略符號「…」，取代預設的「[…]」。
程式碼解析

add_filter 是 WordPress 用來掛載過濾器的函式。
'excerpt_more' 是過濾器名稱，專門用來修改摘要後綴。
匿名函式接收 $more 參數（原本的結尾文字），但這裡直接忽略它，回傳自訂字串。

這種寫法簡潔且易於維護，尤其適合只想快速改變摘要結尾的情境。
實務應用與延伸

可將回傳字串改成其他符號或文字，例如「繼續閱讀」搭配連結。
若需要更複雜的摘要控制，可結合 excerpt_length 過濾器調整摘要長度。
注意部分主題或外掛可能會覆寫此過濾器，需確認優先權設定。

常見問題


為什麼修改後沒效果？
可能是主題直接使用自訂函式產生摘要，未使用 WordPress 預設的 the_excerpt() 函式。


如何同時修改摘要長度？
可搭配 excerpt_length 過濾器一起使用。


完整程式碼

PHP – 小豬日常

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

前言

Firebase 初始化與匿名登入

分頁抓取 Firestore 資料

CSV 格式處理與下載

時間戳記格式轉換

實作匯出流程

實際應用與延伸

常見問題與注意事項

完整程式碼

匯出抽獎資料 CSV

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

前言

新增後台子選單

後台頁面與表單設計

批次搜尋與替換邏輯說明

結果呈現與使用者體驗

實務應用與優化建議

常見問題與注意事項

完整程式碼

Solution – 內容關鍵字取代

取代結果

WooCommerce 後台訂單自訂欄位資料儲存實作說明

前言

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

使用 woocommerce_process_shop_order_meta 鉤子

關鍵說明

實務應用與延伸

常見問題與注意事項

完整程式碼

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

前言

新增子選單介面

後台頁面與表單處理

批次搜尋與替換邏輯

結果呈現與使用者體驗

實務應用與優化建議

常見問題與注意事項

完整程式碼

Solution – 內容關鍵字取代

取代結果

WordPress 取得用戶留言過文章列表與留言數量的實作教學

前言

取得用戶留言過的文章 ID

為什麼使用 SQL 查詢？

取得用戶留言過且仍有效的文章物件

為什麼要篩選文章狀態？

取得用戶在指定文章的留言數量

在 MemberPress 會員後台新增「我的留言」分頁

導覽選單新增項目

顯示留言文章列表內容

'; echo '' . esc_html($post_title) . ''; echo '

實務應用與優化方向

完整程式碼

'; echo '' . esc_html($post_title) . ''; echo '

自訂 MemberPress 貨幣格式為無小數點整數顯示

前言

透過 filter 自訂貨幣格式

保留貨幣符號原本位置

實務應用與注意事項

延伸優化方向

完整程式碼

WordPress 會員中心新增追蹤文章清單功能實作

前言

新增會員中心導覽標籤

顯示追蹤文章清單內容

文章資料與版型處理

文章列表輸出範例

' . esc_html($title) . '

實務應用與延伸

常見問題與注意事項

完整程式碼

我的追蹤文章

' . esc_html($title) . '

使用 PHP 與 DOMDocument 自動產生 WordPress 文章預覽內容

前言

主要功能說明

程式碼解析

避免不必要的觸發