SuperAPI AI 工具集

woocommerce-data

数据与分析

查看项目

更新于 10-16 03:17

技能介绍

用途:面向 WooCommerce 开发,提供兼容 HPOS(High-Performance Order Storage)的数据访问、产品与客户 CRUD、Store API 及 REST API 集成参考。

主要能力:

  1. HPOS 订单存储。自 WooCommerce 8.2 起新装默认使用 HPOS,订单存于自定义表而非 wp_postmeta。读写订单应始终使用 CRUD 方法,例如 wc_get_order() 及 $order->get_total()、get_status()、get_billing_email()、get_meta();写入用 set_status()、update_meta_data() 后必须调用 save()。查询订单用 wc_get_orders(),兼容 HPOS 与传统存储。扩展需在 before_woocommerce_init 钩子中通过 FeaturesUtil::declare_compatibility('custom_order_tables', FILE, true) 声明兼容。
  2. 产品与客户 CRUD。产品用 wc_get_product() 读取名称、价格、SKU、库存、类型及 meta,写入用 set_regular_price()、update_meta_data() 后 save()。产品类型包括 simple、variable、variation、grouped、external,对应 WC_Product_Simple 等类。客户用 new WC_Customer($user_id) 读取邮箱、订单数、总消费,并可 update_meta_data() 后 save()。
  3. 数据完整性。删除或修改前需校验实体存在、状态与归属,并检查 save/delete 返回值。
  4. DI 容器。src/ 下类使用依赖注入,通过 wc_get_container()->get() 获取;Internal 类属私有 API,仅依赖有文档的 API。
  5. Store API。面向购物车、结账与商品的公开免认证 REST 接口,命名空间 wc/store/v1,含商品列表、购物车获取与加购、结账下单(9.8+ 支持 PUT 更新)。可通过 ExtendSchema 注册端点数据扩展响应。
  6. REST API。需 consumer key 与 secret 认证,用于后台操作,命名空间含 wc/v3、wc/store/v1、wc-admin、wc-analytics;常见端点覆盖产品、订单、客户、优惠券、报表与 webhook。示例:curl https://example.com/wp-json/wc/v3/products -u ck_xxx:cs_xxx。

限制与注意:禁止用 get_post_meta()、update_post_meta()、new WP_Query(['post_type'=>'shop_order'])、get_post() 或直接 SQL 访问订单数据;不要用 $woocommerce 全局而应使用 WC();未调用 save() 的 CRUD 更改不会持久化;删除订单前须校验状态;批量操作须逐项验证存在性、状态与归属。相关技能包括 woocommerce-setup、woocommerce-payments、woocommerce-hooks。资料的安装命令、收费、价格等信息暂未提供。