用途:这是一份 WooCommerce 扩展开发的基础参考,帮助在新建扩展时正确完成初始化、插件头部声明与兼容性声明,并避免常见架构错误。
主要能力:
- 可用性检查:始终以 WooCommerce 是否存在为门槛,使用 class_exists( 'WooCommerce' ) 判断,不满足时通过 admin_notices 提示当前扩展需要 WooCommerce。
- 插件头部:提供头部字段说明,包括 Requires Plugins: woocommerce(WordPress 6.5+ 会自动强制该依赖)、WC requires at least(最低 WooCommerce 版本)、WC tested up to(已测试的最新版本),以及 Requires PHP。
- 功能兼容性声明:在 before_woocommerce_init 钩子中,若类 \Automattic\WooCommerce\Utilities\FeaturesUtil 存在,则调用 FeaturesUtil::declare_compatibility() 声明兼容性;键 custom_order_tables 表示 HPOS(高性能订单存储)兼容,cart_checkout_blocks 表示区块结账兼容。
- 架构要点:WooCommerce Interactivity API 的 store 全部使用 lock: true,属于私有、不可扩展,其状态与选择器变更不算破坏性变更,扩展不应依赖这些内部实现。
- 常见错误与修复:未检查 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 扩展、为现有扩展补充兼容性声明、排查依赖与初始化问题。
限制:资料仅覆盖初始化、头部与兼容性声明等基础内容,未涉及具体版本适用范围之外的细节、收费或效果说明;相关主题需查阅配套技能。