Release: 6.3.0

docs/testing/releases/630.md

@@ -0,0 +1,228 @@
+## Testing notes and ZIP for release 6.3.0
+
+Zip file for testing: [woocommerce-gutenberg-products-block.zip](https://github.com/woocommerce/woocommerce-gutenberg-products-block/files/7543045/woocommerce-gutenberg-products-block.zip)
+
+## Feature Plugin
+
+### Improve readability of terms and condition text by not displaying the text justified. ([5120](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5120))
+
+1. Create a test page, add the checkout block and save the page.
+2. Add a short custom text to the terms and conditions section.
+3. Verify that the terms and conditions text is left-aligned and contains even spacing between the words.
+
+### Introduce `cartItemClass` filter for cart items in Cart and Checkout blocks. ([4992](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4992))
+
+1. Install [the Simple Custom CSS and JS plugin](https://wordpress.org/plugins/custom-css-js/).
+2. Add the following custom JS code and load it in the frontend in the footer:
+
+```
+const { __experimentalRegisterCheckoutFilters } = window.wc.blocksCheckout;
+__experimentalRegisterCheckoutFilters( 'my-hypothetical-deposit-plugin', {
+    cartItemClass: () => 'my-class',
+} );
+```
+
+3. Create a test page, add the cart block to it and save it.
+4. Go to the frontend and add a product to the cart.
+5. Go to the cart page and ensure that cart item has the CSS class `my-class`.
+6. Go to the checkout page and ensure that the cart item has the CSS class `my-class`.
+
+Example of a cart item with the CSS class `my-class`:
+
+![](https://user-images.githubusercontent.com/3323310/141903888-ecdf5884-77bc-4709-a4ac-bebe5dd962f1.png)
+
+### Fix incorrect text domain. ([5020](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5020))
+
+1. Set the site language to Spanish.
+2. Download the translation files via Dashboard → Updates.
+3. Create a test page, add the checkout block and save the page.
+4. Verify that all texts of the checkout block are available in Spanish in the editor.
+
+⚠️ Please note that some strings are not translated in the frontend. This problem will be addressed with ([5112](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5112)).
+
+### Fix ‘Country is required’ error on the Cart block when updating shipping address ([5129](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5129))
+
+1. Add a product to the cart and go to the cart page.
+2. Provide a shipping address in the shipping calculator and click the `Update` button.
+3. Provide a shipping address from a different country and click the `Update` button again.
+4. Verify that the new shipping address is visible.
+5. Verify that the error `Country is required` is not visible.
+6. Go to the checkout page and verify that the new shipping address is visible.
+7. Finalize the order and verify that the new shipping address is visible on the order details.
+
+### Fix button style of Mini Cart block for small screens. ([4907](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4907))
+
+1. Create a test page, add the columns block and save the page.
+2. Add the mini cart block to one of the columns.
+3. Verify that the mini card block contains the total, the number of items and the cart icon on a large screen (>= 768px).
+4. Verify that the mini card block only contains the number of items and the cart icon on a small screen (< 768px).
+
+Large screen:
+
+![](https://user-images.githubusercontent.com/3323310/141926396-82eb319f-502f-4c3b-9aba-c9a3be9fe4e3.png)
+
+Small screen:
+
+![](https://user-images.githubusercontent.com/3323310/141926415-dbcf8133-ea26-4e08-a806-aee7923f83d2.png)
+
+### Make order note block removable ([5139](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5139))
+
+1. Create a test page, add the Checkout block and save the page.
+2. Remove the order note block and verify that it will not be added again.
+3. Go to the frontend and verify that the order note block is not visible.
+
+### Deprecate the \_\_experimental_woocommerce_blocks_checkout_order_processed action in favor of woocommerce_blocks_checkout_order_processed. ([5014](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5014))
+
+1. Install [the Code Snippets plugin](https://wordpress.org/plugins/code-snippets/).
+2. Add the following PHP snippet:
+
+```
+add_action( '__experimental_woocommerce_blocks_checkout_order_processed', function( $order ) { return; }, 10, 1 );
+
+// For testing purposes, update the order date using the new hook.
+add_action( 'woocommerce_blocks_checkout_order_processed', function( $order ) {
+    $order->set_date_created( '2000-05-08' );
+    $order->save();
+} );
+```
+
+3. Install [the WP Debugging plugin](https://wordpress.org/plugins/wp-debugging/).
+4. Add a product to your cart and check out using the Checkout block. Ensure it goes through correctly.
+5. Check the `debug.log` file and ensure there’s a deprecation message logged for `__experimental_woocommerce_blocks_checkout_order_processed`.
+6. Ensure the order creation date is May 8th, 2000.
+
+ℹ️ https://tastewp.com/ allows spinning up a free WordPress test site and downloading the `debug.log` file via the dashboard.
+
+⚠️ Please note that testing this case requires the [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) extension.
+
+### Deprecate the \_\_experimental_woocommerce_blocks_checkout_update_order_from_request action in favor of woocommerce_blocks_checkout_update_order_from_request. ([5015](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5015))
+
+1. Install [the Code Snippets plugin](https://wordpress.org/plugins/code-snippets/).
+2. Add the following PHP snippet:
+
+```
+add_action( '__experimental_woocommerce_blocks_checkout_update_order_from_request', function( $order, $request ) { return; }, 10, 2 );
+
+add_action( 'woocommerce_blocks_checkout_update_order_from_request', function( $order, $request ) {
+    // For testing purposes, set the customer note to the user-agent from the request.
+    $order->set_customer_note( $request->get_header('User-agent') );
+    $order->save();
+}, 10, 2 );
+```
+
+3. Install [the WP Debugging plugin](https://wordpress.org/plugins/wp-debugging/).
+4. Add a product to your cart and check out using the Checkout block. Ensure it goes through correctly.
+5. Check the `debug.log` file and ensure there’s a deprecation message logged for `__experimental_woocommerce_blocks_checkout_update_order_from_request`.
+6. Ensure the order contains a customer note that is your browser's user agent.
+
+ℹ️ https://tastewp.com/ allows spinning up a free WordPress test site and downloading the `debug.log` file via the dashboard.
+
+### Deprecate the \_\_experimental_woocommerce_blocks_checkout_update_order_meta action in favor of woocommerce_blocks_checkout_update_order_meta. ([5017](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5017))
+
+1. Install [the Code Snippets plugin](https://wordpress.org/plugins/code-snippets/).
+2. Add the following PHP snippet:
+
+```
+add_action( '__experimental_woocommerce_blocks_checkout_update_order_meta', function( $order ) { return; }, 10, 1 );
+
+// For testing purposes, update the order date using the new hook.
+add_action( 'woocommerce_blocks_checkout_update_order_meta', function( $order ) {
+    $order->set_date_created( '2000-05-08' );
+    $order->save();
+} );
+```
+
+3. Install [the WP Debugging plugin](https://wordpress.org/plugins/wp-debugging/).
+4. Add a product to your cart and check out using the Checkout block. Ensure it goes through correctly.
+5. Check the `debug.log` file and ensure there’s a deprecation message logged for `__experimental_woocommerce_blocks_checkout_update_order_meta`.
+6. Ensure the order creation date is May 8th, 2000.
+
+ℹ️ https://tastewp.com/ allows spinning up a free WordPress test site and downloading the `debug.log` file via the dashboard.
+
+⚠️ Please note that testing this case requires the [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) extension.
+
+## Feature plugin and package inclusion in WooCommerce
+
+### FSE: Add basic taxonomy block templates. ([5063](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5063))
+
+1. Install and activate [the Gutenberg plugin](https://wordpress.org/plugins/gutenberg/) (not the latest built version of `trunk` from the repo).
+2. Install and activate a FSE enabled theme, such as [the Tove theme](https://wordpress.org/themes/tove/).
+3. Load the Site Editor (Appearance → Editor) and select the `Product Category Page` template from the `General templates` section.
+4. Confirm you can load the template, and it looks as expected in large/small viewports.
+5. Confirm the behavior on the frontend on a category page, e.g. `/product-category/clothing/` is identical to the behavior the same page without this PR applied.
+6. Repeat steps 3-5 for the `Product Tag Page` template (e.g. `/product-tag/merch/`).
+
+### FSE: Add single product block template. ([5054](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5054))
+
+1. Install and activate [the Gutenberg plugin](https://wordpress.org/plugins/gutenberg/) (not the latest built version of `trunk` from the repo).
+2. Install and activate a FSE enabled theme, such as [the Tove theme](https://wordpress.org/themes/tove/).
+3. Load the Site Editor (Appearance → Editor) and select the `Single Product Page` template from the `General templates` section.
+4. Confirm you can load the template. It will have a temporary placeholder block. This SVG will be replaced in a future PR.
+5. Confirm the behavior on the frontend product page is identical to the behavior on the product page without this PR applied.
+
+### FSE: Add basic product archive block template. ([5049](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5049))
+
+1. Install and activate [the Gutenberg plugin](https://wordpress.org/plugins/gutenberg/) (not the latest built version of `trunk` from the repo).
+2. Install and activate a FSE enabled theme, such as [the Tove theme](https://wordpress.org/themes/tove/).
+3. Load the Site Editor (Appearance → Editor) and select the `Product Archive Page` template from the `General templates` section.
+4. Confirm you can load the template, and it looks as expected in large/small viewports as per the screenshots above.
+5. Confirm the behavior on the Frontend on `/shop` is identical to the behavior on `/shop` without this PR applied.
+
+### Add placeholder text when modifying product search input in the editor. ([5122](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5122))
+
+1. Add the Product Search block to any page in the editor.
+2. Delete the “Search Products…” value from the Search input.
+3. “Enter search placeholder text” should be displayed in the input as a placeholder.
+4. The text should disappear as you start typing.
+
+### Improve the product images placeholder display by adding a light gray border to it. ([4950](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4950))
+
+1. Create a product with no product image.
+2. Create a test page and add the Newest Products block.
+3. Verify that the placeholder image has a visible border.
+
+### Improve accessibility by using self-explaining edit button titles. ([5113](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5113))
+
+1. Create a test page and add the following blocks to it:
+    - Featured Category block
+    - Featured Product block
+    - Hand-picked Products block
+    - Products by Category block
+    - Products by Attribute block
+    - Reviews by Product block
+    - Reviews by Category block
+    - Products by Tag block
+    - All products block
+    - Single Product block
+2. Click on the `edit` button of each block and verify that the button text corresponds to the value of the following list:
+    - Featured Category: Edit selected category
+    - Featured Product: Edit selected product
+    - Hand-picked Products: Edit selected products
+    - Products by Category: Edit selected categories
+    - Products by Attribute: Edit selected attributes
+    - Reviews by Product: Edit selected product
+    - Reviews by Category: Edit selected categories
+    - Products by Tag: Edit selected tags
+    - All products: Rearrange inner blocks
+    - Single Product: Edit selected product
+
+Example of button text for the Hand-picked Products block:
+
+![](https://user-images.githubusercontent.com/3323310/141891543-5ef2d0d5-fba7-407a-a731-daee53b9a70d.png)
+
+### Fix label alignment of the product search in the editor. ([5072](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5072))
+
+1. Create a test page, add the Product Search block and save the page.
+2. Verify if the search label is vertically aligned with the search input field and that the block looks equal in the editor and on the frontend.
+
+### Fix duplicate queries in product grids #4695. ([5002](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5002))
+
+1. Add multiple product grid blocks to a page, e.g. `Products by Category` and `Products by Category`.
+2. Ensure there are some variable products visible.
+3. Check the product grid blocks render correctly on the frontend.
+
+### Fix sale badge alignment on smaller screen. ([5061](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5061))
+
+1. Create a test page, add the All Products block and save the page.
+2. Simulate a screen that has a width between 480px and 600px.
+3. Verify that the sale badge is aligned on the right.

docs/testing/releases/README.md

@@ -47,4 +47,4 @@ Every release includes specific testing instructions for new features and bug fi
 -   [6.0.0](./600.md)
 -   [6.1.0](./610.md)
 -   [6.2.0](./620.md)
-
+-   [6.3.0](./630.md)

readme.txt

@@ -85,6 +85,40 @@ Release and roadmap notes available on the [WooCommerce Developers Blog](https:/
 
 == Changelog ==
 
+= 6.3.0 - 2021-11-16 =
+
+#### Enhancements
+
+- Add placeholder text when modifying product search input in the editor. ([5122](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5122))
+- Improve readability of terms and condition text by not displaying the text justified. ([5120](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5120))
+- Improve accessibility by using selfexplaining edit button titles. ([5113](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5113))
+- Improve rendering performance for Single Product block. ([5107](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5107))
+- FSE: Remove the `do_action( 'woocommerce_sidebar' );` action from the `LegacyTemplate.php` block. ([5097](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5097))
+- FSE: Add basic taxonomy block templates. ([5063](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5063))
+- FSE: Add single product block template. ([5054](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5054))
+- FSE: Add basic product archive block template. ([5049](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5049))
+- Fix duplicate queries in product grids #4695. ([5002](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5002))
+- Introduce `cartItemClass` filter for cart items in Cart and Checkout blocks. ([4992](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4992))
+- FSE: Add abstract block legacy template for core PHP templates. ([4991](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4991))
+- FSE: Add render logic to BlockTemplateController. ([4984](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4984))
+- Improve the product images placeholder display by adding a light gray border to it. ([4950](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4950))
+- Deprecate the __experimental_woocommerce_blocks_checkout_update_order_meta action in favour of woocommerce_blocks_checkout_update_order_meta. ([5017](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5017))
+- Deprecate the __experimental_woocommerce_blocks_checkout_update_order_from_request action in favour of woocommerce_blocks_checkout_update_order_from_request. ([5015](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5015))
+- Deprecate the __experimental_woocommerce_blocks_checkout_order_processed action in favour of woocommerce_blocks_checkout_order_processed. ([5014](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5014))
+
+#### Bug Fixes
+
+- Fixed an issue that was causing an error when updating the address in the Cart block's shipping calculator. ([5115](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5115))
+- Fix label alignment of the product search in the editor. ([5072](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5072))
+- FSE: Fix missing `is_custom` property for WooCommerce block template objects. ([5067](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5067))
+- Fix sale badge alignment on smaller screen. ([5061](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5061))
+- Scripts using `wc-settings` or script that depend on it would be enqueued in the footer if they're enqueued in the header. ([5059](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5059))
+- Replace incorrect with correct text domain. ([5020](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5020))
+- Fix button style of Mini Cart block for small screens. ([4907](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/4907))
+- Make order note block removable ([5139](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5139))
+- Fix state validation to compare state codes, and only validate if a country is given ([5132](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5132))
+- Fix 'Country is required' error on the Cart block when updating shipping address ([5129](https://github.com/woocommerce/woocommerce-gutenberg-products-block/pull/5129))
+
 = 6.2.0 - 2021-10-26 =
 
 #### Enhancements