WooCommerce 擴展開發環境搭建
喺開始編寫任何代碼之前，建立一個穩定且高效嘅本地開發環境至關重要。咁樣唔單止可以確保你嘅擴展同最新嘅WooCommerce版本兼容，仲可以畀你喺安全嘅環境度測試所有功能，而唔會影響到線上商店嘅運作。
本地開發環境嘅配置
一個典型嘅WooCommerce擴展開發環境至少需要包含PHP、MySQL/MariaDB同一個Web服務器（例如Nginx或者Apache）。強烈建議使用集成嘅本地服務器軟件，例如Local by Flywheel、Laravel Valet或者XAMPP。呢啲工具簡化咗環境配置過程。你需要確保PHP版本符合WooCommerce嘅最低要求（通常係7.4或者更高），並啟用必要嘅擴展，例如cURL、GD/ImageMagick同OpenSSL。
核心文件與代碼結構
WooCommerce嘅核心係一個精心設計嘅插件，佢嘅擴展機制主要依賴於WordPress嘅插件架構。一個最基本嘅WooCommerce擴展本身都係一個標準嘅WordPress插件。所以，你嘅擴展項目應該由一個主插件檔案開始，例如 your-extension.php。呢個檔案必須包含標準嘅WordPress插件頭部註釋，用喺WordPress後台識別你嘅插件。
推薦閱讀 WooCommerce教學：由零開始建立專業網店嘅完整指南。
/**
* Plugin Name: Your Awesome WooCommerce Extension
* Plugin URI: https://yourwebsite.com/
* Description: 为WooCommerce添加自定义功能。
* Version: 1.0.0
* Author: Your Name
* License: GPL v2 or later
* Text Domain: your-text-domain
*/喺檔案入面，你需要用 add_action 鈎子嚟確保你嘅代碼喺WooCommerce載入完成之後先至執行。一個常見嘅做法係掛載到 plugins_loaded 或 woocommerce_loaded 動作上。
add_action( 'plugins_loaded', 'initialize_your_extension' );
function initialize_your_extension() {
// 检查WooCommerce是否已激活
if ( ! class_exists( 'WooCommerce' ) ) {
add_action( 'admin_notices', function() {
?>
<div class="notice notice-error">
<p><?php _e( '本插件需要WooCommerce才能运行。请先安装并激活WooCommerce。', 'your-text-domain' ); ?></p>
</div>
<?php
} );
return;
}
// 你的扩展核心代码从这里开始
// ...
}理解WooCommerce嘅核心擴展機制
WooCommerce嘅強大之處在於其高度可擴展嘅架構。開發者主要透過幾種核心機制嚟修改同增強其功能：動作鈎子（Action Hooks）、過濾器鈎子（Filter Hooks）、自定義模板覆蓋以及類同函數嘅繼承與重寫。
利用動作同過濾器鈎子
鈎子（Hooks）係WordPress同WooCommerce擴展嘅基石。動作鈎子容許你喺特定時刻「執行」你自己嘅代碼。例如，你可以喺用戶完成訂單後（woocommerce_thankyou）觸發一個自定義函數，向第三方系統發送通知。
過濾器掛鈎容許你「修改」流程中傳遞嘅數據。例如，你可以用 woocommerce_product_get_price 過濾器動態噉改變商品價格，又或者用 woocommerce_checkout_fields 過濾器去增加、移除或者修改結賬表單入面嘅欄位。
// 示例：在结账页面添加一个自定义字段
add_filter( 'woocommerce_checkout_fields', 'add_custom_checkout_field' );
function add_custom_checkout_field( $fields ) {
$fields['billing']['billing_custom_field'] = array(
'label' => __( '自定义信息', 'your-text-domain' ),
'placeholder' => _x( '请输入...', 'placeholder', 'your-text-domain' ),
'required' => false,
'class' => array( 'form-row-wide' ),
'clear' => true
);
return $fields;
}
// 示例：保存自定义字段的值
add_action( 'woocommerce_checkout_update_order_meta', 'save_custom_checkout_field' );
function save_custom_checkout_field( $order_id ) {
if ( ! empty( $_POST['billing_custom_field'] ) ) {
update_post_meta( $order_id, '_billing_custom_field', sanitize_text_field( $_POST['billing_custom_field'] ) );
}
}自訂模板覆蓋
WooCommerce 用一套模板檔案去控制前端頁面嘅顯示，好似商品詳情頁、購物車同埋結賬頁面。為咗修改呢啲頁面嘅外觀，最佳做法係用模板覆蓋，而唔係直接修改 WooCommerce 核心插件入面嘅檔案。
推薦閱讀 WordPress插件開發入門指南：從零開始建立你嘅第一個功能插件。
具體操作係：喺你嘅主題（最好係子主題）或者插件目錄入面，創建一個叫做 woocommerce 嘅資料夾，然後將你想修改嘅核心模板文件複製到呢個目錄入面，並且保持相同嘅路徑結構。例如，要覆蓋購物車頁面模板，你需要從WooCommerce插件嘅 templates/cart/cart.php 複製文件到你主題嘅 woocommerce/cart/cart.php，然後改呢個副本。
開發一個自訂功能擴展
而家，等我哋實踐一個完整例子：開發一個插件，為簡單產品添加一個「自訂價格」欄位，並容許前台顧客輸入呢個價格進行購買（例如，用嚟捐款或者自訂金額商品）。
創建主插件類
為咗保持代碼嘅封裝性同可維護性，我哋採用面向對象編程（OOP）嘅方式，將所有功能封裝喺一個主類入面。我哋會將呢個類命名為 WC_Custom_Price_Product。
if ( ! class_exists( 'WC_Custom_Price_Product' ) ) {
class WC_Custom_Price_Product {
/**
* 构造方法，初始化所有钩子。
*/
public function __construct() {
// 后台：为产品添加自定义字段
add_action( 'woocommerce_product_options_pricing', array( $this, 'add_admin_custom_price_field' ) );
add_action( 'woocommerce_process_product_meta', array( $this, 'save_admin_custom_price_field' ) );
// 前台：在产品页面显示输入框并处理价格
add_action( 'woocommerce_before_add_to_cart_button', array( $this, 'add_frontend_price_input' ) );
add_filter( 'woocommerce_add_cart_item_data', array( $this, 'add_custom_price_to_cart_item' ), 10, 2 );
add_filter( 'woocommerce_get_item_data', array( $this, 'display_custom_price_on_cart_and_checkout' ), 10, 2 );
add_action( 'woocommerce_before_calculate_totals', array( $this, 'apply_custom_price_to_cart_item' ), 20, 1 );
}
// 后续方法将在这里定义...
}
// 实例化类
new WC_Custom_Price_Product();
}實現後台管理功能
首先，我哋喺產品編輯頁嘅「常規」選項卡度加一個核取方塊，等商家可以啟用呢個功能，同埋可能設一個最低價。
public function add_admin_custom_price_field() {
global $product_object;
woocommerce_wp_checkbox( array(
'id' => '_enable_custom_price',
'label' => __( '允许自定义价格', 'your-text-domain' ),
'description' => __( '允许顾客在前台输入他们希望支付的价格。', 'your-text-domain' ),
'value' => $product_object->get_meta( '_enable_custom_price' ) === 'yes' ? 'yes' : 'no',
) );
woocommerce_wp_text_input( array(
'id' => '_min_custom_price',
'label' => __( '最低价格（可选）', 'your-text-domain' ) . ' (' . get_woocommerce_currency_symbol() . ')',
'placeholder' => '0.00',
'desc_tip' => true,
'description' => __( '设置顾客可以输入的最低价格。', 'your-text-domain' ),
'type' => 'number',
'custom_attributes' => array(
'step' => '0.01',
'min' => '0',
),
'value' => $product_object->get_meta( '_min_custom_price' ) ? $product_object->get_meta( '_min_custom_price' ) : '',
) );
}
public function save_admin_custom_price_field( $post_id ) {
$enable_custom_price = isset( $_POST['_enable_custom_price'] ) ? 'yes' : 'no';
update_post_meta( $post_id, '_enable_custom_price', $enable_custom_price );
if ( isset( $_POST['_min_custom_price'] ) ) {
update_post_meta( $post_id, '_min_custom_price', sanitize_text_field( $_POST['_min_custom_price'] ) );
}
}處理前台交互同購物車邏輯
喺前台，我哋需要檢查呢個產品係咪啟用咗自定價格功能。如果係，就顯示一個輸入框。
public function add_frontend_price_input() {
global $product;
if ( $product->get_meta( '_enable_custom_price' ) !== 'yes' ) {
return;
}
$min_price = $product->get_meta( '_min_custom_price' );
?>
<div class="custom-price-field">
<label for="custom_price"><?php _e( '请输入您的价格', 'your-text-domain' ); ?>
<?php if ( $min_price ) : ?>
<small>(<?php printf( __( '最低：%s', 'your-text-domain' ), wc_price( $min_price ) ); ?>)</small>
<?php endif; ?>
</label>
<input type="number" name="custom_price" id="custom_price" step="0.01"
<?php echo $min_price ? 'min="' . esc_attr( $min_price ) . '"' : 'min="0"'; ?>
value="<?php echo $min_price ? esc_attr( $min_price ) : ''; ?>"
style="width:200px; display:block; margin-bottom:1em;" />
</div>
<?php
}當用戶撳「加入購物車」嗰陣，我哋需要擷取呢個自定價格，同埋將佢當做購物車項目數據保存。
推薦閱讀 踏上 WordPress 插件開發之旅,就代表你已經掌握咗為全球用戶製作插件嘅藝術。。
public function add_custom_price_to_cart_item( $cart_item_data, $product_id ) {
if ( isset( $_POST['custom_price'] ) && ! empty( $_POST['custom_price'] ) ) {
$cart_item_data['custom_price'] = floatval( $_POST['custom_price'] );
$cart_item_data['unique_key'] = md5( microtime().rand() ); // 确保项目唯一性
}
return $cart_item_data;
}
public function display_custom_price_on_cart_and_checkout( $item_data, $cart_item ) {
if ( isset( $cart_item['custom_price'] ) ) {
$item_data[] = array(
'name' => __( '自定义价格', 'your-text-domain' ),
'value' => wc_price( $cart_item['custom_price'] ),
);
}
return $item_data;
}最後，亦係最關鍵嘅一步，就係喺計算購物車總額嗰陣，用我哋保存嘅自訂價格取代產品嘅原始價格。
public function apply_custom_price_to_cart_item( $cart ) {
if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
return;
}
if ( did_action( 'woocommerce_before_calculate_totals' ) >= 2 ) {
return;
}
foreach ( $cart->get_cart() as $cart_item_key => $cart_item ) {
if ( isset( $cart_item['custom_price'] ) ) {
$cart_item['data']->set_price( $cart_item['custom_price'] );
}
}
}擴展測試、分發同維護
開發完成之後，必須進行全面嘅測試，包括功能測試、兼容性測試（唔同主題、其他插件）同埋安全性檢查（例如數據驗證同清理）。可以用好似WP-CLI、PHPUnit同埋瀏覽器自動化工具呢啲嘢嚟幫手測試。
準備發佈到官方市場
若果你計劃喺WooCommerce官方市場或者WordPress插件目錄度發佈，你需要精心準備插件資料：一個清晰嘅 readme.txt 檔案（跟返標準格式）、詳細嘅說明文件、高質素嘅橫幅同圖示。代碼必須要跟足WordPress同WooCommerce嘅編碼標準，同埋確保冇用到同GPL授權唔兼容嘅代碼。
後續更新同支援
維護係擴展生命週期嘅重要部分。你需要建立機制去處理用家回饋、修復漏洞，同埋跟住WooCommerce核心嘅更新去做兼容性升級。用版本控制（例如Git）同語意化版本號（SemVer）去管理你嘅代碼變更。考慮為你嘅擴展加一個自動更新檢查器，咁樣就可以向已經安裝咗嘅用家推送安全更新同功能改進。
摘要
WooCommerce擴展開發係一個將你嘅創意轉化為強大電商功能嘅過程。透過掌握環境搭建、理解掛鉤同模板系統，你可以深入自訂商店嘅每一個環節。本文透過一個完整嘅「自訂價格產品」例子，示範咗由後台欄位建立、前台互動到購物車邏輯處理嘅完整開發流程。記住，優秀嘅擴展始於清晰嘅需求、嚴謹嘅代碼結構同全面嘅測試。隨住WooCommerce生態嘅持續發展，不斷學習同實踐佢最新嘅API同最佳做法，會令你能夠建立到更專業、更可靠嘅商業解決方案。
常見問題
開發WooCommerce擴展需要咩先決知識？
你需要有扎實嘅PHP編程基礎，熟識面向對象編程（OOP）概念。同時，必須深入理解WordPress嘅核心機制，包括動作鈎（Actions）、過濾器鈎（Filters）、自定義文章類型（CPT）同元數據（Metadata）嘅操作。對HTML、CSS、JavaScript（特別係jQuery）同MySQL有基本了解都係必要嘅。
點樣調試WooCommerce擴展中嘅問題？
首先，要確保喺 wp-config.php 檔案中啟用咗 WP_DEBUG 同埋 WP_DEBUG_LOG，咁樣會將錯誤信息記錄到日誌文件度。其次，WooCommerce自身提供咗日誌系統，可以透過 wc_get_logger() 函數記錄擴展嘅運行狀態。另外，使用瀏覽器嘅開發者工具（控制台同網絡選項卡）嚟檢查前端JavaScript錯誤同AJAX請求回應。對於複雜嘅邏輯問題，可以使用Xdebug等PHP調試工具進行逐步調試。
我嘅擴展點樣兼容唔同嘅WooCommerce版本？
喺開發嘅時候，應該一直留意WooCommerce官方文檔中關於函數同掛鈎棄用嘅說明。喺代碼入面，使用條件判斷嚟檢查WooCommerce嘅版本或者某個類/方法係咪存在，從而提供向後兼容嘅替代方案。例如：if ( version_compare( WC_VERSION, '4.0.0', '>=' ) ) { // 使用新API } else { // 使用旧API }喺插件發佈信息中明確聲明支持嘅最低同最高WooCommerce版本。
點樣安全處理用戶輸入同支付數據？
所有來自用戶輸入嘅數據（例如 $_POST, $_GET）都一定要經過驗證同清理。用WordPress提供嘅函數，例如 sanitize_text_field(), absint(), wp_unslash() 等。對於輸出到瀏覽器嘅數據，用 esc_html(), esc_attr(), wp_kses_post() 等進行轉義。絕對唔好自己處理或儲存原始嘅信用卡號碼等敏感支付資料，應該一直依賴 WooCommerce 內置嘅支付閘道或者使用經過嚴格安全審計嘅第三方支付 API 嚟實現支付功能。
下一步應該點做?
延伸閱讀及實用知識
以下內容與本文主題相關,適合進一步閱讀。一般而言,最好由與你目前問題最緊密相關的文章開始,然後逐步擴展到周邊主題。