WooCommerce 擴展開發基礎教學同實戰指南

點解需要開發 WooCommerce 擴展

WooCommerce 作為 WordPress 生態系統中功能最強大嘅電子商務插件，其核心功能已經涵蓋咗網上商店營運嘅基本需求，例如產品管理、購物車、結帳同支付。不過，每個商家嘅業務模式、產品特性同營運流程都係獨一無二嘅。標準功能往往無法滿足好似定制化產品配置、複雜嘅運費計算規則、同特定企業資源規劃（ERP）系統整合，或者建立獨特嘅會員等級制度等需求。呢個時候，開發自定義嘅 WooCommerce 擴展就成為必然選擇。

透過開發擴展，開發者可以將特定嘅業務邏輯封裝成獨立模組，喺唔修改 WooCommerce 核心代碼嘅前提下，無縫增強或修改商店功能。呢種方式確保擴展嘅兼容性、可維護性，並且方便後續更新同升級。無論係為特定行業（例如預訂服務、數碼下載、訂閱制）提供解決方案，定係優化用戶體驗（例如增強搜尋、個性化推薦），自定義擴展都係實現商業差異化同技術自主可控嘅關鍵途徑。

搭建 WooCommerce 擴展開發環境

喺開始寫代碼之前，一個穩定而且貼近生產環境嘅本地開發環境係必不可少嘅。咁樣唔單止可以提高開發效率，亦可以避免喺線上伺服器做實驗可能帶嚟嘅風險。

推薦閱讀 深入剖析WooCommerce：由基礎設定到高效營運嘅完整指南。

本地開發環境配置

推薦使用本地伺服器集成環境，例如 Local by Flywheel、Laragon 或者 XAMPP。呢啲工具可以好快喺本地電腦上面配置好 PHP、MySQL 同網頁伺服器（好似 Apache 或者 Nginx）。你需要確保 PHP 版本同你嘅目標 WordPress 同 WooCommerce 版本兼容，通常建議使用 PHP 7.4 或者更高版本。同時，需要喺本地安裝一個代碼編輯器，好似 Visual Studio Code 或者 PhpStorm，佢哋對 PHP 同 WordPress 開發有好好嘅支援。

UltaHost WordPress 主機

30日退款保證，無限頻寬同數據庫，免費DDoS防護，買3年優惠50%

瀏覽該頁面

安裝 WordPress 同 WooCommerce

喺你嘅本地伺服器環境入面，首先安裝一個全新嘅 WordPress。建議由 WordPress.org 下載最新版本。安裝完成之後，進入 WordPress 後台嘅「外掛」 > 「安裝外掛」頁面，搜尋並安裝 WooCommerce。跟住 WooCommerce 嘅設定精靈完成基本配置，整一個測試產品、設定支付同運費，咁樣就可以為之後嘅擴展開發提供一個真實嘅測試場景。另外，建議開返 WordPress 嘅除錯模式，喺 wp-config.php 檔案入面將 WP_DEBUG 常數設定為 true，咁樣有助於喺開發過程入面快啲發現錯誤。

整你第一個 WooCommerce 插件

WooCommerce 擴展本質上係一個 WordPress 插件。整插件嘅第一步係建立正確嘅檔案結構同聲明插件資訊。

插件基礎檔案結構

喺你嘅 WordPress 安裝目錄下 wp-content/plugins 文件夾入面，開一個新嘅文件夾，例如 my-first-woocommerce-extension。喺呢個文件夾入面，創建主插件文件，通常用插件名命名，例如 my-first-woocommerce-extension.php。呢個係插件嘅入口點，必須包含標準嘅 WordPress 插件頭註釋。

<?php
/**
 * Plugin Name: My First WooCommerce Extension
 * Plugin URI:  https://yourwebsite.com/
 * Description: 一个简单的 WooCommerce 扩展示例，用于演示开发基础。
 * Version:     1.0.0
 * Author:      Your Name
 * License:     GPL v2 or later
 * Text Domain: my-first-wc-ext
 */

加一個簡單嘅功能掛鉤

為咗確保我哋嘅擴展只喺 WooCommerce 啟動嗰陣運行，同埋安全噉加功能，我哋需要用動作掛鉤（Action Hook）或者過濾器掛鉤（Filter Hook）。以下係一個例子，佢喺單個產品頁面嘅標題後面加一段自訂文字。我哋用 woocommerce_single_product_summary 呢個動作鈎子。

推薦閱讀 WooCommerce 是什么及其核心组成部分。

// 防止文件被直接访问
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

// 检查 WooCommerce 是否激活
if ( in_array( 'woocommerce/woocommerce.php', apply_filters( 'active_plugins', get_option( 'active_plugins' ) ) ) ) {

add_action( 'woocommerce_single_product_summary', 'my_custom_product_message', 6 );

function my_custom_product_message() {
        echo '<p class="my-custom-text">呢段係透過自訂擴充功能加入嘅文字！</p>';
    }
}

將上述代碼儲存到你嘅主插件檔案，然後進入 WordPress 後台啟用呢個插件。訪問任何一個產品頁面，你應該可以喺產品標題附近見到加入嘅自訂段落。呢個簡單例子示範咗點樣透過掛鈎介入 WooCommerce 嘅渲染流程。

深入核心：使用動作同過濾器掛鈎

WooCommerce 嘅擴展性好大程度上依賴佢龐大而且靈活嘅掛鈎系統。理解同熟練運用掛鈎係進行高級開發嘅基礎。

常用動作掛鈎示例

動作鈎容許你喺特定時刻「執行」你自己嘅代碼。例如，你可能想喺訂單狀態變為「已完成」時，觸發一個向外部系統傳送數據嘅操作。呢個可以透過 woocommerce_order_status_completed 鈎實現。

hosting.com 共享主機

高效能,配備 AMD EPYC 處理器、NVMe SSD 儲存同 LiteSpeed,提供全天候專業內部支援,採用先進安全措施,包括 SSL、暴力破解、惡意軟件同 DDoS 防護,可節省高達 73%。

瀏覽該頁面

add_action( 'woocommerce_order_status_completed', 'send_order_to_erp' );

function send_order_to_erp( $order_id ) {
    $order = wc_get_order( $order_id );
    // 编写你的逻辑，例如获取订单数据并调用外部 API
    // error_log( "订单 #{$order_id} 已完成，准备同步至ERP。" );
}

另一個常見嘅場景係喺結賬頁面添加自訂欄位。可以用 woocommerce_after_order_notes 動作鈎子。

常用過濾器鈎示例

過濾器掛鈎容許你「修改」已經存在嘅數據。例如，你想為所有產品價格增加一個固定金額嘅附加費，或者修改運費計算嘅結果。修改購物車中某個商品嘅價格可以使用 woocommerce_product_get_price 過濾器。

add_filter( 'woocommerce_product_get_price', 'increase_price_by_ten', 10, 2 );

function increase_price_by_ten( $price, $product ) {
    // 只对特定产品ID为 99 的产品生效
    if ( 99 === $product->get_id() ) {
        $price = $price + 10;
    }
    return $price;
}

修改結賬字段係另一個過濾器掛鈎嘅典型應用，使用 woocommerce_checkout_fields 過濾器可以輕鬆添加、移除或者重新排列字段。

推薦閱讀 深入解析 WooCommerce：由零開始建立高性能電商網站嘅完整指南。

擴展實戰：創建自訂產品標籤頁

為咗提供一個更完整嘅實戰例子，我哋會整一個功能，喺產品頁面度加一個叫做「規格參數」嘅自訂標籤頁。

登記新嘅產品標籤頁

首先，我哋需要用 woocommerce_product_tabs 用篩選器嚟向現有嘅一系列產品標籤頁（例如「描述」、「評價」）度加我哋自己嘅標籤頁。

InterServer 共享主機

共享主機:每月1TB,只需£2.50;首月只需£0.10,使用優惠碼 tryinterserver。461個雲端應用程式腳本,一鍵安裝。

瀏覽該頁面

add_filter( 'woocommerce_product_tabs', 'add_custom_specification_tab' );
function add_custom_specification_tab( $tabs ) {
    // 添加新选项卡
    $tabs['specification_tab'] = array(
        'title'    => __( '规格参数', 'my-first-wc-ext' ),
        'priority' => 50,
        'callback' => 'display_custom_specification_tab_content'
    );
    return $tabs;
}

定義標籤頁內容顯示嘅函數

跟住，我哋需要定義上面嘅回調函數 display_custom_specification_tab_content，用嚟輸出呢個標籤頁入面嘅 HTML 內容。喺呢個例子入面，我哋簡單咁顯示一段硬編碼嘅文字，但係喺實際項目度，你可能會從產品嘅自訂字段（用 Advanced Custom Fields 插件或者原生嘅 post meta）動態攞數據。

function display_custom_specification_tab_content() {
    // 这里可以编写从数据库获取数据的逻辑
    echo '<h2>產品詳細規格</h2>';
    echo '<p>呢度係產品嘅詳細技術規格、物料、尺寸等資料。開發者可以連接自訂字段嚟動態顯示內容。</p>';
    echo '<ul>';
    echo '<li>物料：高級鋁合金</li>';
    echo '<li>尺寸：30厘米 x 20厘米 x 10厘米</li>';
    echo '<li>重量：1.5公斤</li>';
    echo '</ul>';
}

將呢段 code 加落你嘅主插件檔案，保存之後 refresh 一個產品頁面，你應該會睇到喺「描述」標籤頁隔離出現咗一個新嘅「規格參數」標籤頁。呢個實戰案例綜合運用咗過濾器鈎嚟修改 WooCommerce 嘅數據結構，並透過回調函數輸出視圖，係好多擴展功能嘅典型構建模式。

摘要

開發 WooCommerce 擴展係一個將通用電商平台轉化為定制化商業解決方案嘅強大過程。我哋從理解開發自訂擴展嘅必要性出發，建立咗專業嘅本地開發環境，並逐步創建咗一個結構規範嘅基礎插件。透過深入探索 WooCommerce 嘅動作同過濾器鈎子系統，我哋掌握咗喺關鍵流程節點注入或修改功能嘅核心方法。最後嘅實戰練習——創建自訂產品標籤頁，就完整咁串聯起從鈎子使用到前端內容渲染嘅整個開發鏈路。記住始終優先使用鈎子而非直接修改核心檔案嘅原則，咁樣會保證你嘅擴展有良好嘅兼容性、可維護性，並能夠同 WooCommerce 一齊平滑升級。

常見問題

點樣判斷一個功能應該用動作鈎子定係過濾器鈎子？

一個簡單嘅判斷方法係：如果你嘅程式碼需要喺某個時間點「做啲嘢」（例如發送電郵、記錄日誌、輸出HTML），咁通常會用動作鈎子（add_action）。如果你嘅程式碼需要「修改某個已有嘅值」（例如改價錢、調整運費、編輯文字內容），咁就應該用過濾器鈎子（add_filter）。本質上，過濾器係一種特殊嘅、要求有返回值嘅行為。

我嘅擴展需要兼容多個 WooCommerce 版本，應該注意啲咩？

首要原則係避免使用已經廢棄嘅函數同方法。開發嘅時候，要查閱同你使用嘅 WooCommerce 最低支援版本對應嘅官方開發者文檔。使用條件判斷嚟檢測某啲函數或者類係咪存在。例如，喺調用 wc_get_order 之前，可以先檢查函數係咪存在，如果唔存在，就回退到使用較舊嘅 get_order 方式。積極使用 WordPress 同 WooCommerce 嘅版本常量進行特性檢測。

開發過程中點樣高效噉調試代碼？

啟用 WordPress 嘅調試模式係第一步，喺 wp-config.php 度設定 define( 'WP_DEBUG', true );。使用 error_log() 函數將變數資訊記錄到伺服器嘅錯誤日誌度，呢樣對於追蹤邏輯流程好有用。另外，可以安裝 Query Monitor 等開發者插件，佢能夠實時顯示執行嘅掛鉤、數據庫查詢、PHP 錯誤同警告，係 WooCommerce 擴展開發嘅強大輔助工具。

我開發嘅擴展可唔可以提交到 WooCommerce 官方擴展商店？

可以，但過程同要求都幾嚴格。你嘅擴展需要跟足WordPress同WooCommerce嘅編碼標準，提供高質素、冇錯誤嘅代碼，同埋要有良好嘅國際化支援。同時，你需要透過WooCommerce.com提交申請，佢哋團隊會對擴展進行安全、代碼質素同功能性嘅審核。對於個人開發者或者小型團隊，亦可以選擇喺WordPress.org插件目錄或者CodeCanyon等第三方市場發佈。