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 等方法。
下一步，接下来该怎么做？
延伸阅读与实用知识
下面这些内容与本文主题相关，适合继续深入阅读。优先从与你当前问题最接近的文章开始看，再逐步扩展到周边主题，效果通常会更好。