Release Testing Instructions WooCommerce 6.3

WooCommerce 6.3 includes:

• WooCommerce Admin Updates
• WooCommerce Blocks Updates
• WooCommerce Core Updates

---

WooCommerce Admin Updates:

Make $customer_id public again #8371

1. Download and install WooCommerce Square plugin
2. Go to Plugins > WooCommerce Square > Configure
3. Enable sandbox mode and setup sandbox account with Square
4. Go to WooCommerce > Settings > Payments and enable Square payments
5. Create a test product
6. Attempt to purchase the product via customer facing UI using WooCommerce Square payments. You can use the test credit cards here
7. Make sure purchase is successful

WooCommerce Payments task in new task list experiment #8321

1. On a new WooCommerce site finish the onboarding flow and make sure to select WooCommerce Payments under the free features in the Business Details step.
2. Enable the woocommerce_tasklist_progression_headercard_2col_2022_03 treatment by opening your browser console and running localStorage.setItem('explat-experiment--woocommerce_tasklist_progression_headercard_2022_03', '{"experimentName":"woocommerce_tasklist_progression_headercard_2022_03","variationName":"treatment","retrievedTimestamp":' + Date.now() + ',"ttl":7200}');.
3. Go to WooCommerce > Home or refresh this page, a new task list should be displayed (example pic)
4. Store Details task should not be present and the Get paid with WooCommerce Payments task should be displayed in the new task list with a Set up additional payment providers in the Things to do next task list.
5. Make sure you have WooCommerce Payments dev mode enabled (you can install the WooCommerce Payments dev tools plugin for this)
6. Click on the Get paid with WooCommerce Payments and set up/connect WooCommerce Payments
7. Once finished and redirected back to WooCommerce > Home the Get paid with WooCommerce Payments should not be present anymore in the new task list. Instead an uncompleted Set up payments should be listed.
8. The Things to do next task list should not include the Set up additional payment providers task anymore.

Fix category report query returns invalid net sales

1. Create a new store and finish the Onboarding flow
2. Go to Products > Add New and create a product called Hoodie with Pocket with the price $35
3. Create a new category called Hoodie with Clothing as the parent category in the Product categories on the right.
4. Select Clothing and Hoodie with Pocket as well and click Update
5. Create an order with a single item of Hoodie with Pocket (keep note of the total price)
6. Run the action scheduler (make sure all are run), you can do this manually by going to WooCommerce > Status > Scheduled Actions. If your queue is large, just make sure that the wc-admin_import_orders actions are run.
7. Go to Analytics > Overview and scroll down to the Leaderboards
8. Observe that the Clothing category has only 1 items sold and net sales is $35
9. Click on Clothing it will redirect to the Categories page and show the correct numbers
10. Now click on Analytics > Categories again and scroll down to the table
11. Observe that the Clothing category has only 1 items sold and net sales is $35

Hide store address fields in regions that specify hidden #8172

1. Go to the store setup wizard
2. Change to a country like Guatemala that hides the post code
3. Verify that the post code is hidden and "Continue" still works as expected
4. Switch to a different country with all fields shown and make sure things still work as expected

Add localized validation to store address #8123

Store details

1. Navigate to the Store Details step of the profiler
2. Change the country/region to US.
3. Check that all fields are still required
4. Change your country to Australia
5. Make sure post code and city labels are updated (you can check this list here for other country requirements by shortcode)
6. Change the country to Hong Kong
7. Check that zip/postal is no longer required

Tasks

1. Delete any shipping zones you might have
2. Clear your address in WooCommerce > Settings aside from the country/region.
3. Visit the Shipping task in the task list
4. It should prompt you to put in the store address.
5. This should follow the same store address validation as the Store Details step.

Enhance report chart i18n support #8129

1. Go to Analytics > Overview
2. Observe chart texts show normally in English/site language.
3. Select different "stats" by click on the 3 dots on the right hand and enabling other stats, now repeat step 2 until all options are confirmed.
4. Go to Settings > General
5. Change the "Site Language" to another languages like "Português do Brasil"
6. Repeat 1 ~ 3 steps

Add MailPoet to Installed marketing extensions #8091

1. Go to Marketing > Overview
2. MailPoet is not shown in Installed marketing extensions
3. Go to Plugins and install but don't activate MailPoet 3
4. Go to Marketing > Overview
5. See MailPoet in Installed marketing extensions
6. Click Activate
7. Click Finish Setup
8. Finish MailPoet setup (fill with dummy data)
9. Go to Marketing > Overview
10. See MailPoet links to Docs, Support, and Settings

Add additional store profiler track for the business details tab. #8265

1. Open your console and make sure you have tracks outputted ( localStorage.setItem( 'debug', 'wc-admin:*' ); )
2. Go to the Onboarding wizard and step through until the business details /wp-admin/admin.php?page=wc-admin&path=%2Fsetup-wizard&step=business-details
3. A storeprofiler_step_view should be triggered with business-details as the step.
4. Fill out the dropdowns and click continue
5. A storeprofiler_step_complete should of fired with a step prop of business-details. A new storeprofiler_step_view should of also fired with business-features as a step. Now select some free features and click continue.
6. A storeprofiler_step_complete should of fired with a step prop of business-features.
7. Check the general styling of the business features tab to make sure things look good still.

---

WooCommerce Blocks Updates:

FSE: Add support for the global style for the Price Filter block. (5559)

1. Upgrade to WordPress 5.9.
2. Install and enable the Twenty Twenty-Two theme.
3. Add the Price Filter block to a post.
4. On the right sidebar, personalize the styles of the block.
5. Go on the page and check if there are changes.
6. Reset to default using the Reset button from the different sections.
7. Go to Dashboard and select Appearance > Editor (beta). On top of the screen, select Home > Browser all templates > Single Post. When the page is loaded, add the block to the page.
8. On the Editor page click on the Styles icon on the right-top corner.
9. Verify that the Price Filter block is shown under the Blocks section. Personalize the block.
10. Save your changes.
11. Go on the page created earlier and check if all styles are applied correctly.
12. Edit your previous post/page again.
13. Change again the styles.
14. Save your changes.
15. Check if these styles have priority over the styles from the Site Editor.

FSE: Update the block theme folders to latest Gutenberg convention (i.e. templates and parts). (5464)

1. Activate the Gutenberg plugin (or use WordPress 5.9). Select a block theme e.g. TT1 Blocks.
2. Open Appearance > Editor > Templates.
3. Make sure all the templates and parts appear correctly. WooCommerce templates that should be available: Archive Product, Single Product, Product Category and Product Tag. WooCommerce template-parts that should be available Mini Cart.

FSE: Add support for the wide and full alignment for the legacy template block. (5433)

1. Activate the Gutenberg plugin (or use WordPress 5.9). Select a block theme e.g. TT1 Blocks.
2. From the dashboard, click on Theme > Site Editor.
3. Check Site Editor > Templates.
4. Edit a legacy template (for example Product Category Page).
5. Check if you can change the alignment.
6. Change it.
7. Check if the changes are also reflected on the frontend side.

You should test these steps at least one between Product Category Page, Product Archive Page and Product Tag Page. You should test Single Product Page.

Added controls to product grid blocks for filtering by stock levels. (4943)

1. Create a new post.
2. Add a new product grid block (namely, Products by Attribute, Products by Tag, Top Rated Products, Products by Attribute, On Sale Products or Newest Products).
3. In the right hand edit column, open the 'Stock level' panel.
4. Change the drop down menu setting and observe the product list changing to match the new filter.
5. Repeat with any variations and combinations of settings.

All Products block displays thumbnails. (5551)

1. With a previous version of Woo Blocks and create a new post and add All Product block and save it. Enable the version of this release (6.8.0).
2. Add a product with a portrait image (example you can use), and one with a landscape image (example you can use).
3. Edit the existing page with the All Products block. Edit the block, select the image. In the sidebar, under "Block" tab, the "Image Sizing" setting should be "Full Size". This confirms existing blocks are not affected.
4. Visit the page with this block on the front end. Sort by "latest" so that the two new products you added are visible. Notice the aspect ratios of these are different and cause the other items out of alignment.
5. Add the All Products block to a new page and save it.
6. Edit the All products block, click on pencil to edit and select the image. In the sidebar, under "Block" tab, the "Image Sizing" setting should have "Cropped" selected.
7. Visit this page on the front end and sort by "latest" so that the two new products you added are visible.
8. All product images should be the same aspect ratio and align within the grid.
9. Go to Appearance > Customize > WooCommerce > Product Images and set a custom aspect ratio (for example, 16:9).
10. Visit the all products page again. All product images should be rendered with this new aspect ratio.

Filter Products By Price block: Don't allow to insert negative values on inputs. (5123)

1. Create a post and add All Products block and add Filter Products by Price block.
2. Save the post.
3. Go to the page having all the above block added.

Check that:

• the user can't insert in both inputs a negative number.
• the user can't insert on input left a number that is greater than input on the right.
• if the user inserts on the input on the right a number that is lower than input on the left, the component sets to 0 the minimum price.

FSE: Revert "Allow LegacyTemplate block to be reinserted, only on WooCommerce block templates.". (5643)

1. Load Appearance > Site Editor and select one of the WooCommerce templates. Confirm it loads the correct Legacy Template block in the Editor for the given block template.
2. Remove this block, you should not be able to reinsert it and do not save (this is expected as part of this revert)
3. Refresh the page and confirm the correct Legacy Template block still gets rendered in the Site Editor
4. Customise this template, and save it. Now reload this template and ensure it loads the customised template in the 5. Site Editor and on the frontend.
5. Try clearing the customisations on Site Editor > Templates screen, ensure these are reset in the Site Editor and on the frontend.

FSE: Add support for the global style for the Featured Category block. (5542)

1. On WordPress 5.9, install and enable the Gutenberg plugin.
2. Install and enable the Twenty Twenty-Two theme.
3. Add the Featured Category Block to a post.
4. On the right sidebar, personalize the styles of the block.
5. Go on the page and check if there are changes.
6. Reset to default using the Reset button from the different sections.
7. Go to Dashboard and select Appearance > Editor (beta). On top of the screen, select Home > Browser all templates > Single Post. When the page is loaded, add the block to the page.
8. On the Editor page click on the Styles icon on the right-top corner.
9. Verify that the Featured Category block is shown under the Blocks section. Personalize again the block.
10. Save your changes.
11. Go on the page created earlier and check if all styles are applied correctly.
12. Edit your previous post/page again.
13. Change again the styles.
14. Save your changes.
15. Check if these styles have priority over the styles from the Site Editor.

FSE: Enable Mini Cart template-parts only for experimental builds. (5606)

1. Using Wordpress 5.9, select a block theme e.g. TT1 Blocks.
2. Open Appearance > Editor > Templates Parts.
3. Check that Mini Cart template is NOT visible.

---

WooCommerce Core Updates:

Create and fill the product attributes lookup table during a clean install of WooCommerce 31911

1. Perform a clean new install of WooCommerce 6.3 on a new WordPress instance.
2. Verify that the tools page shows a "Regenerate the product attributes lookup table" entry.
3. Verify that Settings - Products has an "Advanced" section that allows controlling the feature.
4. Verify that the "Use the product attributes lookup table for catalog filtering" option in the above settings section is checked.

Create and activate product attributes lookup table in data migration 31256

1. Start with a site running WooCommerce 6.2.0 or older.
2. Upgrade the site to 6.3.0
3. Go to your WooCommerce admin area, you'll see a "Database update required" banner, click the "Update database" button. Wait until the database update finishes.
4. Go to WooCommerce - Settings - Products - Advanced. Confirm the "Use the product attributes lookup table for filtering" option is ticked
5. Setup some additional products, use this csv file https://raw.githubusercontent.com/woocommerce/woocommerce/dbac025535e29f5f67bdd96ba256ca4531662b4e/DATA_FOR_POC/FilterByAttributeUsingLookup_Products.csv
6. Trash a variable product
7. Create/delete/modify products and variations as follows and verify that everything continues working.

• A new product is created
• A new variation is added to a product
• A product or variation that had been trashed previously is untrashed
• The product visibility changes to "search" or "hidden"
• The attributes for a product change, this includes:
  • New attributes are added or deleted for a product
  • Terms are added or removed from the attribute definition for a product
  • The attribute changes between "used for variations" and not
  • The attributes for a variation change

Use inline onload event instead of jQuery load #31623

1. Install Test jQuery Updates plugin
2. Ensure you have a product with multiple product images
3. View the product on the front-end to ensure the images appear as expected Using your browser's developer tools, block the request for jQuery migrate and refresh
4. In Test jQuery Updates plugin disable jQuery Migrate (see #31636 for an example)
5. See that the images are no longer displayed