e8855a5af3
* templates README and block-template-controller README * Add execution scenario to block template controller readme * Amend return value to block template controller readme * Add source file link to block template controller docs * LegacyTemplate.php overview * Legacy Template JavaScript block README * Update requirements of templates feature * Doc updates based on feedback, and change Legacy Template references to Classic Template in anticipation of naming convention updates * Update classic-template.md README * Reword part of the add_block_templates section * Update assets/js/blocks/legacy-template/README.md Co-authored-by: Michael P. Pfeiffer <frontdevde@users.noreply.github.com> * Update docs/readme.md Co-authored-by: Michael P. Pfeiffer <frontdevde@users.noreply.github.com> * Update docs/templates/README.md Co-authored-by: Michael P. Pfeiffer <frontdevde@users.noreply.github.com> * Update docs/templates/README.md Co-authored-by: Michael P. Pfeiffer <frontdevde@users.noreply.github.com> * Update README for blocktemplatecontroller * Review feedback for Woo FSE technical documentation Co-authored-by: Michael P. Pfeiffer <frontdevde@users.noreply.github.com> |
||
---|---|---|
.. | ||
active-filters | ||
attribute-filter | ||
cart-checkout | ||
checkout | ||
featured-category | ||
featured-product | ||
handpicked-products | ||
legacy-template | ||
price-filter | ||
product-best-sellers | ||
product-categories | ||
product-category | ||
product-new | ||
product-on-sale | ||
product-search | ||
product-tag | ||
product-top-rated | ||
products | ||
products-by-attribute | ||
reviews | ||
single-product | ||
stock-filter | ||
README.md |
README.md
Blocks
Our blocks are generally made up of up to 4 files:
|- block.js
|- editor.scss
|- index.js
|- style.scss
The only required file is index.js
, this sets up the block using registerBlockType
. Each block has edit and save functions.
The scss files are split so that things in style
are added to the editor and frontend, while styles in editor
are only added to the editor. Most of our blocks should use core components that won't need CSS though.
Editing
A simple edit function can live in index.js
, but most blocks are a little more complicated, so the edit function instead returns a Block component, which lives in block.js
. By using a component, we can use React lifecycle methods to fetch data or save state.
The Newest Products block is a good example to read over, this is a simple block that fetches the products and renders them using the ProductPreview component.
We include settings in the sidebar, called the Inspector in gutenberg. See an example of this.
Other blocks have the concept of an "edit state", like when you need to pick a product in the Featured Product block, or pick a category in the Products by Category block.