WooCommerce 安裝與基礎配置
WooCommerce 的安裝過程雖然簡單，但正確的初始配置是構建穩定電商網站的基石。首先，您需要一個運行 PHP 7.4 或更高版本、並安裝了 WordPress 的服務器環境。通過 WordPress 後台的“插件”>“安裝插件”頁面，搜索“WooCommerce”並點擊安裝激活即可。激活後，系統會自動啓動“設置嚮導”，引導您完成商店的基本設置。
在設置嚮導中，您需要依次完成：設置商店所在地、貨幣和單位；配置支付方式（如PayPal、Stripe或銀行轉賬）；設置運費計算規則（如免費送貨、固定運費或基於重量/地址的實時費率）；並推薦安裝一些必要的擴展，如 WooCommerce Payments 或本地化插件。完成嚮導後，您會進入 WooCommerce 的核心設置面板。這裏有幾個關鍵部分需要仔細配置：“常規”選項中可設置銷售地點和税率計算；“產品”選項中可定義度量單位、商品評論和庫存管理；“結賬”頁面是配置所有支付網關和結賬流程的地方；“配送”選項則用於管理發貨區域、方法和包裝。
一個常被忽視但至關重要的步驟是配置永久鏈接。在 WordPress 的“設置”>“固定鏈接”中，確保不要使用“樸素”結構，推薦使用“文章名”或自定義結構，這有利於商品頁面的 SEO。同時，在 WooCommerce 的“高級”設置標籤頁中，您需要為各種頁面（如購物車、結賬、我的賬户等）分配對應的 WordPress 頁面，這些頁面在插件安裝時已自動創建。
推荐阅读 WooCommerce自訂開發指南：從入門到進階的完整實戰教學。
商店基礎信息設置
商店的基礎信息設置主要集中在 WordPress 自定義器和 WooCommerce 常規設置中。您需要確保商店地址、客服郵箱和電話號碼準確無誤，這些信息將出現在訂單通知、發票和頁腳中。此外，在“常規”設置的“貨幣選項”中，可以設置貨幣格式，例如人民幣（¥123.00）或美元（$123.00）。
支付與配送網關集成
支付網關是電商的命脈。WooCommerce 內置了多種支付方式，如 WC_Gateway_BACS（銀行轉賬）、WC_Gateway_CHEQUE（支票支付）和 WC_Gateway_COD（貨到付款）。要啓用 Stripe 或 PayPal 等高級網關，通常需要安裝獨立插件並配置 API 密鑰。例如，配置 Stripe 時，您需要在相應設置頁面填入發佈的密鑰和秘鑰密鑰。
配送設置同樣關鍵。您可以在“配送區域”中為不同國家或地區創建獨立的運費規則。例如，為中國大陸設置一個區域，並添加“免費送貨”、“統一費率”和“本地取貨”等多種方法。通過使用 woocommerce_shipping_init 鈎子，開發者甚至可以創建完全自定義的配送方法類。
核心功能與數據管理
WooCommerce 將所有的電商數據都整合到了 WordPress 的自定義文章類型和分類法中。產品被存儲為 product 文章類型，而訂單則對應 shop_order 文章類型。理解這種數據模型是進行高級自定義開發的前提。
產品管理是核心中的核心。WooCommerce 支持四種產品類型：simple（简单产品）、grouped（分组产品）external（外部/關聯產品）和 variable（可變產品）。可變產品允許您為同一商品設置不同的屬性（如顏色、尺寸）及其對應的價格、庫存和 SKU。在後台編輯產品時，您會用到一系列元數據框，用於管理庫存 SKU、價格、庫存狀態、配送信息以及關聯的商品圖庫。
推荐阅读 什么是 WooCommerce 及其核心架构？。
訂單管理後台提供了完整的銷售概覽。每個訂單都是一個包含豐富元數據的 shop_order 帖子，記錄了客户信息、購買的商品、價格、支付狀態和訂單備註歷史。狀態管理至關重要，默認狀態包括 pending（等待付款）、processing（處理中）、on-hold（暫停）和 completed（已完成）。您可以使用 wc_get_order_statuses 函數獲取所有狀態，並通過 woocommerce_register_shop_order_post_statuses 過濾器註冊自定義狀態。
產品類型與屬性管理
產品屬性是組織複雜商品目錄的利器。您可以在“產品”>“屬性”中創建全局屬性，如“顏色”或“尺寸”。然後，在編輯可變產品時，將這些屬性用於創建“屬性組合”，並針對每個組合（如“紅色-大號”）設置獨立的變體數據。在代碼層面，可以通過 WC_Product_Variable 類和其 get_available_variations() 方法來獲取並操作所有變體信息。
訂單與客户數據處理
WooCommerce 使用 WC_Order 類來封裝訂單數據。通過這個類，您可以編程式地創建或更新訂單。例如，以下代碼展示瞭如何創建一個新訂單並添加商品：
// 创建一个新订单对象
$order = wc_create_order();
// 通过商品ID获取商品对象并添加到订单中
$product = wc_get_product(123);
$order->add_product($product, 2); // 数量为2
// 设置客户地址
$order->set_address(array(
'first_name' => '张',
'last_name' => '三',
'email' => '[email protected]',
'phone' => '13800138000',
), 'billing');
// 计算总额并保存
$order->calculate_totals();
$order->save();客户數據則與 WordPress 用户（WP_User）深度綁定。WooCommerce 通過 wc_get_customer_order_count 以及 wc_get_customer_total_spent 等函數擴展了用户能力。
主題集成與模板覆蓋
WooCommerce 與主題的集成度決定了商店的前端體驗。它採用強大的模板系統，所有前端顯示文件（如商品列表、單個商品頁、購物車）都位於插件目錄的 /templates/ 文件夾中。為了在不修改核心插件文件的前提下自定義這些模板，您需要將它們覆蓋到您的主題中。
正確的方法是：在您的活動主題目錄下，創建一個名為 woocommerce 的文件夾。然後，將您想修改的 WooCommerce 模板文件從插件目錄複製到這個新文件夾中，並在此副本上進行修改。例如，要修改單個商品頁面的結構，您需要複製 plugins/woocommerce/templates/single-product.php 到 themes/your-theme/woocommerce/single-product.php。WooCommerce 會優先加載主題中的模板文件。
推荐阅读 沃康商城（WooCommerce）终极建站指南：从零开始打造您的电商帝国。
除了覆蓋整個文件，您還可以使用動作鈎子（Action Hooks）和過濾器鈎子（Filter Hooks）在特定位置插入或修改內容。例如，woocommerce_before_single_product_summary 鈎子在商品摘要信息之前觸發，是添加自定義橫幅廣告的理想位置。
自定義模板文件結構
WooCommerce 的模板文件具有清晰的層次結構。以商品循環為例，archive-product.php 是商店主頁面模板，它會調用 content-product.php 來渲染每個商品。通過覆蓋這些文件，您可以徹底改變商品在列表中的展示方式，例如更改佈局為網格或列表，或添加自定義徽章。
使用鈎子進行功能擴展
鈎子是 WooCommerce 擴展的脊柱。動作鈎子允許您“執行”代碼，例如在購物車表格後添加一個自定義信息框：
add_action('woocommerce_after_cart_table', 'my_custom_cart_message');
function my_custom_cart_message() {
echo '<div class="custom-notice">购物满500元包邮！</div>';
}過濾器鈎子則允許您“修改”數據。例如，使用 woocommerce_add_to_cart_fragments 過濾器可以動態更新迷你購物車的內容：
add_filter('woocommerce_add_to_cart_fragments', 'update_mini_cart_count');
function update_mini_cart_count($fragments) {
$fragments['div.cart-count'] = '<div class="cart-count">' . WC()->cart->get_cart_contents_count() . '</div>';
return $fragments;
}高級自定義與開發實踐
當內置功能和鈎子無法滿足需求時，就需要進行更深度的自定義開發。這包括創建自定義產品類型、編寫專屬的支付或配送網關，以及通過 REST API 與外部系統集成。
創建自定義產品類型需要擴展 WC_Product 類。首先，您需要定義一個繼承自它的新類，並註冊這個產品類型。例如，創建一個名為“預訂”的產品類：
class WC_Product_Booking extends WC_Product {
public function __construct($product) {
parent::__construct($product);
$this->product_type = 'booking';
}
// 在这里添加自定义方法和属性，如 get_booking_dates()
}
// 将新类注册到工厂
add_filter('woocommerce_product_class', 'register_booking_product_class', 10, 2);
function register_booking_product_class($classname, $product_type) {
if ($product_type == 'booking') {
$classname = 'WC_Product_Booking';
}
return $classname;
}WooCommerce REST API 為移動應用或外部管理系統提供了強大的接口。您可以使用 API 來管理產品、訂單、客户等幾乎所有數據。訪問 API 需要先在後端的“WooCommerce”>“設置”>“高級”>“舊版API”中啓用並創建API密鑰（Consumer Key & Consumer Secret）。然後就可以使用類似以下的端點進行調用：GET /wp-json/wc/v3/products 來獲取產品列表。
開發自定義網關
一個自定義支付網關是一個擴展了 WC_Payment_Gateway 類的 PHP 類。您需要在這個類中定義網關的ID、標題、描述、支付字段，並實現 process_payment 方法來完成支付邏輯。開發完成後，需要通過 woocommerce_payment_gateways 過濾器將其添加到可用網關列表中。
與外部服務進行API集成
WooCommerce 提供了豐富的鈎子來與 ERP、CRM 或物流系統對接。例如，當訂單狀態變更為“已完成”時，會觸發 woocommerce_order_status_completed 動作鈎子。您可以掛接一個函數到這個鈎子上，將訂單數據推送到您的庫存管理系統：
add_action('woocommerce_order_status_completed', 'sync_order_to_erp');
function sync_order_to_erp($order_id) {
$order = wc_get_order($order_id);
$data = array(
'order_id' => $order->get_id(),
'total' => $order->get_total(),
// ... 准备其他数据
);
// 使用 wp_remote_post 将 $data 发送到外部 API
}总结
WooCommerce 不僅僅是一個插件，更是一個功能完備、高度可擴展的電子商務開發框架。從簡單的安裝配置到深度的自定義開發，它通過清晰的模板系統、豐富的鈎子（Actions & Filters）以及面向對象的數據模型，為開發者提供了無限的可能性。成功構建一個 WooCommerce 商店的關鍵在於：紮實的基礎配置確保商店穩定運行；深入理解其產品、訂單數據模型；熟練運用模板覆蓋和鈎子進行前端定製；並掌握通過自定義類、網關和API集成來滿足獨特業務需求的能力。遵循這些最佳實踐，您將能夠打造出強大、高效且完全符合業務邏輯的在線商店。
常见问题解答（FAQ）
如何修改“加入購物車”按鈕的文字？
您可以使用 woocommerce_product_add_to_cart_text 過濾器或 woocommerce_product_single_add_to_cart_text 過濾器來修改按鈕文本。例如，以下代碼將單個商品頁的按鈕文字改為“立即購買”：
add_filter('woocommerce_product_single_add_to_cart_text', 'change_single_add_to_cart_text');
function change_single_add_to_cart_text() {
return '立即购买';
}對於歸檔頁面（商品列表），請使用 woocommerce_product_add_to_cart_text 過濾器，並需要在函數內判斷產品類型。
如何為特定產品類別添加自定義字段？
您需要結合使用 WooCommerce 的產品分類鈎子和 WordPress 的術語元數據 API。首先，使用 product_cat_add_form_fields 以及 product_cat_edit_form_fields 動作在分類添加/編輯頁面輸出字段。然後，使用 created_term 以及 edit_term 動作來保存字段值到 term_meta。最後，您可以在模板文件中使用 get_term_meta 來獲取並顯示這個值。
我的自定義模板修改為什麼沒有生效？
請按以下步驟排查：首先，確認您將模板文件複製到了正確的主題路徑：your-theme/woocommerce/ 下，且目錄結構與原插件模板一致。其次，清除所有緩存，包括瀏覽器緩存、WordPress 對象緩存以及任何服務器端緩存（如OPcache）。最後，檢查您的主題 functions.php 是否正確地聲明瞭 WooCommerce 支持：add_theme_support('woocommerce');。如果問題依舊，嘗試暫時切換到默認主題（如Storefront）以排除主題兼容性問題。
如何編程式地創建一個 WooCommerce 可變產品？
您需要使用 WC_Product_Variable 類。基本步驟是：創建產品對象並設置基礎屬性；創建和添加全局屬性（如顏色）；為這些屬性創建具體的屬性組合（即變體）；最後為每個變體創建獨立的 WC_Product_Variation 對象，設置其價格、庫存等特有屬性，並關聯到主產品。這是一個多步驟的過程，通常涉及 wp_set_object_terms, set_attributes, 以及 save 等方法。
接下来，我该怎么做呢？
延伸阅读与实用知识
下方这些内容与本文主题相关，适合继续深入阅读。建议先从与你当前问题最相关的文章开始看起，然后再逐步扩展到相关主题，这样通常效果会更好。