Updated Release Testing Instructions WooCommerce 6.9 (markdown)

rodelgc 2022-08-24 14:43:28 +08:00
parent ed9cde324e
commit aaf0c1e9e5
1 changed files with 423 additions and 1 deletions

@ -27,4 +27,426 @@ WooCommerce 6.9 includes:
3. Make sure you have `archive-product.html` in your theme's templates directory.
4. Notice the templates shows the correct title and description and not the file name like e.g. `archive-product.html`.
## WooCommerce Core Updates
## WooCommerce Core Updates
### Fix store details fails to save store address after navigating back to the tab ([34426](https://github.com/woocommerce/woocommerce/pull/34426))
1. Use a fresh site
4. Install and activate Gutenberg plugins. (Optional. I've confirmed this is not related to Gutenberg)
5. Go to OBW
6. Choose a Country and enter the Store address.
8. Click on Continue button.
9. Allow tracking on usage modal
10. Navigating back to the "Store Details" tab from the "Industry" tab.
11. Observe that the "Store Details" saves the store address.
12. Change store address
13. Click on the Continue button.
14. Navigate back to the "Store Details" tab from the "Industry" tab.
15. Observe that the "Store Details" saves the store address.
### Update in-app marketplace to display localized strings [#34356](https://github.com/woocommerce/woocommerce/pull/34356)
1. Go to `WooCommerce > Extensions`
2. Observe that Extensions are displayed properly.
3. Change the "Site Language" to `Español` on the **Setting** page
4. Go back to `WooCommerce > Extensions`
5. Observe that Extensions are displayed in Spanish
![Screen Shot 2022-08-17 at 14 41 19](https://user-images.githubusercontent.com/4344253/185051984-2c6d8e4a-76a3-48e6-8a3d-217d762e7402.png)
### Update "Refund Returns" note to display localized strings [#34352](https://github.com/woocommerce/woocommerce/pull/34352)
1. Use a fresh site
2. Go to `WooCommerce > Home`
3. Skip OBW
4. Observe that `Setup a Refund and Returns Policy page to boost your store's credibility.` note is displayed
5. Change the "Site Language" to `Español` on the **Setting** page
6. Go to `Dashboard > Updates`
7. Scroll to page bottom and make sure "Translations (Traducciones)" are all up to updated
8. Go to `WooCommerce > Home`
9. Observe that `Connect to WooCommerce.com` note is translated to `Configura una página de política de devoluciones y reembolsos para aumentar la credibilidad de tu tienda.`.
### Fix: Smart shipping defaults bug [#34351](https://github.com/woocommerce/woocommerce/pull/34351)
1. Start with a fresh install.
2. Do not initiate OBW yet.
3. Go to `WooCommerce -> Settings -> Shiping` and create a shipping zone.
4. Complete OBW and choose a country not that is not one of the US, CA, AU, or GB.
5. Navigate to `WooCommerce -> Home`
6. Navigate to `WooCommerce -> Settings -> Shiping` and confirm no extra shipping zone exist.
7. Confirm `woocommerce_admin_created_default_shipping_zones` option has been created.
### Add WC Payments welcome page experiment [#34251](https://github.com/woocommerce/woocommerce/pull/34251)
#### Setup
Perform the following steps to start meeting all the requirements and have the new Payments menu visible:
- `woocommerce_admin_install_timestamp` should be at least `now-90days in seconds`, using `1` works.
- **WooCommerce → Settings → Country** must be `US`.
- **WooCommerce → Settings → Advanced → WooCommerce.com** `Enable tracking` and `Show suggestions` must be checked.
- Use [experiment](20748-explat-experiment) bookmarklet to manually set `treatment` mode.
#### Requirements
Toggle the following steps to confirm that every condition is working and show/hide the Payment menu:
- Install WCPay.
- Connect to a WCPay account. _You'll need to clear `wcpay_account_data` option to meet the condition again_.
- Update `woocommerce_admin_install_timestamp` to today date.
- Choose another WC country.
- Uncheck `Show suggestions`.
- Filter `woocommerce_allow_marketplace_suggestions` to return `false`.
- Set `wc_calypso_bridge_payments_dismissed` option to `yes`.
- Set experiment to `control`.
#### Promotion
- Accept the promotion.
- Complete the onboarding process.
- The promotion should be applied, you can check it in **Payments → Overview**.
#### Tracks
- Click on `No thanks`
- Click on `Just remove WooCommerce Payments`
- Do it again but check any option and click on `Remove and send feedback`
- Check Tracks Live View and confirm the events are properly registered [with their props](https://github.com/woocommerce/woocommerce/blob/e0f6e357bfdcecb25e08f2ab47385687a40d55f8/plugins/woocommerce-admin/client/payments-welcome/exit-survey-modal.tsx#L44-L70).
#### Design
It should match the following screenshot.
<img width="50%" alt="Screenshot 2022-08-12 at 11 58 29" src="https://user-images.githubusercontent.com/7670276/184331597-9ffb2951-3b92-4b94-83de-6055a438166c.png">
### Deploy payments banner in settings page [#34326](https://github.com/woocommerce/woocommerce/pull/34326#top)
1. Set up a new store in WCPay-available countries such as US
2. Open developer console and run `localStorage.setItem( 'debug', 'wc-admin:*' );` to set debug for tracks
3. Make sure "Preserve log" option is checked in developer console
4. Install WCPay plugin
5. Go to WooCommerce > Settings > Payment
6. Observe the payments banner is displayed
7. Click on "Get started"
8. Make sure it attempts to connect
9. Observe `wcadmin_settings_payments_banner_connect_click` track is called
### Remove WCPay Subscriptions offer page experiment code [#34317](https://github.com/woocommerce/woocommerce/pull/34317)
1. Ensure your store is eligible to view the WC → Subscriptions experiment page. (see collapsed content for instructions)
<details>
<summary>See instructions here</summary>
1. **Plugin eligibility**: Ensure the following plugins are not installed at all:
- WooCommerce Subscriptions
- WooCommerce Payments
- Sumo Subscriptions
- Yith Subscriptions
- Subscriptio
- Subscriptions For WooCommerce
3. **Store tracking eligibility:** Your store allows tracking.
- This checkbox should be checked: **WooCommerce → Settings → Advanced → WooCommerce.com → Enable tracking**.
3. **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.
3. **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:
- `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.
5. **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
3. 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
4. ⚠️ **Note:** this order sale query is cached and so you may need to delete the `'woocommerce-wcpay-subscriptions_recent_sales_eligibility'` transient if this criteria failed previously.
</details>
2. Verify that the **WooCommerce > Subscriptions (new)** menu item and page is no longer be visible.
<p align="center">
<img width="322" alt="Screen Shot 2022-05-11 at 2 34 56 pm" src="https://user-images.githubusercontent.com/8490476/167772790-ef299bac-7d6b-4245-a640-5022c8c23e35.png">
</p>
### Add Facebook Extension to Onboarding [#34303](https://github.com/woocommerce/woocommerce/pull/34303)
#### With a new site,
1. Skip the Onboarding Wizard.
2. Disable "Display suggestions within WooCommerce " in Settings > Advanced > WooCommerce.com.
3. Navigate to the Free Features section in the Onboarding Wizard.
4. See that Facebook is listed.
5. Select Facebook and complete the Onboarding Wizard.
6. On the WordPress Plugins page, confirm that Facebook for WooCommerce plugin is installed.
#### Marketing Task
1. On the WordPress Plugins page, delete "Facebook for WooCommerce" plugin if it exists.
2. On WooCommerce Home, click the Marketing Task (Get more sales).
3. See that Facebook for WooCommerce is listed.
4. Click "Get Started" button on Facebook for WooCommerce.
5. Wait for Install.
6. See that Facebook move to "Installed marketing extensions"
7. Click "Manage" button.
8. See that Facebook for WooCommerce manage page loads.
### Update "context" prop of task list click/view event [#34297](https://github.com/woocommerce/woocommerce/pull/34297)
1. Go to `WooCommerce > Home`
2. Open browser developer tool
3. Enable track logging: `window.localStorage.setItem( 'debug', 'wc-admin:*' )`
4. Turn on `preserve log` option
![https://i.stack.imgur.com/H4EQ9.png](https://i.stack.imgur.com/H4EQ9.png)
5. Click the "Add products" task
6. Observe that the `wcadmin_tasklist_click` event is fired with the `context: woocommerce-home`
7. Observe that the `wcadmin_tasklist_view` event is fired with the `context: woocommerce-home`
8. Go to WooCommerce > Settings
9. Click on "Finish setup" button
10. Click the "Add products" task
11. Observe that the `wcadmin_tasklist_click` event is fired with the `context: page/activity-panel`
12. Observe that the `wcadmin_tasklist_view` event is fired with the `context: page/activity-panel`
### Fix review shipping option task title [#34294](https://github.com/woocommerce/woocommerce/pull/34294)
1. Start with a fresh install
2. Start OBW and choose United States as store country and fill out the "Address" field
3. Choose "Physical products"
4. Complete the OBW without installing anything from the Business Details tab.
5. Go to WooCommerce > Home
6. Observe that the shipping task appear with the title `Review shipping options` under "Things to do next"
### Enhance/34244 update data source poller for i18n [#34247](https://github.com/woocommerce/woocommerce/pull/34247)
1. Use a fresh site
2. Go to OBW
3. Select a country where WCPay is not supported such as `Afghanistan`
4. Uncheck `Add recommended business features to my site` in the Business details / free features step and finish the steps.
6. Go to the Setting page
7. Change site language to `Español`
8. Go to `Escritorio > Actualizaciones` (Dashboard > Updates)
9. Click on the Update Translations (`Traducciones`) button to download WooCommerce translation files.
10. Go to WooCommerce > Home
11. Click on `Configurar pagos` (payment) task
12. Observe plugin descriptions are translated.
13. Go back to WooCommerce > Home
14. Click on `Consigue más ventas` (marketing) task
15. Observe plugin descriptions are translated.
16. Go to OBW > Business details / free features (http://localhost:8888/wp-admin/admin.php?page=wc-admin&path=%2Fsetup-wizard&step=business-details)
17. Click on `Detalles del negocio` tab
18. Expand the `Añade características de negocios recomendadas para mi sitio`
19. Observe plugin descriptions are translated.
20. Go to `Usuarios > Perfil` (User > Profile)
21. Change `Idioma` back to English
22. Repeat 10~19 and confirm that all texts are in English
![Screen Shot 2022-08-10 at 12 37 10](https://user-images.githubusercontent.com/4344253/183816934-006334b7-42f2-4741-9add-85f8ca193dfa.png)
![Screen Shot 2022-08-10 at 12 36 57](https://user-images.githubusercontent.com/4344253/183816942-3b7dad6a-ecd8-4c1c-b7d5-0b548430d4c0.png)
![Screen Shot 2022-08-10 at 12 36 47](https://user-images.githubusercontent.com/4344253/183816952-7cc7ff62-f799-44ea-8b60-028e747e4212.png)
### Keep the user in the marketing task after installing an extension [#34241](https://github.com/woocommerce/woocommerce/pull/34241)
1. Go to `WooCommerce > Home`
2. Go to "Add sales channels" task
3. Click on either one of the "Get Started" buttons under `Recommended marketing extensions` section.
4. Observe that after the plugin is installed, you're not redirected to other pages.
### Add product name and checkboxes for Product details [#34214](https://github.com/woocommerce/woocommerce/pull/34214)
2. Verify that the texts look correct.
3. Verify that the help button (next to the checkbox text) and dialog work as expected. It should open on hover and track the event `wcadmin_add_product_learn_more` after pressing `Learn more`.
4. Verify that the event `wcadmin_woocommerce-add-product__checkbox-featured` is recorded after toggling the checkbox.
5. Verify that the input and checkbox values are being saved correctly.
![screenshot-clean local-2022 08 11-08_30_17](https://user-images.githubusercontent.com/1314156/184124234-952c8603-aba5-40b3-b241-c80fad99d3e4.png)
### Add product form buttons and specific product edit page [#34211](https://github.com/woocommerce/woocommerce/pull/34211)
1. Enable the `new-product-management-experience` feature flag by using the WCA Test Helper (Tools > WCA Test Helper > Features) and refresh the page.
2. Enable track logging by running this in your console: `localStorage.setItem( 'debug', 'wc-admin:*' );`
3. Navigate to **Products > Add New (MVP)** and type something in the name field
4. Click **Save draft** and a `wcadmin_product_edit` track should fire with some of the product details ( if a brand new product then these product details will be `undefined`).
5. Notice how a notice popped up with **Product successfully created** and the `path` in the url also changed to the new product id.
6. Edit the name again and click **Save draft** again, it should trigger a track again, this time with the product details defined.
7. Click **Preview** it should open a new tab with the product preview and the original tab should output a `wcadmin_product_preview_changes` track.
8. Click **Publish**, which should output a `wcadmin_product_update` track and also show a notice again **Product published.** with a **View in store** link that should open a new tab with a preview and also trigger the `wcadmin_product_preview_changes` track.
After publish the **Publish** button should also change to **Update**, the **Save draft** button should switch to **Switch to draft**
9. Click the dropdown beside the Update/Publish button and it should contain 3 options. Try each, they each should output their own tracks: `wcadmin_product_publish_and_copy`, `wcadmin_product_copy`, and `wcadmin_product_delete`
The two copy actions should create a new product with the `- Copy` tagged on to the name and redirected to it's edit screen (in draft).
10. When on an edit screen of a product click **Add New (MVP)** again, it should reset the form to pristine conditions again.
https://user-images.githubusercontent.com/2240960/183488212-4146ab6e-4f0f-4d8a-bc72-9cffe68d86d1.mp4
### Update "Add store details" task complete logic [#34206](https://github.com/woocommerce/woocommerce/pull/34206)
**Completes the task via onboarding wizard**
1. Use a fresh site
2. Go to OBW
3. Fills out all fields in step 1
4. Complete the onboarding wizard
5. Observe that "Add store details" task is marked as completed
**Completes the task by filling out address fields on the setting page**
1. Use a fresh site
2. Go to OBW
3. Skips the onboarding wizard
4. Observe that "Add store details" task is not closed
5. Click the "Add store details" task
6. Fill out the **city, country, address1, and post code**
7. Go back to `WooCommerce > Home`
8. Observe that the "Add store details" task is marked as completed
### Clear post cache after updating menu order for products. [#34195](https://github.com/woocommerce/woocommerce/pull/34195)
1. Create/publish some products and assign a category to them
2. Head over to **WooCommerce > Categories**, click on the number next to the category
3. Once you are on the category products dashboard, click on the **Sorting** link at the top
4. Drag products to reorder them
5. Refresh the page and notice the changes are not saved
https://user-images.githubusercontent.com/3696121/131747478-a50fe0aa-e117-48a6-a34e-5fe5fc267090.mp4
#### Demo
Here's how things work **without** the fix (note how after reordering the products I click on **Sorting** to refresh the page, and the order reverts to how it was at the start of the video):
https://user-images.githubusercontent.com/3594411/182959163-804ac77a-7401-49cd-8bbb-f7cac2835b54.mov
And here is how things work **with** the fix. This time, on refreshing, the new order persists:
https://user-images.githubusercontent.com/3594411/182959179-79f2fe79-727e-46a4-8a34-a6f90a6d2867.mov
### Fix set default homescreen layout after setup task completion or dismissal [#34191](https://github.com/woocommerce/woocommerce/pull/34191)
**Test completion**
1. Set up a new store
2. Complete setup tasklist tasks
3. Refresh on WooCommerce > Home
4. Observe the homescreen layout is set to two columns
<img width="1097" alt="image" src="https://user-images.githubusercontent.com/3747241/182855413-e8f61712-3188-4d72-bc6a-6842f8fe466a.png">
**Test dismissal**
1. Set up a new store
2. Hide setup tasklist
3. Refresh on WooCommerce > Home
4. Observe the homescreen layout is set to two columns
<img width="1086" alt="image" src="https://user-images.githubusercontent.com/3747241/182858147-6198f4d8-cb45-4910-9778-63884db9be5b.png">
### Update/34063 store location skip btn [#34176](https://github.com/woocommerce/woocommerce/pull/34176)
Make sure `woocommerce_allow_tracking` option is set to `no`
1. Start with a fresh site.
2. Start OBW
3. You should see `Skip` button at the bottom of each step.
4. Click exclamation mark. A popover should appear with text `manual setup is only recommended for experienced WooCommerce users or developers.`
5. Click `Skip` button. UsageModal should show up.
6. Click "No Thanks`
7. Confirm `woocommerce_allow_tracking` is still `no`
8. Go back to the OBW
9. Click `Skip` button again.
10. Click `Yes, count me in` button.
11. You should be redirected to `WooCommerce -> Home`
12. Confirm `woocommerce_allow_tracking` is now `yes`
**Testing tracks**
Set `woocommerce_allow_tracking` to `no`
1. Go back to OBW again
2. Open browser inspector and enable tracks debug.
3. Click `Skip` button on each page and click `Yes, count me in`
4. Confirm the track event is recorded.
#### Screenshots
**UsageModal**:
![Screen Shot 2022-08-04 at 11 54 25 AM](https://user-images.githubusercontent.com/4723145/182931206-a3953b32-deae-4f48-8c74-bd53a2b8a431.jpg)
### Update store location profiler [#34153](https://github.com/woocommerce/woocommerce/pull/34153)
1. Use a fresh site
2. Go to OBW
3. Observe that the subheading should be `"Tell us where you run your business to help us configure currency, shipping, taxes, and more in a fully automated way."` **without a tooltip.**
4. And the fields should appear in the order of `Country / Region, Address, Post / Zip Code, City, Email Address`.
5. And the Country/Region is a mandatory field marked with an asterisk
6. And the "Continue" button should appear below the fields. But is disabled unless the mandatory field (Country / Region) is completed.
7. Completes the mandatory field (Country / Region)
8. Observe that the "Continue" button is enabled.
### add: store location settings tour [#34137](https://github.com/woocommerce/woocommerce/pull/34137)
1. Start with a fresh install of WooCommerce, optionally complete OBW or not (not a condition to have completed it)
2. Go to the task list and click on "You added store details" or "Add store details" in the tasklist (it might be struck through)
3. You should be redirected to the WooCommerce settings page, on the general tab and have a spotlight on the store location fields.
4. Subsequent visits should not show the spotlight
### Add/42 new product page [#34115](https://github.com/woocommerce/woocommerce/pull/34115)
2. Turn on the feature flag by using the plugin [woocommerce-admin-test-helper](https://github.com/woocommerce/woocommerce-admin-test-helper) (link [here](https://github.com/woocommerce/woocommerce-admin-test-helper/releases/download/v0.7.6/woocommerce-admin-test-helper.zip)). You will see the option `new-product-management-experience` under `Tools > WCA Test Helper > Features`.
3. Refresh the page.
4. Verify that a blank page is shown with the title `Add product` after pressing the following buttons:
`Products > Add New` and the `Add New` button under `Products > All Products` and the `Add manually` in the `Add my products` task.
5. Verify the event `view_new_product_management_experience` is being recorded when viewing the `Add product` page.
6. Verify that it works as expected using the new navigation too.
7. Turn off the feature flag and verify that the `Add New` button works as expected.
![screenshot-clean local-2022 07 29-10_06_00](https://user-images.githubusercontent.com/1314156/181767935-f885b562-6c0b-4da0-9468-a562e3845be6.png)
![screenshot-clean local-2022 07 29-10_05_52](https://user-images.githubusercontent.com/1314156/181768048-aa60636d-5d4e-491d-ad11-8e510e3efaa1.png)
![screenshot-clean local-2022 07 29-10_06_19](https://user-images.githubusercontent.com/1314156/181767814-45482303-efdf-4c92-82d6-5286725b5471.png)
### Add/33 two column product page layout [#34113](https://github.com/woocommerce/woocommerce/pull/34113)
1. Enable the `new-product-management-experience` feature flag by using the WCA Test Helper (Tools > WCA Test Helper > Features)
2. Refresh the page and go to **Products > Add New (MVP)** and check if the layout matches that of the new design 5sAIeTRd9Yp7nSCT33BAWz-fi-5311%3A202025, fields don't need to match yet as those would be added in the future.
Also note that some of the `onChange` functions are empty callbacks, this is because the Form component isn't hooked up yet, this relies on https://github.com/woocommerce/woocommerce/pull/34082
<img width="425" alt="Screen Shot 2022-07-28 at 4 42 41 PM" src="https://user-images.githubusercontent.com/2240960/181623868-9185f641-4311-43d4-a9a1-a4e155b3dee7.png">
<img width="1127" alt="Screen Shot 2022-07-28 at 4 33 17 PM" src="https://user-images.githubusercontent.com/2240960/181623927-3f7a3b4d-d9da-4e0d-ac98-5f5afcc04af0.png">
### Use the default payment suggestions when woocommerce_show_marketplace_suggestions is set to no [#34083](https://github.com/woocommerce/woocommerce/pull/34083)
1. Start with a fresh install and complete OBW without installing any plugins in the business step.
2. Set `woocommerce_show_marketplace_suggestions` option to `no`
3. Go to `WooCommerce -> Home` and choose `Set up payments` task.
4. Confirm the suggestions are rendered as expected
### Fix missing product task add product track via product templates [#34070](https://github.com/woocommerce/woocommerce/pull/34070)
1. Navigate to **Tools > WCA Test Helper > Experiments** and add `woocommerce_products_task_layout_card_v2` to treatment
1. Make sure your site has `woocommerce_allow_tracking` option set to yes
2. Enable tracks debugging with `localStorage.setItem( 'debug', 'wc-admin:*' );`
1. Go to WooCommerce > Home > Add my products
3. Click on any of the product templates while having browser console open
4. Observe `wcadmin_tasklist_add_product` with `{ method: product_template }` is fired
5. Repeat steps with setting `woocommerce_products_task_layout_stacked_v2` experiment to treatment and `woocommerce_products_task_layout_card_v2` to control
<img src="https://user-images.githubusercontent.com/3747241/180907818-a0a6d70d-f053-4f74-a6b0-6fb1e0c0924f.png" width="350">
<img src="https://user-images.githubusercontent.com/3747241/180907826-fc9bed24-09b9-4447-911f-06453a034260.png" width="350">
### Fix fatal error when bulk editing sale price to empty value in PHP 8 [#34053](https://github.com/woocommerce/woocommerce/pull/34053)
1. Create two products with a price as follows:
![image](https://user-images.githubusercontent.com/30685349/154960905-75c37341-b590-4961-af99-de5026faeb46.png)
2. Try to use bulk edit and LEAVE `ENTER SALE PRICE` FIELD **EMPTY** _( do not type anything there )_
![image](https://user-images.githubusercontent.com/30685349/154961423-a01561a5-149e-4f2a-87fe-5858767c1b46.png)
3. And now try to update
![image](https://user-images.githubusercontent.com/30685349/154961506-cc7922fd-469d-4e68-a946-d1dac9c83233.png)
4. You should not see this error: `PHP Fatal error: Uncaught TypeError: Unsupported operand types: string - string in /xxxx/xxxx/xxxx/wp-content/plugins/woocommerce/includes/admin/class-wc-admin-post-types.php:968`
### Fix Tracks event in Review Shipping task [#34045](https://github.com/woocommerce/woocommerce/pull/34045)
With a new store,
1. Select United States as a country.
2. Continue through the onboarding wizard without installing free business features.
3. On the "Things to do next" task list, choose "Review Shipping Options".
4. Complete the spotlight tour on the settings page..
5. Navigate to WooCommerce > Home
6. See that the "Review Shipping Options" task is completed.7.
7. Navigate to WooCommercer > Status > Logs
8. Choose the Tracks log for the current date.
9. Confirm the Tracks event is in the log:
```
2022-07-27T13:47:15+00:00 DEBUG wcadmin_extended_tasklist_task_completed
2022-07-27T13:47:15+00:00 DEBUG - task_name: review-shipping
```