woocommerce/plugins/woocommerce-blocks/docs

WooCommerce Blocks Handbook

Table of Contents

• Contributors
• Internal developers
• Third-party developers
• Designers
• Developer Resources
• Tutorials

The WooCommerce Blocks Handbook provides documentation for designers and developers on how to extend or contribute to blocks, and how internal developers should handle new releases.

Contributors

Want to contribute to the WooCommerce Blocks plugin? The following documents offer information that can help you get started.

• Contributing
  • Getting Started
  • Coding Guidelines
  • Block Script Assets
  • CSS Build System
  • JavaScript Build System
  • JavaScript Testing
  • Storybook & Components

Internal developers

Are you an internal developer? The following documents offer information about the different blocks, the Block Client APIs, the Store API, the templates and the testing process.

• Blocks
  • Stock Reservation during Checkout
  • Features Flags and Experimental interfaces
• Block Data
  • Collections Store
  • Query State Store
  • Schema Store
• Block Client APIs
  • Checkout API interface
  • Checkout Flow and Events
  • Notices
• Editor Components
  • SearchListControl
  • Tag
  • TextToolbarButton
• Icons
• Legacy Build
• Store API (REST API)
• Storybook
• Templates
  • BlockTemplateController.php
  • ClassicTemplate.php
  • Classic Template Block
• Testing
  • When to employ end to end testing
  • Smoke Testing
  • Cart and Checkout Testing
    • General Flow
    • Editor
    • Shipping
    • Payments
    • Items
    • Taxes
    • Coupons
    • Compatibility
  • Releases

Third-party developers

Are you a third-party developer? The following documents explain how to extend the WooCommerce Blocks plugin with your custom extension.

• Extensibility
  • Hooks
    • Actions
    • Filters
  • REST API
    • Exposing your data in the Store API
    • Available endpoints to extend with ExtendSchema
    • Adding an endpoint to ExtendSchema
    • Available Formatters
    • Updating the cart with the Store API
  • Checkout Payment Methods
    • Checkout Flow and Events
    • Payment Method Integration
    • Filtering Payment Methods
  • Checkout Block
    • IntegrationInterface
    • Available Filters
    • Slots and Fills
    • Available Slot Fills
    • DOM Events
    • Blocks Registry
    • Components
    • Filter Registry
    • Slot and Fill
    • Utilities

Designers

Are you a designer? The following documents explain how to apply design-changes to the WooCommerce Blocks plugin.

• Theming
  • All Products & filters
  • Cart and Checkout
  • Class names update in 4.6.0
  • Class names update in 3.4.0
  • Class names update in 3.3.0
  • Class names update in 2.8.0
  • Product grid blocks style update in 2.7.0

Developer Resources

The following posts from https://developer.woocommerce.com/category/developer-resources/, provide deeper insights into the WooCommerce Blocks development.

• Store API is now considered stable
• Available Extensibility Interfaces for The Cart and Checkout Blocks

Tutorials

The following tutorials from https://developer.woocommerce.com/category/tutorials/, help you extending the WooCommerce Blocks plugin.

• Hiding Shipping and Payment Options in the Cart and Checkout Blocks
• Integrating your Payment Method with Cart and Checkout Blocks

---

We're hiring! Come work with us!

🐞 Found a mistake, or have a suggestion? Leave feedback about this document here.