woocommerce/plugins/woocommerce-blocks/assets/js/blocks
Albert Juhé Lluveras a6178359bb Display Checkout block with a notice when adding a product sold individually that was already in the cart (https://github.com/woocommerce/woocommerce-blocks/pull/2854)
* Rename component to match directory

* Typo

* Checkout API: return cart errors as 'notice' property instead of throwing

* Checkout block: display server errors as notices

* Strip tags content

* Use same strings as in Core

* Add support for several notices

* Rename variables and allow all kind of notices

* Strip HTML tags and content in frontend

* Fix Checkout block in editor

* Add stripTagsAndContents tests

* Print notices before running blocks logic
2020-08-21 09:34:29 +02:00
..
active-filters Unify Chip styles (https://github.com/woocommerce/woocommerce-blocks/pull/2765) 2020-07-10 11:09:49 +02:00
attribute-filter Use named font sizes instead of values in px (https://github.com/woocommerce/woocommerce-blocks/pull/2533) 2020-05-29 12:16:33 +02:00
cart-checkout Display Checkout block with a notice when adding a product sold individually that was already in the cart (https://github.com/woocommerce/woocommerce-blocks/pull/2854) 2020-08-21 09:34:29 +02:00
featured-category Update placeholder styles (https://github.com/woocommerce/woocommerce-blocks/pull/2456) 2020-05-28 12:20:47 +02:00
featured-product Update placeholder styles (https://github.com/woocommerce/woocommerce-blocks/pull/2456) 2020-05-28 12:20:47 +02:00
handpicked-products Update placeholder styles (https://github.com/woocommerce/woocommerce-blocks/pull/2456) 2020-05-28 12:20:47 +02:00
price-filter Use named font sizes instead of values in px (https://github.com/woocommerce/woocommerce-blocks/pull/2533) 2020-05-29 12:16:33 +02:00
product-best-sellers Update wp.editor references, bump min version support (https://github.com/woocommerce/woocommerce-blocks/pull/2434) 2020-05-13 08:31:49 +12:00
product-categories Fix Product Categories List align attribute (https://github.com/woocommerce/woocommerce-blocks/pull/2700) 2020-06-16 13:18:04 +02:00
product-category Update placeholder styles (https://github.com/woocommerce/woocommerce-blocks/pull/2456) 2020-05-28 12:20:47 +02:00
product-new Update wp.editor references, bump min version support (https://github.com/woocommerce/woocommerce-blocks/pull/2434) 2020-05-13 08:31:49 +12:00
product-on-sale Update wp.editor references, bump min version support (https://github.com/woocommerce/woocommerce-blocks/pull/2434) 2020-05-13 08:31:49 +12:00
product-search use TextControl instead of PlainText (https://github.com/woocommerce/woocommerce-blocks/pull/3014) 2020-08-18 12:25:48 +01:00
product-tag Update placeholder styles (https://github.com/woocommerce/woocommerce-blocks/pull/2456) 2020-05-28 12:20:47 +02:00
product-top-rated Update wp.editor references, bump min version support (https://github.com/woocommerce/woocommerce-blocks/pull/2434) 2020-05-13 08:31:49 +12:00
products Fix All Products block 'No products' placeholder link (https://github.com/woocommerce/woocommerce-blocks/pull/2961) 2020-08-05 10:35:08 +02:00
products-by-attribute Update placeholder styles (https://github.com/woocommerce/woocommerce-blocks/pull/2456) 2020-05-28 12:20:47 +02:00
reviews Simplify reviews render method (https://github.com/woocommerce/woocommerce-blocks/pull/2952) 2020-08-04 10:29:02 +02:00
single-product Add to cart context provider (https://github.com/woocommerce/woocommerce-blocks/pull/2903) 2020-07-30 11:57:22 +01:00
README.md Update and add documentation in READMEs (https://github.com/woocommerce/woocommerce-blocks/pull/551) 2019-05-09 10:45:09 -04:00

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.

Saving

Usually blocks can be converted to HTML in the save function, so that what's saved into the database is the same HTML that's rendered on the frontend. Our blocks are different since they need to show the latest products and reflect any changes to products.

The grid blocks are saved as shortcodes using getShortcode, but the Featured Product block is considered a "dynamic block", so we use PHP to build that each time the post is loaded on the frontend. The code for that is set up when the block is registered in PHP, and lives in WGPB_Block_Featured_Product.