From 70682683cfbef543646ccc8e2ff14b22256ec02f Mon Sep 17 00:00:00 2001 From: Julia Amosova Date: Thu, 30 Apr 2020 14:49:50 -0400 Subject: [PATCH] Created Release Testing Instructions WooCommerce 3.9 (markdown) --- ...se-Testing-Instructions-WooCommerce-3.9.md | 167 ++++++++++++++++++ 1 file changed, 167 insertions(+) create mode 100644 Release-Testing-Instructions-WooCommerce-3.9.md diff --git a/Release-Testing-Instructions-WooCommerce-3.9.md b/Release-Testing-Instructions-WooCommerce-3.9.md new file mode 100644 index 0000000..8107b27 --- /dev/null +++ b/Release-Testing-Instructions-WooCommerce-3.9.md @@ -0,0 +1,167 @@ +### Product Blocks + +WooCommerce Product Blocks 2.5 is included in this release. WooCommerce Products Blocks is our eCommerce focused blocks for the Gutenberg editor that has been part of WordPress since 5.0. + +The first Product Blocks were included in WooCommerce 3.6. With the inclusion of Product Blocks 2.5 in WooCommerce 3.9, new blocks were added: + +- All Products Block + +To give merchants the power to change what product data is shown via the All Products block, we’ve introduced a new UI within the block itself to customize content using: + +- Inner Blocks + +To help customers find products, we’ve introduced an initial batch of filtering blocks which work alongside the All Products Block specifically: + +- Filter by Price +- Filter by Attribute +- Active Filters + +**In order to have access to the new Product Blocks, you will need to have WordPress 5.3+ installed.** + +To test, you’ll want to add a new page or post and add each of the new blocks to that page. Some areas to focus on: + +- Blocks discoverability +- Add, edit, publish and delete block +- Block customization + +To test the Inner Blocks: + +- Add All Products Block +- Click on the pencil icon on the block to edit it +- Edit the blocks inside the preview + +Putting all the block together and test: + +- Add Columns Block +- Select the number of columns (for example, 2) +- You can now add different blocks to each column +- You can add All Products Block to the first column +- You can add filter blocks to the second column + +If you need more details about recent WooCommerce Blocks changes, visit [WC Blocks 2.5 Release Notes](https://woocommerce.wordpress.com/2019/11/19/wc-blocks-2-5-release-notes/). + +### New Onboarding Experience + +This release adds an a/b test to the setup wizard, which for 10% of users will allow opt-in to the new WooCommerce Admin onboarding experience. This allows us to test our changes, prior to launching for all new users next year. + +**Note that the new onboarding experience is available on sites running WordPress 5.3+.** + +For users in the test group, the WooCommerce Admin installation step is done before anything else, and the user is redirected to the new onboarding experience after install. + +To test: + +- Uninstall WooCommerce Admin plugin (if you have it installed); +- Go to `/wp-admin/admin.php?page=wc-setup` and try your luck with the a/b test logic. If you are part of the 90% that gets selected for the `a` (control) old version, you should just see the normal setup wizard with no changes as shown below: + +![](https://cldup.com/jhDZMAPt6C.png) + +- Update the `woocommerce_setup_ab_wc_admin_onboarding` option in your database to `b` to enable new onboarding experience. The easiest way to do that is by using the snippet that you can find [here](https://gist.github.com/justinshreve/6e945dcb4714134156aba1b3c7f086cf). You can implement the snippet using the [Code Snippets](https://en-gb.wordpress.org/plugins/code-snippets/) plugin; +- Go back to `/wp-admin/admin.php?page=wc-setup` - you should now see the new onboarding prompt screen that looks like this: + +![](https://cldup.com/5xcXhWbGs5.png) + +- Test the continue/skip link and make sure you can use the normal setup wizard; +- Go back to `/wp-admin/admin.php?page=wc-setup` once again, and click `Yes Please`; +- WooCommerce Admin should be installed, and you should be redirected to the start of the new onboarding experience. + +### Additional enhancements + +**1) Corrected the media element player initialization for product variation descriptions.** + +To test: + +- Create a product with a variation. +- Add an audio shortcode to the variation description - `[audio src="audio-source.mp3"]`. +- View the product page and select the variation. +- The play bar should be styled as shown below: + +![](https://cldup.com/sG5ulqv-u1.png) + +Note that if the bar is styled as shown below, something is not working correctly: + +![](https://cldup.com/-Qbp2bXCZe.png) + +**2) The refund of a manually added fee to order now shows the correct amount on the line item.** + +To test: + +- Place an order and manually add a fee to that order (note that in order to do that, you'd need to change the order status to `on hold` first and save it. Once done, you'd see an option to `Add items` to an order. After clicking on it, you'd be able to add a fee to an order ); +- Save the order with an added fee; +- Refund the product in the order and partially refund the fee; +- The refund shown on the fee should be the correct partial amount that was refunded. See screenshot below for an explanation: + +![](https://cldup.com/0MecXwjhNf.jpg) + +**3) Fix rounding issues/inconsistencies between cart page and order placed.** + +To test: + +Case 1: + +- Set tax to 7%, price inclusive of taxes and round at subtotal; +- Add 2 products with the following prices: $2 and $2.5; +- Complete order with a quantity 1 of $2 product and quantity 4 of $2.5 product. In the cart the total should be $12.00; +- Go to edit order in wp-admin. Click to recalculate total (order needs to be in `on hold` order status). Without this fix, the order total will change to $12.01. With this fix, it should stay at $12.00. + +Case 2: + +- Set tax to 20%, enabled on shipping as well, price inclusive of taxes and round at subtotal; +- Add a coupon for $5.00 flat cart discount; +- Add a product with price of $8.99; +- Add Flat Rate shipping for $7.99; +- Add the product (step 3), and apply the coupon (step 2) to the cart. Complete the order with Flat Rate shipping selected (after-tax it should be $9.59). The total in the cart should be $13.58; +- Go to wp-admin to edit the order. Set the status to `on hold` and click to recalculate total. Without this fix, the coupon amount will change to $4.16, but with this fix, the discount should stay at $4.17. + +Case 3: + +- Set tax to 20%, price inclusive of taxes, and round at subtotal; +- Add 5 products with the following prices: $498, $99, $248, $44 and $69; +- Add all these products in the cart and complete the order; +- On the order received page, without this fix the subtotal amount will be $957.99, but with this fix, it should be correctly set to $958. + +**4) Added hover icon on password input fields to briefly toggle input text visibility for browsers.** + +To test: + +- Logout of WooCommerce site (if logged in); +- Navigate to `My Account` page; +- Enter log in details; +- Click on the new "eye" visibility icon in the password input field; +- Make sure you can see the password. + +**5) MaxMind Geolocation Integration (added in WooCommerce 3.9 rc-3).** + +To test: + +In order to enable geolocation: + +- Navigate to `WooCommerce > Settings > General` +- Scroll to `General options` +- Next to `Default customer address`, choose `Geolocate` or `Geolocate (with page caching support)` + +To complete the process of enabling Geolocation, it is necessary to configure the MaxMind Geolocation Integration with a MaxMind License Key: + +1) Create an account on MaxMind: + +- To create an account on MaxMind Geolocation, navigate to [https://www.maxmind.com/en/geolite2/signup](https://www.maxmind.com/en/geolite2/signup); +- On the registration page, complete the form with your information such as name and company name. If you are not sure what to choose as `Industry` and `Intended use` fields you can fill as `eCommerce` and `Price localization` respectively; +- After submitting you’ll get an email in a few minutes with a link to set your password. Click on that link and set a password. + +2) Create a MaxMind License Key: + +- Now that you have an account on the MaxMind website, you can access the license key section at `https://www.maxmind.com/en/accounts/{your_account_number}/license-key`; +- Select `Generate new license key`; +- Next, fill in the form to generate a license key; +- Add a description (just as the name of your store); +- Choose `No` next to `Will this key be used for GeoIP Update?`; +- Select `Confirm`. + +You will be presented with a new key. Copy this key straight away as it will be shown only once. + +3) Add MaxMind Geolocation License Key to WooCommerce settings: + +- Navigate to `WooCommerce > Settings > Integration > WooCommerce MaxMind Geolocation`; +- Paste the license key; +- Select `Save changes`. + +Now your WooCommerce store is ready to geolocate customers. \ No newline at end of file