Skip to content

Release Testing Instructions WooCommerce 6.6

Tam Mullen edited this page Jun 8, 2022 · 30 revisions

WooCommerce 6.6 includes:


WooCommerce Blocks Updates #32940

Workflow: WooCommerce Product Blocks

Blocks 7.5.0

Add PHP templates support to the Active Product Filters block. (6295)

  1. With a block theme (such as Twenty Twenty Two), go to Edit Site > Product Catalog.
  2. Add Active Product Filters, Filter Products by Stock, Filter Products by Attribute, Filter Products by Price blocks to the template.
  3. Go to the shop page on the front end.
  4. Select some filters, see the page reload and the selected filters appear in the Active Products Filters block.
  5. Remove an arbitrary filter, see the page reload and the removed filter doesn't appear in the Active Product Filters block. See the filtered product results updates accordingly.

Enhanced the Featured Category block (6276):

  1. Use a block theme (such as Twenty Twenty Two)
  2. Add the ”Featured Category” block to a page and select a product.
  3. Make sure that the resizable handle is a shown fully (it should be a full circle), and that is shown only when the block is selected.
  4. Select the block and apply a Duotone filter.
  5. Make sure the overlay color control is under the Overlay section and change the overlay color to a gradient.
  6. Add a padding to the block and make sure the padding is added on the inside of the wrapper (i.e. no white space is created outside of the block).
  7. Move around your image focal point and make sure you can actually move around the entire image and not only constrained on one dimension.
  8. Apply “Image fit > Cover” and notice how the image will scale along with the container. As opposed to point 5 above, now the focal point picker is limited to one dimension.
  9. Increase the padding-top of the block and notice that the content can't get pushed out of the container, but instead the container resizes.
  10. When that's the case, try resizing the block through the handle to a lower height: the handle should move but the container should not resize. When the mouse is lifted, the handle should return to its original position.
  11. For the steps 4–9 above, save the page and check that the styles are applied correctly on the front-end (as the block is rendered statically via PHP).

Allow adding the Filter Products by Stock block to Product Catalog templates to filter products. (6261)

  1. With a block theme (such as Twenty Twenty Two), go to Appearance > Editor > Template > Product Catalog.
  2. Add the Filter Products by Stock block above the product grid.
  3. Be sure that you have some out stock products. Check "out of stock" on the frontend.
  4. Notice the page reloads and the list of products updates accordingly.
  5. Add a test page to your site with the All Products block, and the Filter Product by Stock block and ensure no regressions have been introduced here.

Enhanced the Featured Product block (6181):

  1. Use a block theme (such as Twenty Twenty Two)
  2. Add the ”Featured Product” block to a page and select a product.
  3. Make sure that the resizable handle is a shown fully (it should be a full circle), and that is shown only when the block is selected.
  4. Select the block and apply a Duotone filter.
  5. Make sure the overlay color control is under the Overlay section and change the overlay color to a gradient.
  6. Add a padding to the block and make sure the padding is added on the inside of the wrapper (i.e. no white space is created outside of the block).
  7. Move around your image focal point and make sure you can actually move around the entire image and not only constrained on one dimension.
  8. Apply “Image fit > Cover” and notice how the image will scale along with the container. As opposed to point 5 above, now the focal point picker is limited to one dimension.
  9. Increase the padding-top of the block and notice that the content can't get pushed out of the container, but instead the container resizes.
  10. When that's the case, try resizing the block through the handle to a lower height: the handle should move but the container should not resize. When the mouse is lifted, the handle should return to its original position.
  11. For the steps 4–9 above, save the page and check that the styles are applied correctly on the front-end (as the block is rendered statically via PHP).

Store API: Allow Store API to filter products by custom taxonomies. (6152)

  1. Add an All Products Block to a page, add the Filter Products by Attribute Block, and Filter by Price Block too.
  2. Go to the page and use the filters, ensure they update the All Products Block correctly.

Filter Products by Attribute: Fix the page reload which happens when clicking the filter button on Woo templates using the Classic Template block. (6287)

  1. On a block theme, go to Edit Site > Product Catalog template.
  2. Add Active Filters and Filter Products by Attribute block to the template.
  3. Choose an attribute to filter, and make sure the filter button is toggled.
  4. Go to the shop page.
  5. Select an attribute, a reload should not happen until you click the filter button.
  6. Once the filter has been applied. Uncheck it, a reload should not happen until you click the filter button.
  7. Try this again with the filter button untoggled, although these reloads should now happen as soon as you check the attribute you're filtering by
  8. Check there are no regressions on All Products block.

Add RTL support for the Mini Cart icon. (6264)

  1. Add Mini Cart to the site (Header for block themes, Sidebar for classic theme).
  2. Set the language to an RTL language (ie: Arabic).
  3. See the Mini Cart looks good on the front end.

Fix page load problem due to incorrect URL to certain assets. (6260)

  1. Go to an atomic website.
  2. Install WC Subscriptions. Try to open wp-admin > WooCommerce > Home (/wp-admin/admin.php?page=wc-admin).
  3. Page should load normally.

Make Filters Products by Price work with Active Filters block for the PHP rendered Classic Template. (6245)

  1. Add the Filter Products by Price block & Active Filters block to the Shop Page
  2. Open the Shop page
  3. Use the Filter Products by Price block, the page should reload with the filter params now being in the URL too.
  4. Check the Active Filters block shows the active price filter.

Fix attribute filter dropdown list z-index level. (6294)

  1. Create new page with Filter Products by Attribute and All Products block right under
  2. Configure Filter block to use Dropdown display style and show Colour attribute (if using sample products)
  3. Have products on sale in first row
  4. Visit page and focus on field to see dropdown
  • All Products block Placeholder elements should be under the dropdown
  • Sale badge shouldn't bleed through the dropdown

Fix Featured Product block frontend mismatch. (6263)

  1. Switch to a block-enabled theme (such as Twenty-twentytwo).
  2. Add the Featured Product block to a page.
  3. Confirm that it has a default, semi-transparent, black overlay and that a default height of 500 px or whatever the theme supports through the featured_block::default_height setting.
  4. Publish the page.
  5. Preview the page and confirm that the block looks like the one in the editor (specifically for height and overlay).
  6. Play around with the styles of the block on the editor (change the overlay color, the padding, the opacity, the image fit etc.).
  7. Confirm they get correctly applied on the frontend.

Fix Customizer fatal error on PHP 8. (6317)

  1. Use a PHP 8 site with Storefront theme
  2. Go to Appearance > Customize.
  3. See no fatal error, the Customizer is loading and working as expected.

Fix page refresh when using filters with the All Products block on non-product archive templates for WooCommerce. (6324)

  1. Activate Storefront
  2. Add the All Products block to a newly created page, along with a filter block such as Filter by Attribute
  3. Visit this page on the frontend and select some attributes to filter by.
  4. Observe the filters being applied without a page refresh.

Blocks 7.6.0

Featured Category: Add background color option. (6368)

Prerequisites:

  1. Create a new post/page.
  2. In the editor, add two Featured Category blocks.
  3. For each block select the same category, it should have a product picture.
  4. Select each block and use the Replace button in the block toolbar to add a product image smaller than the Featured Category block (for an example see screenshots above).
  5. Now select the first Featured Category block. In the editor sidebar's Color section of the block select a Background color. The background color should be visible in the parts not covered by the product image.
  6. Save your post/page.
  7. In the admin dashboard navigate to Appearance > Editor (/wp-admin/site-editor.php).
  8. Open the Styles sidebar by clicking the round Styles icon in the top right of the editor.
  9. In the Styles sidebar navigate to Blocks > Featured Category > Colors > Background.
  10. Change the background color and save your changes.
  11. Navigate back to the post/page you previously created.
  12. The first block should still show the background color you selected in step 5. The second block should show the Global Styles color you selected in step 10.
  13. Click Preview > Preview in new tab and confirm the colors appear as expected on the Frontend of your site as well.

Featured Product: Add background color option. (6367)

Prerequisites:

  1. Create a new post/page.
  2. In the editor, add two Featured Product blocks.
  3. For each block select the same product, it should have a product picture.
  4. Select each block and use the Crop tool in the block toolbar to crop the product image smaller than the Featured product block e.g. by setting the aspect ratio to 2:3.
  5. Now select the first Featured Product block. In the editor sidebar's Color section of the block select a Background color. The background color should be visible in the parts not covered by the product image.
  6. Save your post/page.
  7. In the admin dashboard navigate to Appearance > Editor (/wp-admin/site-editor.php).
  8. Open the Styles sidebar by clicking the round Styles icon in the top right of the editor.
  9. In the Styles sidebar navigate to Blocks > Featured Product > Colors > Background.
  10. Change the background color and save your changes.
  11. Navigate back to the post/page you previously created.
  12. The first block should still show the background color you selected in step 5. The second block should show the Global Styles color you selected in step 10.
  13. Click Preview > Preview in new tab and confirm the colors appear as expected on the Frontend of your site as well.

Added media controls allowing the user to edit images within the editor on a Featured Category block. (6360)

  1. Add the Featured Category block
  2. Choose either a category with an associated image or select an image for the block through the toolbar
  3. Click on the “Crop” icon on the toolbar
  4. Ensure the toolbar controls are now changed and show: Zoom, Aspect ratio, Rotate | Apply, Cancel controls
  5. Ensure only the image is now visible instead of the whole block inside the image editor
  6. Try executing edits and applying them
  7. Ensure the image turns semi-transparent and a loading spinner shows in the image
  8. Ensure the block now shows your edited image
  9. Click on the “Crop” icon again
  10. Click away from the block
  11. Ensure the block exits “Edit mode”

Added media controls allowing the user to edit images within the editor on a Featured Product block. (6348)

  1. Add the Featured Product block
  2. Choose a product with an image or select an image for the block through the toolbar
  3. Click on the “Crop” icon on the toolbar
  4. Ensure the toolbar controls are now changed and show: Zoom, Aspect ratio, Rotate | Apply, Cancel controls
  5. Ensure only the image is now visible instead of the whole block inside the image editor
  6. Try executing edits and applying them
  7. Ensure the image turns semi-transparent and a loading spinner shows in the image
  8. Ensure the block now shows your edited image
  9. Click on the “Crop” icon again
  10. Click away from the block
  11. Ensure the block exits “Edit mode”

Add the alt text control to the Featured Category block media settings. (6341)

  1. Create a new page and add a Featured Category.
  2. On the block settings go to Media Settings and check the Alt text textarea appears empty.
  3. Add an alt text, save the block and check it renders on the frontend with the specified alt text.
  4. Edit the block again, remove the alt text and save it.
  5. Check the alt rendered on the frontend corresponds to the category name.

Hide the Product Tag Cloud from the Widgets screen in classic themes. (6327)

  1. With a classic theme (ie: Storefront), go to Appearance > Widgets.
  2. Open the block inserter and make sure the Product Tag Cloud (isn't showing up)

Add the alt text control to the Featured Product block media settings. (6308)

  1. Create a new page and add a Featured Product.
  2. On the block settings go to Media Settings and check the Alt text textarea appears empty.
  3. Add an alt text, save the block and check it renders on the frontend with the specified alt text.
  4. Edit the block again, remove the alt text and save it.
  5. Check the alt rendered on the frontend corresponds to the product name.

GridContentControl: Add product image control. (6302)

  1. Activate a block theme, like Twenty Twenty Two
  2. Create a new page, and add all the aforementioned, affected blocks (Handpicked Products etc.)
  • Hand-picked Products
  • Products by Tag
  • Products by Attribute
  • Products by Category
  • Best Selling Products
  • Newest Products
  • On Sale Products
  • Top Rated Products
  1. Check if the Product image toggle is present under Content
  2. Verify that the toggle shows/hides product Images both in the editor and the frontend

Remove the Template panel from the Setting Sidebar for Shop page. (6366)

  1. Active Twenty Twenty-Two.
  2. Make sure WooCommerce is setup (WC pages are installed).
  3. Edit the Shop Page, don't see the Template panel.
  4. Edit other pages, see the Template panel as normal.

Parse categories coming from the back-end as a json array. (6358)

  1. Create two products assigned to two different categories and add one review to each of them.
  2. Create a new page and add a Reviews by Category block.
  3. Select only one category on the block (corresponding to one of the previous products/reviews) and save it.
  4. Check that it renders the expected reviews only on the edit mode.
  5. Publish the page, go to the frontend and check it renders the same expected reviews.
  6. Edit the block and select multiple categories.
  7. Check that it renders the expected reviews only on the edit mode.
  8. Update the page, go to the frontend and check it renders the same expected reviews.
  9. Edit again the block and deselect all the categories.
  10. Check that it renders all the reviews only on the edit mode.
  11. Update the page, go to the frontend and check it renders also all the reviews.

Fix: Mini Cart block is not available from the Edit template screen. (6351)

  1. With Twenty Twenty-Two, add the Mini Cart block to the header template part.
  2. Edit a page using Block Editor.
  3. From the Page sidebar, edit the template.
4. Notice the Mini Cart block works as expected.

Fix Filter Products by Attribute block not working on PHP templates when Filter button was enabled. (6332)

  1. With a block theme, go to Appearance > Site Editor.
  2. Go to Templates and edit the Product Catalog template.
  3. Above the WooCommerce Classic Template block, add the Filter Products by Attribute block (making sure you only have one Filter Products by Attribute block) and set its Filter button attribute to true.
  4. In the frontend, filter by attribute.
  5. Verify the page reloads and the filter is applied.

WooCommerce Core Updates

Payments Banner in Settings experiment (#32662, #32697, #33066))

Workflow: WooCommerce Core

  1. Start with a fresh install of WooCommerce
  2. Install and activate the latest WooCommerce Test Helper plugin

Scenario 1 WCPay eligible and WCPay not installed -> Should not see the banner

  1. Navigate to WooCommerce > Settings and Set the store country to an eligible WooCommerce Payments country, such as United States. (List of eligible countries here https://woocommerce.com/document/payments/countries/#section-1).
  2. Navigate to WooCommerce > Settings and click Payments tab to trigger the experiment check and populate it into our helper plugin.
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle 'woocommerce_payments_settings_banner_2022_*' to control
  4. Go back to WooCommerce > Settings > Payments tab.
  5. WCPay eligible and WCPay not installed -> Should not see the banner

Scenario 2 WCPay ineligible and/or WCPay not installed -> Should not see the banner

  1. Navigate to WooCommerce > Settings and Set the store country to an ineligible WooCommerce Payments country, such as Norway. (List of eligible countries here https://woocommerce.com/document/payments/countries/#section-1).
  2. Navigate to WooCommerce > Settings and click Payments tab to trigger the experiment check and populate it into our helper plugin.
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle 'woocommerce_payments_settings_banner_2022_*' to control
  4. Go back to WooCommerce > Settings > Payments tab.
  5. WCPay ineligible and/or WCPay not installed -> Should not see the banner

Scenario 3 WCPay eligible and WCPay installed but setup incomplete and assigned to 'control' -> Should not see the banner

  1. Navigate to WooCommerce > Settings and Set the store country to an eligible WooCommerce Payments country, such as United States. (List of eligible countries here https://woocommerce.com/document/payments/countries/#section-1).
  2. Navigate to WooCommerce > Settings and click Payments tab to trigger the experiment check and populate it into our helper plugin.
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle 'woocommerce_payments_settings_banner_2022_*' to control
  4. Install and activate the WooCommerce Payments plugin directly using the WordPress plugin screen.
  5. Go back to WooCommerce > Settings > Payments tab.
  6. WCPay eligible and WCPay installed but setup incomplete and assigned to 'control' -> Should not see the banner

Scenario 4 WCPay eligible and WCPay installed but setup incomplete and assigned to 'treatment' -> Should see the banner

  1. Navigate to WooCommerce > Settings and Set the store country to an eligible WooCommerce Payments country, such as United States. (List of eligible countries here https://woocommerce.com/document/payments/countries/#section-1).
  2. Navigate to WooCommerce > Settings and click Payments tab to trigger the experiment check and populate it into our helper plugin.
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle 'woocommerce_payments_settings_banner_2022_*' to treatment
  4. Install and activate the WooCommerce Payments plugin directly using the WordPress plugin screen.
  5. Go back to WooCommerce > Settings > Payments tab.
  6. WCPay eligible and WCPay installed but setup incomplete and assigned to 'treatment' -> Should see the banner

Scenario 5 WCPay eligible and WCPay installed but setup incomplete and assigned to 'treatment' -> Should see the banner -> Skip payment welcome screen

  1. Navigate to WooCommerce > Settings and Set the store country to an eligible WooCommerce Payments country, such as United States. (List of eligible countries here https://woocommerce.com/document/payments/countries/#section-1).
  2. Navigate to WooCommerce > Settings and click Payments tab to trigger the experiment check and populate it into our helper plugin.
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle 'woocommerce_payments_settings_banner_2022_*' to treatment
  4. Install and activate the WooCommerce Payments plugin directly using the WordPress plugin screen.
  5. Go back to WooCommerce > Settings > Payments tab.
  6. WCPay eligible and WCPay installed but setup incomplete and assigned to 'treatment' -> Should see the banner
  7. Click WCPay "Get Started" button in the banner
  8. Confirm the button redirects you to the WC Pay connect page.
  9. Go back and Click WCPay "Get Started" button in the payments table
  10. Confirm the button also redirects you to the WC Pay connect page.

Scenario 6 WCPay eligible and WCPay installed and setup completed and assigned to 'treatment' -> Should not see the banner

  1. Navigate to WooCommerce > Settings and Set the store country to an eligible WooCommerce Payments country, such as United States. (List of eligible countries here https://woocommerce.com/document/payments/countries/#section-1).
  2. Navigate to WooCommerce > Settings and click Payments tab to trigger the experiment check and populate it into our helper plugin.
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle 'woocommerce_payments_settings_banner_2022_*' to treatment
  4. Install and activate the WooCommerce Payments plugin directly using the WordPress plugin screen. Complete the setup for WooCommerce Payments (Developer mode information here)
  5. Go back to WooCommerce > Settings > Payments tab.
  6. WCPay eligible and WCPay installed and setup completed and assigned to 'treatment' -> Should not see the banner

Change wcpay task display logic #32923

Workflow: WooCommerce Core Setup List

Display the wcpay task when WooCommerce Payments is installed during the OBW

  1. Use a fresh site
  2. Choose a supported country like US in the Store Details step
  3. Install WooCommerce Payments in the Business Details / Free Features step.
  4. Go to Woocommerce > Home
  5. Observe that Get paid with WooCommerce Payments task is displayed

Display the wcpay task when WooCommerce Payments is installed via Plugins > Add New

  1. Use a fresh site
  2. Choose a supported country like US in the Store Details step
  3. Uncheck WooCommerce Payments in the Business Details / Free Features step.
  4. Install WooCommerce Payments via Plugins > Add New
  5. Go to Woocommerce > Home
  6. Observe that Get paid with WooCommerce Payments task is displayed

Do not display the wcpay task when task list has been completed

  1. Use a fresh site
  2. Choose a supported country like US in the Store Details step
  3. Uncheck WooCommerce Payments in the Business Details / Free Features step.
  4. Go to Woocommerce > Home
  5. Complete all tasks
  6. Install WooCommerce Payments via Plugins > Add New
  7. Go to Woocommerce > Home
  8. Observe that Get paid with WooCommerce Payments task is NOT displayed

Product Task experiment (#32941, #32973, #32801, #32779)

Workflow: WooCommerce Core Setup List

Prerequisite

  1. Start with a fresh install of WooCommerce
  2. Install and activate the latest WooCommerce Test Helper plugin
  3. Skip OBW
  4. Navigate to Tools > WCA Test Helper > Experiments and add woocommerce_products_task_layout_stacked to treatment
  5. Make sure your site has woocommerce_allow_tracking option set to yes

Test no notice on the empty Products page

  1. Make sure debug is enabled or use query monitor
  2. Go to the Products page
  3. Observe No error/warning notices

Testing control

  1. Navigate to WooCommerce > Home
  2. Go to "Add products" task
  3. Observe the old products task is displayed

Testing card layout

  1. Go to Tools > WCA Test Helper > Experiments
  2. Enable treatment for woocommerce_products_task_layout_card
  3. Navigate to WooCommerce > Home
  4. Go to "Add products" task
  5. Observe new products task with card layout
  6. Add a new product from the available templates Physical product, Digital product, Variable product, Grouped product, External product.

Testing stacked layout

  1. Go to Tools > WCA Test Helper > Experiments
  2. Enable treatment for woocommerce_products_task_layout_stacked and disable woocommerce_products_task_layout_card
  3. Navigate to WooCommerce > Home
  4. Go to "Add products" task
  5. Observe new products task with stacked layout
  6. Add a new product from the available templates Physical product, Digital product, Variable product, Grouped product, External product.

Add experimental import products task (#32835, #33047)

  1. Start with a fresh install of WooCommerce
  2. Install and activate the latest WooCommerce Test Helper plugin
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle woocommerce_products_task_layout_stacked to treatment
  4. Make sure your site has woocommerce_allow_tracking option set to yes
  5. Start OBW.
  6. Choose Yes, on another platform in the Business Details step.
  7. Navigate to WoocCommerce -> Home and click Add my products
  8. You should see the new Import your products
  9. Check the options work ok

Add experimental sample products task (#32960, #32977, #32815)

Prerequisite

  1. Start with a fresh install of WooCommerce
  2. Install and activate the latest WooCommerce Test Helper plugin
  3. Skip OBW
  4. Navigate to Tools > WCA Test Helper > Experiments and toggle woocommerce_products_task_layout_stacked to treatment
  5. Make sure your site has woocommerce_allow_tracking option set to yes

Testing old sample import if not treatment

  1. Install WooCommerce Admin Test Helper
  2. Go to Tools > WCA Test Helper > Experiments
  3. Disable both woocommerce_products_task_layout_stacked and woocommerce_products_task_layout_card experiment
  4. Make sure there are no products in store (if there are in trash, empty them)
  5. Go to appearance task /wp-admin/admin.php?page=wc-admin&task=appearance
  6. Click on "Import products" button
  7. Go to Products page
  8. Observe 18 products are imported

Testing sample import under treatment

  1. Go to Tools > WCA Test Helper > Experiments
  2. Enable treatment for either woocommerce_products_task_layout_stacked or woocommerce_products_task_layout_card
  3. Trash all products & empty trash
  4. Go to Products task
  5. Click on "Load sample products"
  6. Observe that a confirmation dialog is displayed
  7. Click Import sample products button
  8. Observe 9 products are imported

Testing fashion sample import under treatment

  1. Go to Tools > WCA Test Helper > Experiments
  2. Enable treatment for either woocommerce_products_task_layout_stacked or woocommerce_products_task_layout_card
  3. Trash all products & empty trash
  4. Go to Products task
  5. Click on "Load sample products"
  6. Observe that a confirmation dialog is displayed
  7. Click Import sample products button
  8. Observe 9 fashion products are imported

Add WooCommerce > Subscriptions admin menu item and empty state offer screen #32957

Workflow: WooCommerce Core

  1. Start with a fresh install of WooCommerce
  2. Install and activate the latest WooCommerce Test Helper plugin
  3. Plugin eligibility: Ensure the following plugins are not installed at all:
    • WooCommerce Subscriptions
    • WooCommerce Payments
    • Sumo Subscriptions
    • Yith Subscriptions
    • Subscripto
    • Subscriptions For WooCommerce
  4. Store tracking eligibility: Your store allows tracking.
    • This checkbox should be checked: WooCommerce → Settings → Advanced → WooCommerce.com → Enable tracking.
  5. Store location eligibility: For the menu item to be displayed your store needs to based in the US.
    • Go to WooCommerce > Settings and make sure your store is set to a US based address.
  6. Store age criteria: To view the subscription menu item your store will need to have been active for more than 6 months - we're testing this experiment on established stores. If your store doesn't meet this criteria, you can use the following code snippet with the code snippet plugin:
    • update_option( 'woocommerce_admin_install_timestamp', strtotime( '-6 month' ) );
    • or change the woocommerce_admin_install_timestamp option to 1620866357 (timestamp from ~1 year ago) via the /wp-admin/options.php page.
  7. Paid order criteria: Only stores with at least 1 order in the last 30 days are eligible. If your store doesn't have an order in the last 30 days. Either:
    1. Set any existing pending or failed order to processing or completed
    2. If you don't have any order at all, you can just manually create one in WooCommerce > Orders > Add new and set it to processing or completed status
  8. If you meet all the criteria above you should see a WooCommerce > Subscriptions (new) menu item.
  9. View the WooCommerce > Subscriptions (new) page.
    • The 'new' badge should disappear on subsequent page loads.

Screen Shot 2022-05-11 at 2 34 56 pm

The error scenario

If an error occurs during plugin installation and activation an error message will be displayed directing the user to install the WooCommerce Payments plugin manually.

To test this flow:

  1. Add the following code snippet to your site.
  2. Go to WooCommerce -> Subscriptions
  3. Click "Get started"
  4. An error should occur installing the plugin. See example below.
define( 'DISALLOW_FILE_MODS', true );

Screen Shot 2022-05-11 at 3 00 59 pm

Note: The link takes the user to the WooCommerce Payments wp.org page.

The success scenario

  1. Go to WooCommerce > Subscriptions
  2. Click "Get started"
  3. WooCommerce Payments will be installed and activated in the background
  4. Once complete, you will be directed to the “Add new product” page or to the WCPay onboarding flow depending on which experiment treatment you were assigned to. Please see the "Testing the treatments" section below for more instructions.

The dismiss scenario

  1. Go to WooCommerce > Subscriptions
  2. Click "No thanks"
  3. You should be redirected to the WooCommerce > Home screen and the subscriptions menu item should no longer be displayed.

Note: If you need to bring the menu item back, delete or change the woocommerce-wcpay-subscriptions_dismissed wp option.

Testing the treatments

Download, install and activate the WooCommerce Admin Test Helper plugin.

Navigate to Tools → WCA Test Helper → Experiments. This page should contain a row for the "woocommerce_wcpay_subscriptions_page_202207_v1" experiment.

Here you can toggle between the control (treatment A) and the treatment (treatment B).

Treatment A

  1. Toggle to the control experience from Tools → WCA Test Helper → Experiments.
  2. Navigate to WooCommerce → Subscriptions.
  3. Observe the following step headers in the "You’re only steps away from selling subscriptions" section.
    1. Create a subscription
    2. Create and connect your account
    3. Provide a few business details
  4. Click the "Get started" button.
  5. The WooCommerce Payments plugin will be installed & activated and you will be redirected to the “Add new product” page.

Treatment B

  1. Toggle to the treatment experience from Tools → WCA Test Helper → Experiments.
  2. Navigate to WooCommerce → Subscriptions.
  3. Observe the following step headers in the "You’re only steps away from selling subscriptions" section.
    1. Create and connect your account
    2. Provide a few business details
    3. Create subscriptions
  4. Click the "Get started" button.
  5. The WooCommerce Payments plugin will be installed & activated and you will be redirected to the WCPay onboarding flow.

Update add product task to only show "subscriptions" product type for stores in the US #33068

Workflow: WooCommerce Core Setup List

  1. Start with a fresh install of WooCommerce
  2. Install and activate the latest WooCommerce Test Helper plugin
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle woocommerce_products_task_layout_stacked to treatment
  4. Make sure your site has woocommerce_allow_tracking option set to yes
  5. Go to OBW
  6. Set Country to the US
  7. Select "Subscriptions" in the Product Types step.
  8. Navigate to WooCommerce > Home
  9. Go to "Add products" task
  10. Observe that the subscriptions product type is shown
  11. Go to woocommmerce > Settings
  12. Change Country / State to another country.
  13. Go back to "Add products" task
  14. Observe that the subscriptions product type is hidden.

Add TikTok marketing task #32850

Workflow: WooCommerce Core Setup List

  1. Start with a fresh install of WooCommerce
  2. Skip OBW
  3. Navigate to WooCommerce > Settings > Advanced > woocommerce.com.
  4. Disable (untick) Enable tracking and Show Suggestions.
  5. Navigate to WooCommerce > Home and begin the Set up marketing tools task.
  6. Confirm the TikTok plugin is listed under GROW YOUR STORE
  7. Go back to OBW and change the store country to that is not one of in the list. for example Brunei.
  8. Go back to the marketing task and confirm the plugin is no longer visible.
  9. Go back to OBW and change the store country back.
  10. Go back to the marketing task and click GET STARTED for the TikTok plugin. Make sure the plugin gets installed without any errors.

Adding badge to legacy admin menu to indicate remaining onboarding tasks #32611

Workflow: WooCommerce Core Setup List

  1. Start with a fresh install of WooCommerce
  2. Notice that no badge is displayed before completing any tasks (Unless one is auto-completed, which is true for at least one of the experiments)
  3. Complete the setup wizard, and notice that the badge is now displayed indicated remaining tasks image
  4. Complete a couple other tasks, notice that the badge is updated properly. (don't complete all of them)
  5. Hide the task list, and notice that the badge disappears
  6. Display the task list again through Help -> Setup Wizard -> Task List -> Enable
  7. Notice badge reappears
  8. Complete the setup task list.
  9. Notice the badge now disappears again.

Update react-dates to 21.8.0 #32954

_Workflow: WooCommerce Admin

  1. Navigate to Analytics -> Overview
  2. Click Date range: and make sure the date range works as expected.

Remove memoize-one from woo admin & update it to ^6.0.0 for woo components #32936

Workflow: WooCommerce Admin

  1. Go to Analytics > Overview
  2. Confirm that all charts should be rendered without errors.

Allow removal of all zone regions from a shipping zone #32828

Workflow: WooCommerce Core

  1. Go to WC > Settings > Shipping.
  2. Give it a name and choose a region.
  3. Save changes.
  4. Remove all the zone regions and click "Save Changes" again.
  5. Confirm that changes are saved correctly.

Mark marketing task as complete when an extension is installed #32630

Workflow: WooCommerce Core Setup List

  1. In a brand new store, go through the OBW, and in step 4 (Business Details), go to Free features and install the MailPoet extension.
  2. Finish the OBW.
  3. Go to the Home screen and verify that the marketing task is marked as completed.
  4. Delete the MailPoet extension.
  5. Verify that the marketing task is not marked as completed now.

Remove WCAdmin deactivation note #33028

Workflow: WooCommerce Admin

  1. In a fresh site, install & activate WooCommerce 6.4.1
  2. Install & activate WooCommerce Admin 3.2.1
  3. Go to Home > WooCommerce
  4. Observe the note "Deactivate old WooCommerce Admin version" exists
  5. Upgrade to WooCommerce 6.6
  6. Observe the note is removed after upgrade and WooCommerce Admin has been deactivated

Fix get_options function deprecation notice in WC 6.5 RC #32891

Workflow: WooCommerce Core

  1. Go to WooCommerce > Settings
  2. Confirm no deprecation notice in the PHP error log - The Automattic\WooCommerce\Admin\API\Options::get_options function is deprecated since version 3.1

Use the price decimal separator to format product weight and dimensions #32746

Workflow: WooCommerce Core

  1. Set your thousand separator as a dot (.) and decimal separator as a comma (,): image
  2. Edit a product or create a new, and try to add a dot as decimal in the weight and any of dimensions fields (you shouldn't be able to): image
  3. Save your changes and check if they're still using the comma as separator: image
  4. Set your thousand separator as a comma (,) and decimal separator as a dot (.) and check if the weight and dimensions values follows your new settings: image
  5. Now, the warning will appear if you try to use a comma instead: image

Fix progress header title #32786

Workflow: WooCommerce Core Setup List

  1. Start with a fresh install
  2. Install and activate the latest WooCommerce Test Helper plugin
  3. Navigate to Tools > WCA Test Helper > Experiments and toggle woocommerce_tasklist_setup_experiment_2_2022_* to treatment.
  4. Navigate to WooCommerce > Home, start the onboarding wizard, and press skip.
  5. The progress header should show up with a Welcome to <site name> above the task list.
  6. Now start and finish the OBW.
  7. The progress header should stay the same.
  8. Finish another task.
  9. Now the progress header should say Let's get you started :rocket:.
  10. Finish all the tasks.
  11. The message You've completed store setup will be visible.
  12. Refresh the page or select Show setup task list in the kebab menu.
  13. Now the progress header should show: Welcome to <site name>.

Add Preview store button to Home screen #32739

Workflow: WooCommerce Admin

  1. Go to the Home screen and verify the Preview store button is visible in the Activity panel.
  2. Press the button.
  3. The store's URL should be opened in a new tab.

Cleanup and fix translation path changes #33226

Workflow: WooCommerce Admin

  1. Install Woocommerce and set the site language to a language with good translation coverage such as French (France) or German Go to: Dashboard > Settings > General and change the Site language. Go to: Dashboard > Updates and click on the button to update translations
  2. Check that translations are working, both in the onboarding wizard and analytics screens

image

image


Add check for post_types key #33180

_Workflow: WooCommerce Blocks

  1. Install and active Quadrat theme. https://en-gb.wordpress.org/themes/quadrat/
  2. Go on the page for adding a product (/wp-admin/post-new.php?post_type=product)
  3. Be sure that it is not raised the warning: Warning: in_array() expects parameter 2 to be array, null given in /plugins/woocommerce/includes/admin/class-wc-admin-meta-boxes.php on line 279
Clone this wiki locally