WooCommerce 作爲 WordPress 生態中最強大的電子商務插件，其真正的力量不僅在於開箱即用的功能，更在於其高度可擴展的架構。這個架構的核心便是基於 WordPress 插件 API 的“鉤子”（Hooks）和“過濾器”（Filters）系統。理解並運用這套系統，開發者可以深入 WooCommerce 的內部流程，在不修改核心代碼的前提下，精準地添加、修改或移除功能，從而實現高度定製化的電商解決方案。
WooCommerce 鉤子與過濾器基礎
在深入具體示例之前，我們有必要釐清兩個核心概念：動作鉤子（Action Hooks）和過濾器鉤子（Filter Hooks）。它們是所有 WooCommerce 定製化的基石。
add_action() 用於掛載到一個動作鉤子。動作鉤子在代碼執行的特定時刻被觸發，允許你在該時刻“執行”你自己的代碼。例如，在購物車頁面加載後添加一個橫幅，或在結賬完成後向管理員發送一封郵件。它不期望返回值，其目的是“做某事”。
推荐阅读 WordPress插件開發：從零到一構建功能強大的網站擴展。
add_filter() 用於掛載到一個過濾器鉤子。過濾器鉤子允許你“修改”一個正在被處理的數據。例如，修改商品價格的計算方式、更改運費標籤的文本，或調整訂單號的生成規則。它期望你返回一個修改後的值。
一個簡單的記憶方法是：動作是執行，過濾器是修改。幾乎所有 WooCommerce 的定製都離不開對這兩者的運用。
核心動作鉤子應用場景
動作鉤子遍佈於 WooCommerce 的整個生命週期，從商品展示到訂單完成。掌握幾個關鍵鉤子，你就能在用戶旅程的關鍵節點注入自定義邏輯。
在商品詳情頁添加自定義內容
woocommerce_before_add_to_cart_form 以及 woocommerce_after_add_to_cart_form 是兩個在“加入購物車”按鈕表單前後觸發的鉤子。假設你想在複雜商品（如可變商品）的表單前顯示一個提示信息，可以這樣操作：
add_action( 'woocommerce_before_add_to_cart_form', 'custom_before_add_to_cart_message' );
function custom_before_add_to_cart_message() {
global $product;
if ( $product->is_type( 'variable' ) ) {
echo '<p class="custom-note">请先选择所需的规格属性。</p>';
}
}在結賬流程中插入額外步驟
woocommerce_before_checkout_form 以及 woocommerce_after_checkout_form 允許你在整個結賬表單前後添加內容。而 woocommerce_checkout_before_customer_details 以及 woocommerce_checkout_after_customer_details 則更精確地定位在客戶信息區塊的前後。這些鉤子常被用於顯示配送政策、優惠券說明或信任徽章。
推荐阅读 WooCommerce 插件开发指南：从零开始打造定制化电商功能。
核心過濾器應用場景
過濾器讓你能夠精細地調整 WooCommerce 輸出的數據和文本，是實現業務規則和個性化展示的利器。
修改價格顯示格式
woocommerce_get_price_html 過濾器用於過濾商品價格的 HTML 輸出。如果你想爲所有打折商品在價格後面加上“（促銷中）”字樣，可以這樣實現：
add_filter( 'woocommerce_get_price_html', 'custom_price_suffix', 10, 2 );
function custom_price_suffix( $price, $product ) {
if ( $product->is_on_sale() ) {
$price .= ' <span class="sale-badge">（促销中）</span>';
}
return $price;
}自定義購物車與結賬字段
woocommerce_checkout_fields 是一個功能極其強大的過濾器，它允許你添加、刪除、修改或重新排序結賬頁面上的所有字段。例如，如果你想將“公司名稱”字段設爲必填，並修改“地址2”字段的標籤：
add_filter( 'woocommerce_checkout_fields', 'customize_checkout_fields' );
function customize_checkout_fields( $fields ) {
// 将“公司名称”设为必填
$fields['billing']['billing_company']['required'] = true;
// 修改“地址行2”的标签和占位符
$fields['billing']['billing_address_2']['label'] = '公寓、套房、单元等（可选）';
$fields['billing']['billing_address_2']['placeholder'] = '';
return $fields;
}高級實戰：組合使用鉤子與過濾器
真正的定製化通常需要將動作和過濾器組合使用，並編寫更復雜的業務邏輯。
創建自定義訂單狀態
雖然 WooCommerce 自帶多種訂單狀態，但你可能需要添加一個如“待配貨”的狀態。這需要組合使用過濾器來定義狀態，以及動作來管理狀態轉換時的操作。
首先，使用 wc_order_statuses 過濾器註冊新狀態：
推荐阅读 WooCommerce电商网站开发：从零开始搭建你的在线商店。
add_filter( 'wc_order_statuses', 'add_custom_order_status' );
function add_custom_order_status( $order_statuses ) {
$order_statuses['wc-awaiting-prep'] = '待配货';
return $order_statuses;
}然後，你可以在管理員訂單列表使用 woocommerce_order_actions 過濾器添加一個手動觸發該狀態的操作按鈕，並用 woocommerce_order_action_* 自定義動作來處理狀態更新後的邏輯，如發送郵件通知倉庫。
根據購物車內容動態調整功能
你可以監聽 woocommerce_before_calculate_totals 動作來在計算總額前修改購物車內商品的價格或屬性。同時，結合 woocommerce_cart_item_name 過濾器，在購物車表格中動態顯示與這些修改相關的自定義信息。
例如，檢測購物車中是否有特定品類的商品，如果有，則對另一類商品提供折扣，並在其名稱旁顯示“組合優惠”標籤。這需要對 WooCommerce 的購物車對象有深入理解，並妥善處理會話與緩存。
总结
WooCommerce 的鉤子與過濾器系統是一個強大而精巧的抽象層，它將核心代碼的穩定性與擴展的靈活性完美結合。從簡單的文本修改到複雜的業務流程再造，開發者都可以通過 add_action 以及 add_filter 這兩個函數介入。成功定製的關鍵在於：第一，準確找到生命週期中對應的鉤子；第二，理解傳遞的參數和上下文；第三，編寫高效、安全的回調函數。通過系統性地學習和實踐這些鉤子，你將能突破主題和插件的限制，打造出完全符合業務需求的獨一無二的電商網站。
常见问题解答（FAQ）
如何查找可用的 WooCommerce 鉤子？
最直接的方法是查閱 WooCommerce 官方開發者文檔，其中有一個專門的“鉤子參考”部分。
此外，你可以在你的 WordPress 網站的代碼文件中，使用文本編輯器的搜索功能，在 WooCommerce 插件目錄中搜索“do_action”和“apply_filters”來發現鉤子定義。也可以使用一些第三方插件或代碼片段庫來探索常用鉤子。
我的自定義代碼應該放在哪裏？
最佳實踐是將你的自定義代碼添加到子主題的 functions.php 文件中。這可以確保主題更新時你的修改不會被覆蓋。
如果你預計代碼量很大或功能獨立，也可以創建一個專屬的功能插件來管理所有 WooCommerce 定製代碼。絕對不要直接修改 WooCommerce 插件或父主題的核心文件。
爲什麼我的過濾器沒有生效？
首先，檢查你的回調函數優先級（add_filter 的第三個參數）是否合適。數字越小優先級越高，越早執行。如果其他插件修改了同一個值並在之後執行（優先級數字更大），它們可能會覆蓋你的修改。
其次，確保你的回調函數正確返回了值。過濾器函數必須有一個 return 語句。
最後，確認鉤子名稱拼寫正確，並且你的代碼在鉤子被觸發之後已經加載。
動作和過濾器可以移除嗎？
可以。使用 remove_action() 以及 remove_filter() 函數可以移除已經添加的鉤子回調。但這需要你知道回調函數註冊時的函數名、優先級等信息，且必須在原鉤子被添加之後、執行之前進行移除。操作需謹慎，以免破壞其他插件或主題的功能。
如何調試鉤子的執行順序和參數？
使用調試工具是最高效的方法。安裝如“Query Monitor”這樣的 WordPress 調試插件，它有一個專門的“鉤子”面板，可以列出頁面加載過程中執行的所有鉤子、它們的回調函數、優先級和參數，這對於理解複雜流程和排查衝突至關重要。同時，確保在 wp-config.php 中開啓 WP_DEBUG 模式。
接下来，我该怎么做呢？
延伸阅读与实用知识
以下内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始阅读，之后再逐步扩展到相关主题，这样通常效果会更好。