From c01276ac57ca1bc09d6b806f935b221322a5dc5d Mon Sep 17 00:00:00 2001 From: Greg <71906536+zhongruige@users.noreply.github.com> Date: Thu, 18 Mar 2021 14:37:21 -0600 Subject: [PATCH] Updated Release Testing Instructions WooCommerce 5.2 (markdown) --- ...se-Testing-Instructions-WooCommerce-5.2.md | 267 +++++++++++++++++- 1 file changed, 264 insertions(+), 3 deletions(-) diff --git a/Release-Testing-Instructions-WooCommerce-5.2.md b/Release-Testing-Instructions-WooCommerce-5.2.md index 083436e..79b218e 100644 --- a/Release-Testing-Instructions-WooCommerce-5.2.md +++ b/Release-Testing-Instructions-WooCommerce-5.2.md @@ -4,13 +4,272 @@ WooCommerce 5.2 includes: - []() - [WooCommerce Pay Updates:]() - []() -- [WooCommerce Product Blocks Updates:]() +- [WooCommerce Product Blocks Updates:](https://github.com/woocommerce/woocommerce/wiki/Release-Testing-Instructions-WooCommerce-5.2#woocommerce-product-blocks-updates) - [Blocks 4.6.0]() - [Blocks 4.7.0]() - [WooCommerce Core Updates:]() - []() - +## WooCommerce Admin Updates: + +### 2.1.3 +#### Fix a bug where the JetPack connection flow would not activate #6521 + +1. With a fresh install of wc-admin and woocommerce, go to the home screen +2. Going to the homescreen redirects to the profile setup wizard +3. The first step is "Store details" choose United States (any state) for country and fill in the other details with test data. +4. Click "continue", you should be taken to the "Industry" step. +5. In the "Industry" step check the "Food and Drink" option only. Click "continue" +6. In the "Product Type" step choose any value and click "continue" +7. You should arrive at the "Business details" step which provides 2 tabs: "Business details" and "Free features". In the "Business Details" tab fill out the dropdowns with any values. Click "continue". +8. In the "Free features" step expand the list of extensions to install by clicking the arrow to the right of "Add recommended business features to my site". +9. Uncheck all the extensions except for "Enhance speed and security with Jetpack" +10. Click "continue", the plugin will be installed and you should arrive at the theme step. +11. Click "Continue with my active theme" +12. After finishing the wizard, this should redirect you to the "Jetpack" setup connection flow. (You should not be redirected straight to the homescreen). + +#### Update target audience of business feature step #6508 + +Scenario #1 + +1. With a fresh install of wc-admin and woocommerce, go to the home screen, which starts the onboarding wizard +2. Fill out the store details with a canadian address (addr: 4428 Blanshard, country/region: Canada -- British Columbia, city: Victoria, postcode: V8W 2H9) +3. Click continue and select **Fashion, apparel, and accessories**, continue, and select **Physical products**, and continue. +4. The business details tab should show a **Business details** tab, and a **Free features** tab (disabled at first) + - There should only be dropdowns visible on the **Business details** step (no checkboxes) +5. Select **1-10** for the first dropdown, and **No** for the second, and click Continue. +6. Click on the expansion icon for the **Add recommended business features to my site** +7. It should list 7 features, including **WooCommerce Payments** (top one) + - Note down the selected features, for step 10 +8. Click continue, and select your theme, after it should redirect to the home screen (showing the welcome modal, you can step through this). +9. The home screen task list should include a **Set up WooCommerce Payments** task, and there should also be a **Set up additional payment providers** inbox card displayed (below the task list). +10. Go to **Plugins > installed Plugins**, check if the selected plugin features selected in step 7 are installed and activated. + +Scenario #2 + +1. With a fresh install of wc-admin and woocommerce, go to the home screen, which starts the onboarding wizard +2. Fill out the store details with a spanish address (addr: C/ Benito Guinea 52, country/region: Spain -- Barcelona, city: Canet de Mar, postcode: 08360) +3. Click continue and select **Fashion, apparel, and accessories**, continue, and select **Physical products**, and continue. +4. On the business details tab select **1-10** for the first dropdown, and **No** for the second. + - After filling the dropdowns it should show several checkboxes with plugins (Facebook, mailchimp, creative mail, google ads) + - Note which ones you kept selected (you can unselect one or two) +5. Click continue, and select your theme, it should show the **WooCommerce Shipping & Tax** step after, you can click **No thanks**. +6. You will be redirected to the home screen, showing the welcome modal, you can step through this. +7. The task list should show the **Choose payment methods** task, and the **Set up additional payment providers** inbox card should not be present. +8. Click on the **Choose payment methods** task, it should not be displaying the **Woocommerce Payments** option. +9. Go to **Plugins > installed Plugins**, check if the selected plugin features selected in step 4 are installed and activated. + +### 2.1.2 + +#### Add Guards to "Deactivate Plugin" Note Handlers #6532 + +##### Test incompatible WooCommerce version + +- Install and activate Woocommerce 4.7 +- See that the Woocommerce Admin plugin is deactivated. +- Add the Deactivate Plugin note via SQL. + +``` +INSERT INTO `wp_wc_admin_notes` (`name`, `type`, `locale`, `title`, `content`, `content_data`, `status`, `source`, `date_created`, `date_reminder`, `is_snoozable`, `layout`, `image`, `is_deleted`, `icon`) VALUES ( 'wc-admin-deactivate-plugin', 'info', 'en_US', 'Deactivate old WooCommerce Admin version', 'Your current version of WooCommerce Admin is outdated and a newer version is included with WooCommerce. We recommend deactivating the plugin and using the stable version included with WooCommerce.', '{}', 'unactioned', 'woocommerce-admin', '2021-03-08 01:26:44', NULL, 0, 'plain', '', 0, 'info'); +``` + +- See that the note is in the inbox +- Activate the Woocommerce Admin plugin. +- See that Woocommerce Admin immediately de-activates without a fatal error. +- See that the note remains in inbox + +##### Test compatible WooCommerce version + +- Deactivate the Woocommerce Admin plugin. +- Install and activate the latest Woocommerce version. +- Add the Deactivate Plugin note via SQL. + +``` +INSERT INTO `wp_wc_admin_notes` (`name`, `type`, `locale`, `title`, `content`, `content_data`, `status`, `source`, `date_created`, `date_reminder`, `is_snoozable`, `layout`, `image`, `is_deleted`, `icon`) VALUES ( 'wc-admin-deactivate-plugin', 'info', 'en_US', 'Deactivate old WooCommerce Admin version', 'Your current version of WooCommerce Admin is outdated and a newer version is included with WooCommerce. We recommend deactivating the plugin and using the stable version included with WooCommerce.', '{}', 'unactioned', 'woocommerce-admin', '2021-03-08 01:26:44', NULL, 0, 'plain', '', 0, 'info'); +``` + +- Activate the Woocommerce Admin plugin. +- See that note is **not** in the inbox +- Add the Deactivate Plugin note via SQL. + +``` +INSERT INTO `wp_wc_admin_notes` (`name`, `type`, `locale`, `title`, `content`, `content_data`, `status`, `source`, `date_created`, `date_reminder`, `is_snoozable`, `layout`, `image`, `is_deleted`, `icon`) VALUES ( 'wc-admin-deactivate-plugin', 'info', 'en_US', 'Deactivate old WooCommerce Admin version', 'Your current version of WooCommerce Admin is outdated and a newer version is included with WooCommerce. We recommend deactivating the plugin and using the stable version included with WooCommerce.', '{}', 'unactioned', 'woocommerce-admin', '2021-03-08 01:26:44', NULL, 0, 'plain', '', 0, 'info'); +``` + +- De-activate the Woocommerce Admin plugin. +- See that note is **not** in the inbox + +### 2.1.0 + +#### Correct the Klarna slug #6440 + +1. Set up a new store with a UK address so that Klarna available as a payment processor +2. Go to the "Choose payment methods" task item +3. Set up Klarna. The plugin will install. +4. Click Continue. It should take you back to the payment methods page - previously it wasn't doing anything but a console error was displayed. + +#### Navigation: Reset submenu before making Flyout #6396 + +- Download and activate the MailChimp plugin. +- Turn on Navigation at Settings > Advanced > Features +- Return to the WP dashboard +- Hover over WooCommerce and see the flyout menu appear +- MailChimp should not be included. + +#### Email notes now are turned off by default #6324 + +- Create a zip for testing with `npm run zip:test`. +- Create a `jurassic.ninja` instance. +- Upload the plugin and activate it. +- Update the installation date (we need a 10-day old store). You can do it with an SQL statement like this (using the WP phpMyAdmin plugin): + +``` +UPDATE `wp_options` SET `option_value`=UNIX_TIMESTAMP(DATE_SUB(NOW(), INTERVAL 10 day)) WHERE `option_name` = 'woocommerce_admin_install_timestamp'; +``` + +- Confirm that `woocommerce_merchant_email_notifications` was not set before by `core` with a SQL statement like: + +``` +DELETE FROM `wp_options` WHERE `wp_options`.`option_name` = 'woocommerce_merchant_email_notifications'; +``` + +or with wp-cli: + +``` +wp option delete 'woocommerce_merchant_email_notifications'; +``` + +- Run the cron job `wc_admin_daily` (this tool can help [WP Crontrol](https://wordpress.org/plugins/wp-crontrol/)). + - Go to **Tools > Cron Events** and scroll down to the `wc_admin_daily`. + - Hover over the item and click `Edit` change the **Next Run** to `Now` and click `Update Event`. + - It will redirect you to the cron event list, and `wc_admin_daily` should be near the top, if you wait 10 seconds and refresh the page the `wc_admin_daily` should be near the bottom again, this means it has been run, and scheduled again to run tomorrow. +- You should have not received an email note. +- Verify the note `wc-admin-add-first-product-note` was added in the DB and its `status` is `unactioned`. You can use a statement like this: + +``` +SELECT `status` FROM `wp_wc_admin_notes` WHERE `name` = 'wc-admin-add-first-product-note'; +``` + +or with wp-cli: + +``` +wp db query 'SELECT status FROM wp_wc_admin_notes WHERE name = "wc-admin-add-first-product-note"' --skip-column-names +``` + +- Run the cron again. +- The note's status should continue being `unactioned`. + +#### Refactor menu item mapping and sorting #6382 + +1. Enable the new navigation under WooCommerce -> Settings -> Advanced -> Features. +2. Navigate to a WooCommerce page. +3. Make sure all items and categories continue to work as expected. +4. Activate multiple extensions that register WooCommerce extension categories. (e.g., WooCommerce Bookings and WooCommerce Payments). +5. Favorite and unfavorite menu items. +6. Make sure the menu item order is correct after unfavoriting. +7. Create a user with permissions to see some but not all registered WooCommerce pages. +8. Check that a user without permission to access a menu item cannot see said menu item. + +#### Fixed associated Order Number for refunds #6428 + +1. In a store with refunded orders. +2. Go to `Analytics` > `Orders` +3. Set the `Date Range` filter in order to cover the refunded order date. +4. Verify that now the associated order number and the related products are visible. + +#### Remove CES actions for adding and editing a product and editing an order #6355 + +1. Add a product. The customer effort score survey should not appear. +2. Edit a product. The customer effort score survey should not appear. +3. Edit an order. The customer effort score survey should not appear. + +#### Center the activity panel #6289 + +1. Narrow your screen to <782px +2. Go to WooCommerce home and orders page +3. Click on 'w' button, see that the activity panel renders as expected. + +#### Make sure that industry is defined in payment methods #6281 + +- Start a new store, and skip the initial onboarding flow, there is a button `Skip store details` at the bottom +- Load the `Set up payments` task, the payment options should load correctly. + +#### Add a new note with a link to the downloadable product doc #6277 + +1. Make sure your store does not have any download products. +2. Install WP Crontrol plugin. +3. Add a new download product. +4. Navigate to Tools -> Cron Events and run `wc_admin_daily` +5. Navigate to WooCommerce -> Home and confirm that the note has been added. + +#### Onboarding - Fixed "Business Details" error #6271 + +- Check out this branch. +- Go to the "Industry" step in the OBW and select `Food and drink`. +- Go to the "Business Details" step and press `Free features`. +- Press `Continue`. +- It should work. +- Try also selecting and unselecting some checkboxes before pressing `Continue`. + +#### Change `siteUrl` to `homeUrl` on navigation site title #6240 + +- Go to WP settings and set the home page to My account +- Go to WC settings and use the new navigation feature +- Click on the header site title My Site and see that the page direct to My account + +#### Refactor panel with withFocusOutside #6233 + +- Go to WooCommerce home page +- Click on Display and Help button back and forth, check that the popover and the panel close as expected. +- Check that the setup store tab continues to work. + +#### Move capability checks to client #6365 + +1. Create various non-admin users with custom capabilities. Make sure to not include the `view_woocommerce_reports` for at least one role. https://wordpress.org/plugins/leira-roles/ +2. Log in as the non-admin users. +3. Check that the correct menu items are shown. +4. Check that there aren't items shown to the user they should not be able to use or interact with. +5. Enable the new navigation under WooCommerce -> Settings -> Advanced -> Features. +6. Check that the users are able to see the new navigation menu. +7. Click on various tabs in the activity panel. +8. Make sure the tabs work as expected. +9. Make sure that users without the `manage_woocommerce` permission are not able to see the "Store Setup" tab. +10. With a user that can `manage_woocommerce`, navigate to the homepage via URL and make sure the homescreen is shown. `/wp-admin/admin.php?page=wc-admin` +11. With a user that cannot `view_woocommerce_reports` make sure navigating to an analytics report does not work. `/wp-admin/admin.php?page=wc-admin&path=/analytics/overview` + +#### Add CES track settings tab on updating settings #6368 + +- Make sure tracking is enabled in settings: + +``` +/wp-admin/admin.php?page=wc-settings&tab=advanced§ion=woocommerce_com +``` + +- Delete the option `woocommerce_ces_shown_for_actions` to make sure CES prompt triggers when updating settings. +- Enable the logging of Tracks events to your browser dev console: + +``` +localStorage.setItem( 'debug', 'wc-admin:tracks' ); +``` + +- Go to WooCommerce > Settings, and select a top-level tab such as Products, Shipping, etc. +- Click on `Save changes`. +- Observe in developer console, `wcadmin_ces_snackbar_view` is logged when CES prompt is displayed. +- In the event props, it should have a new `settings_area` key followed by the value of the settings tab you have selected. + +#### Add navigation intro modal #6367 + +1. Visit the homescreen and dismiss the original welcome modal if you haven't already. +2. Enable the new navigation under WooCommerce -> Settings -> Advanced -> Features. (This will also require opting into tracking). +3. Visit the WooCommerce Admin homescreen. +4. Note the new modal. +5. Check that pagination works as expected and modal styling is as expected. +6. Dismiss the modal. +7. Refresh the page to verify the modal does not reappear. +8. On a new site, enable the navigation before visiting the homescreen. +9. Navigate to the homescreen. +10. Note the welcome modal is shown and the navigation intro modal is not shown. +11. Refresh the page and note the nav intro modal was dismissed and never shown. ## WooCommerce Product Blocks Updates: @@ -20,4 +279,6 @@ When using the testing instructions below, test only those cases presented in th - [Testing instructions](https://github.com/woocommerce/woocommerce-gutenberg-products-block/blob/trunk/docs/testing/releases/460.md) #### Blocks 4.7.0 -- [Testing instructions](https://github.com/woocommerce/woocommerce-gutenberg-products-block/blob/trunk/docs/testing/releases/470.md) \ No newline at end of file +- [Testing instructions](https://github.com/woocommerce/woocommerce-gutenberg-products-block/blob/trunk/docs/testing/releases/470.md) + +## WooCommerce Core Updates: \ No newline at end of file