後台自訂欄位 – 小豬日常

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

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;
}