WooCommerce Extension Development
Optional module of the WordPress stack (WooCommerce 11.2 line, WordPress 7.0+, PHP 7.4+). Load it only when the project depends on WooCommerce. The WordPress core rules (hooks, security, i18n, tests) still apply.
When to Use
- Plugin header has
Requires Plugins: woocommerce, or code callswc_*functions,WC_Order,WC_Product,WC() - Work touches orders, products, customers, cart, checkout, payment gateways, shipping, emails or webhooks
- A
before_woocommerce_inithook orFeaturesUtilcall is present or missing
Key Rules
- HPOS first: orders are not posts. Use
wc_get_order(),wc_get_orders(),$order->get_meta()and$order->update_meta_data()followed by$order->save(). Neverget_post(),WP_Queryor*_post_meta()on orders - Declare compatibility on
before_woocommerce_initwithFeaturesUtil::declare_compatibility()forcustom_order_tablesandcart_checkout_blocks, guarded byclass_exists() - Use the CRUD layer (
WC_Data,WC_Product,WC_Customer,WC_Order) for reads and writes; avoid direct SQL on WooCommerce tables - Blocks-ready checkout: extend Cart and Checkout through the Store API (
woocommerce_store_api_register_endpoint_data,ExtendSchema) and block integrations (IntegrationInterface, slot-fills), not only classic template hooks - Security: verify payment webhooks (signature plus
hash_equals()), never trust client-sent prices or totals, check capabilities (manage_woocommerce,edit_shop_order), escape all order data on output - Dependency guard: do not run when WooCommerce is inactive; rely on
Requires Pluginsand checkclass_exists( 'WooCommerce' )for load-order safety
Where to Look
- Detailed APIs, snippets, hooks, Store API, gateways, REST, testing:
REFERENCE.md(this folder) - Auditable items for reviews and
/wordpress:check:checklist.md(this folder) - Core WordPress rules:
.claude/references/wordpress/rules/
Workflow
- Read
REFERENCE.mdsections matching the task (HPOS, CRUD, blocks, gateway, REST, tests) - Write the failing test first (
WP_UnitTestCasewith WooCommerce active inwp-env) - Implement through CRUD and hooks; declare feature compatibility
- Walk
checklist.mdbefore commit and report findings separately from the core WordPress score