woocommerce

用途

WooCommerce 是 WordPress 的电子商务开发方案。本资料面向开发者，介绍如何通过代码扩展 WooCommerce 商店，包括自定义产品类型、支付网关、配送方式、钩子（Hooks）、REST API 以及商店性能优化。

主要能力

资料以 PHP 代码示例的形式，覆盖以下开发方向：

钩子（Hooks）

• 产品钩子：通过 woocommerce_get_price_html 修改商品价格显示（如添加促销标签）；通过 woocommerce_product_options_general_product_data 为商品添加自定义字段，并用 woocommerce_process_product_meta 保存。
• 购物车钩子：通过 woocommerce_cart_calculate_fees 向购物车添加费用（如小额订单手续费）；通过 woocommerce_check_cart_items 校验购物车商品（如库存检查）；通过 woocommerce_add_cart_item_data 修改购物车项数据。
• 结账钩子：通过 woocommerce_after_order_notes 添加自定义结账字段（如期望配送日期）；通过 woocommerce_checkout_process 校验该字段；通过 woocommerce_checkout_update_order_meta 将字段保存到订单。
• 订单钩子：通过 woocommerce_order_status_completed 在订单完成后向外部系统发送数据（如 webhook）；通过 woocommerce_order_status_changed 处理订单状态变更。

自定义产品类型

示例展示了如何继承 WC_Product 注册自定义产品类型（如订阅类型），并通过 product_type_selector 过滤器将其加入产品类型选择器，以及在产品数据面板中显示对应的自定义字段。

支付网关

示例展示了如何继承 WC_Payment_Gateway 创建自定义支付网关，包括定义表单字段（启用开关、API Key）、实现 process_payment 调用外部支付 API 并完成订单、实现 process_refund 处理退款，最后通过 woocommerce_payment_gateways 过滤器注册网关。

REST API

• 自定义端点：通过 rest_api_init 注册自定义路由（如获取特色产品列表），返回商品 ID、名称、价格、图片和链接。
• 扩展现有端点：通过 woocommerce_rest_prepare_product_object 向产品 API 响应添加自定义字段；通过 woocommerce_rest_insert_product_object 允许通过 API 更新自定义字段。

性能优化

• 查询优化：禁用不必要的功能（如背景图像重新生成、nocache 头）；通过 loop_shop_per_page 限制每页商品数量；对昂贵查询（如热销商品）使用 transient 缓存，并在订单完成时清除缓存。
• AJAX 购物车：通过 wp_ajax_update_cart_item 和 wp_ajax_nopriv_update_cart_item 实现 AJAX 更新购物车项数量或移除商品，并刷新购物车片段。

邮件定制

• 通过 woocommerce_email_order_details 向订单邮件添加内容。
• 示例展示了如何继承 WC_Email 创建自定义邮件类，并通过 woocommerce_email_classes 过滤器注册。

使用方式

资料中的代码示例均为 PHP 片段，通常需要放入主题的 functions.php 文件或自定义插件中。部分示例涉及类定义（如自定义产品类型、支付网关、邮件类），需注意加载时机与命名冲突。所有代码示例均保留原始内容，未作改动。

适用场景

• 需要为 WooCommerce 商店添加自定义产品类型、支付方式或配送方式的开发者。
• 需要通过钩子修改商店行为（价格显示、购物车、结账、订单处理）的开发者。
• 需要扩展 WooCommerce REST API 或优化商店性能的开发者。
• 需要定制订单邮件通知的开发者。

限制

资料未提供关于安装步骤、环境要求、版本兼容性、收费模式或价格的信息，这些内容暂未提供。资料中的代码示例为演示性质，实际使用前需根据具体环境进行测试与调整。