wc-development

Develop WooCommerce extension plugins with HPOS-safe order APIs and Blocks integration.

3|2|Updated Jun 9, 2021
One-click install
npx skills add https://github.com/artisanworkshop/Japanized-for-WooCommerce --skill wc-development-artisanworkshop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wc-development
Source: https://github.com/artisanworkshop/Japanized-for-WooCommerce/tree/main/.claude/skills/wc-development
Command: npx skills add https://github.com/artisanworkshop/Japanized-for-WooCommerce --skill wc-development-artisanworkshop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you implement and debug WooCommerce extension functionality reliably, especially for HPOS order storage, payment gateways, shipping methods, Blocks/Store API checkout integration, REST API extensions, and WooCommerce-specific security requirements.

Core Features & Use Cases

  • HPOS-compatible order handling: Use WooCommerce order APIs for reading/writing meta, avoid legacy post/table queries, and declare custom_order_tables compatibility.
  • Payment gateway development: Implement WC_Payment_Gateway features including process_payment(), refunds, token-based PCI-safe flows, and admin settings wiring.
  • WooCommerce Blocks integration: Register payment methods for block checkout via PaymentMethodRegistry, wire Store API schema updates, and handle frontend-to-server data updates.
  • Order lifecycle & product data: Manage status transitions, add order notes, and add custom product/product-type fields and meta safely.
  • Shipping method development: Implement WC_Shipping_Method rates, shipping-zone support, and WC 10.6+ tax-inclusive shipping handling.
  • REST API extensions & security: Add REST endpoints/fields and apply sanitization/escaping/nonce/webhook verification patterns appropriate for WooCommerce.

Quick Start

Use the wc-development skill to analyze your plugin folder at /path/to/plugin and return the HPOS, Blocks, gateway, shipping, REST, and compatibility issues detected by the provided scan workflow.

Frequently Asked Questions about wc-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make my WooCommerce extension compatible with HPOS order storage?

To make a WooCommerce extension HPOS-compatible, declare custom_order_tables support and use order APIs like wc_get_orders() and $order->update_meta_data() instead of legacy post or table queries.

How do I add a custom payment gateway to WooCommerce checkout blocks?

You can integrate a custom payment gateway with WooCommerce checkout blocks by registering the payment method via the PaymentMethodRegistry and wiring Store API schema updates for frontend-to-server data handling.

What is the correct way to implement secure payment processing in WooCommerce?

Secure WooCommerce payment processing requires implementing WC_Payment_Gateway features like process_payment() and refunds, using token-based PCI-safe flows, and applying nonce and webhook verification for all transactions.

Does WooCommerce 9.0 support custom order statuses and HPOS-safe meta access?

Yes, WooCommerce 9.0 through 10.6+ supports HPOS-safe order meta access and custom order status lifecycles when you use standardized WooCommerce order APIs for reading and writing order data.

How do I implement tax-inclusive shipping methods in WooCommerce 10.6+?

Implement tax-inclusive shipping in WooCommerce 10.6+ by extending the WC_Shipping_Method class to define shipping rates and configure shipping-zone support according to the updated tax handling requirements.

Why should I avoid direct database queries when managing WooCommerce order data?

Direct database queries bypass WooCommerce's HPOS abstraction layer, causing data inconsistencies; using $order->update_meta_data() plus $order->save() ensures safe, compatible order meta handling across storage engines.