SuperAPI AI 工具集

woocommerce-setup

通用与其它

查看项目

更新于 10-16 03:17

技能介绍

用途:这是一份 WooCommerce 扩展开发的基础参考,帮助在新建扩展时正确完成初始化、插件头部声明与兼容性声明,并避免常见架构错误。

主要能力:

  1. 可用性检查:始终以 WooCommerce 是否存在为门槛,使用 class_exists( 'WooCommerce' ) 判断,不满足时通过 admin_notices 提示当前扩展需要 WooCommerce。
  2. 插件头部:提供头部字段说明,包括 Requires Plugins: woocommerce(WordPress 6.5+ 会自动强制该依赖)、WC requires at least(最低 WooCommerce 版本)、WC tested up to(已测试的最新版本),以及 Requires PHP。
  3. 功能兼容性声明:在 before_woocommerce_init 钩子中,若类 \Automattic\WooCommerce\Utilities\FeaturesUtil 存在,则调用 FeaturesUtil::declare_compatibility() 声明兼容性;键 custom_order_tables 表示 HPOS(高性能订单存储)兼容,cart_checkout_blocks 表示区块结账兼容。
  4. 架构要点:WooCommerce Interactivity API 的 store 全部使用 lock: true,属于私有、不可扩展,其状态与选择器变更不算破坏性变更,扩展不应依赖这些内部实现。
  5. 常见错误与修复:未检查 WooCommerce 是否激活、未声明 HPOS 或区块结账兼容、对 DI 管理的 WC 类使用 new(应使用 wc_get_container()->get( ClassName::class ) 获取 src/ 单例)、依赖 WC Interactivity API store、缺少 Requires Plugins: woocommerce 头部。

使用方式:在插件主文件中按上述模式挂载钩子并填写头部;具体主题可参考相关技能 woocommerce-payments、woocommerce-data、woocommerce-hooks。

适用场景:开发新的 WooCommerce 扩展、为现有扩展补充兼容性声明、排查依赖与初始化问题。

限制:资料仅覆盖初始化、头部与兼容性声明等基础内容,未涉及具体版本适用范围之外的细节、收费或效果说明;相关主题需查阅配套技能。