14 Release Testing Instructions WooCommerce 5.9

Tam Mullen edited this page 2021-10-24 23:23:55 +01:00

Table of Contents

• WooCommerce Admin Updates:
• Add country validation to subscription inclusion #7777
• Add status param support for dismissing all notes #7743
• Allow already installed marketing extensions to be activated #7740
• Assign parent order status as children order status if refund order #7253
• Check if onboarding is defined before finding themes #7818
• Parse low_stock_amount to int if it exists #7817
• WooCommerce Blocks Updates:
• Blocks 6.0.0
• Blocks 6.1.0
• WooCommerce Core Updates:
• Fix undefined variable notice when adding a product that doesn't exist in order #30739
• Use proper location for taxes when adding products via admin #30692
• Replace usage of "information_schema.tables" with "SHOW TABLES LIKE" #30745
• Setup the product attributes lookup table feature (prerequisite for testing)
• Sync the product attributes lookup table on product creation/change/deletion
• Include Customer VAT Exemption Status in Variable Product Price Cache Key #30889
• WooCommerce Marketplace Updates:
• Text to be displayed when invalid data is entered into search input field and no search results are found #30641
• Add ratings, reviews and icons into Marketplace's Product Cards #30840
• Reduce Storefront banner width #30882
• Revamp Featured page in WooCommerce Marketplace #30900
• In-App Marketplace Category Banners #30938
• Change name of transient for the new version of the in-app marketplace featured content #31002
• Add promoted card to in-App marketplace page #30861

WooCommerce 5.9 includes:

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

---

WooCommerce Admin Updates:

Add country validation to subscription inclusion #7777

Testing Instructions here

Add status param support for dismissing all notes #7743

1. On a fresh WC installation finish the Onboarding flow, make sure you install all the free extensions (important).
2. Go to WooCommerce > Home and scroll down to the notes
3. Click on Dismiss of one of the notes and click Dismiss all messages
4. Click Yes, I'm sure
5. Note that all notes should be removed and the empty inbox message should show up (see GIF as well)
6. Click undo on the little notice that pops up in the bottom left, and make sure all the notes appeared again.

Allow already installed marketing extensions to be activated #7740

1. Install one of the marketing extensions, but don't activate it.
2. Navigate to the marketing task in the task list.
3. Attempt to activate the plugin.
4. Note the successful activation.

Assign parent order status as children order status if refund order #7253

1. Complete the onboarding setup wizard.
2. Add some products.
3. Go to Shop page and purchase some products.
4. Go to WooCommerce->Orders.
5. Make a Refund for some orders.
6. Now go to Analytics->Revenue screen.
7. Note that Return amount is displayed.
8. Go to Analytics->Settings.
9. Select "Completed" for Excluded Statuses.
10. Click on Save settings.
11. Go to Analytics->Revenue and refresh the page.
12. "Returns" amount should get updated on the Revenue report screen

Check if onboarding is defined before finding themes #7818

1. On a new site install WooCommerce 5.8.0
2. Don't complete or start the OBW wizard
3. Switch to the latest version of WooCommerce 5.9.0 being tested.
4. Navigate to WooCommerce > Home
5. Make sure the page loads with task list, isn't blank, and there no JavaScript errors in the browser console.

Parse low_stock_amount to int if it exists #7817

1. Load WooCommerce and finish the onboarding
2. Create some products
3. Edit one of you products and go to Inventory tab and enable the Manage stock?, and set the Low stock threshold to 10, make sure Stock quantity is lower than the threshold
4. Go to WooCommerce > Home and hide the task list
5. Expand the Stock activity panel, the item should load correctly.

---

WooCommerce Blocks Updates:

Blocks 6.0.0

• Testing instructions

Blocks 6.1.0

• Testing instructions

---

WooCommerce Core Updates:

Fix undefined variable notice when adding a product that doesn't exist in order #30739

1. Make sure Query Monitor is installed.
2. Go to orders screen and add new order. wp-admin/edit.php?post_type=shop_order
3. Click on Add items. Then Add products.
4. Don't type anything in the search box and click on Add.
5. Ensure there are no PHP notices generated from that process.

Use proper location for taxes when adding products via admin #30692

** Instructions updated with those from the fix in #31015**

1. Install and activate Code Snippets plugin.
2. Add a new snippet with the following code: add_filter( 'woocommerce_adjust_non_base_location_prices', '__return_false' );
3. Make sure that you have the "Prices entered with tax" option set as "Yes, I will enter prices inclusive of tax" (WooCommerce - Settings - Tax - Tax options).
4. Let A be the country where your currently logged in user is based, and B the country where the shop is based. Create an user U based on a different country C.
5. Go to WooCommerce - Settings - Tax - Standard rates and set 30% for country A, 20% for country B and 10% for country C.
6. Create a simple product, taxable with standard rates, with a price of 110.
7. Create an order from admin area, don't set any customer for it and save it ("Create" button in "Order actions").
8. Add the product you just created to the order. You should see that the price that will appear in the line item is 91,67 (110 minus 20% of taxes), and if you click "Recalculate", the tax for country B is added and the final order price is 110.
9. Remove the line item from the order
10. Set U as the order customer and save the order ("Update" button in "Order actions").
11. Add the same product to the order again. This time the price that will appear in the line item is 100 (110 minus 10% of taxes), and if you click "Recalculate", the tax for country C is added and the final order price is again 110.

Replace usage of "information_schema.tables" with "SHOW TABLES LIKE" #30745

Setup the product attributes lookup table feature (prerequisite for testing)

1. Add the following snippet using the code snippets plugin:

add_action('woocommerce_init', function() {
    wc_get_container()
    ->get(\Automattic\WooCommerce\Internal\ProductAttributesLookup\LookupDataStore::class)
    ->show_feature();
});

2. Go to the WooCommerce - Status - Tools page. You will see a new tool with the title "Create and fill product attributes lookup table":

3. Click the "Create" button. After the page reloads you'll see that the button is disabled and shows a number corresponding to the number of products processed so far (the table is filled in increments using scheduled actions):

4. Remove the &action=regenerate_product_attributes_lookup_table part from the page URL and reload it until the button changes to "Regenerate" and is enabled again. At this point the table is ready for use.

5. Go to WooCommerce - Settings - Products - Advanced. Mark the "Use the product attributes lookup table for filtering" option and save.

Sync the product attributes lookup table on product creation/change/deletion

1. Setup some additional products, use this csv file https://raw.githubusercontent.com/woocommerce/woocommerce/dbac025535e29f5f67bdd96ba256ca4531662b4e/DATA_FOR_POC/FilterByAttributeUsingLookup_Products.csv
2. Trash a variable product
3. 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

4. Delete the lookup table (from the WooCommerce > Status > Tools page)

Include Customer VAT Exemption Status in Variable Product Price Cache Key #30889

1. Setup a variable product with taxes:

2. Set prices in the store to show including taxes:

3. Set up taxes for the site, it's the easiest to reproduce with just one tax rate for every location:

4. Use one logged in user and save a location as well as a matching VAT number in their account:

• Install EU VAT Number extension;
• Use one of the test VAT Numbers from the EU VAT Number Test Data. e.g. a valid Austrian VAT Number ATU66889218;
• Place order using this VAT number so the address and VAT number will be saved for the user and also to see if the VAT number is valid indeed:

Order placed:

5. View the shop page and you should now see the variable product with no tax (user is tax exempt):

6. In an incognito window view the same shop page and verify that the variable product is shown with taxes

7. Clear the transients in WooCommerce > Status > Tools:

8. Refresh the incognito window and see the variable product including taxes

9. Now refresh the shop page again for the logged in user and verify the variable product still shows without taxes

---

WooCommerce Marketplace Updates:

Text to be displayed when invalid data is entered into search input field and no search results are found #30641

1. Go to WooCommerce -> Marketplace.
2. Search for non existing product in search field.
3. Screen displays Sorry, could not find anything. Try searching again using a different term.

Add ratings, reviews and icons into Marketplace's Product Cards #30840

1. Go to WooCommerce > Marketplace
2. Search for "memberships"
3. Ensure you see products like WooCommerce Memberships that contain:
   • icon (instead of a product image),
   • developed by ... (with a link to a vendor page on WooCommerce.com)
   • average rating represented as stars
   • number of reviews left by customers

Reduce Storefront banner width #30882

1. Go to WooCommerce > Marketplace
2. Go to the bottom of the page
3. Confirm the Storefront banner isn't full width anymore and displays nicely
4. Confirm links to Storefront still work
5. Confirm the display is OK on large and small devices

Revamp Featured page in WooCommerce Marketplace #30900

1. Open WP Admin > WooCommerce > Marketplace page, make sure that you are viewing the "Featured" section

2. You should see something similar to the image below:

3. Try extensions search (e.g. via typing "memberships"), the page should look as expected

In-App Marketplace Category Banners #30938

1. Ensure your store country is set to US WooCommerce -> Settings
2. In WP-Admin visit WooCommerce -> Marketplace and verify products are still shown
3. Now navigate to the Payments category in WooCommerce -> Marketplace and verify the WC Payments banner is displayed above the products, if you have WC Payments installed it should not show so test with the plugin activated and deactivated.
4. Now navigate to the Shipping category in WooCommerce -> Marketplace and verify the WC Services banner is displayed above the products, if you have WC Services installed already it should not show so test with the plugin activated and deactivated.

Change name of transient for the new version of the in-app marketplace featured content #31002

1. On a new site install WooCommerce 5.8.0
2. Go to WooCommerce > Marketplace.
3. Notice the layout of the items on the page.
4. Switch to the latest version of WooCommerce 5.9.0 being tested.
5. Refresh the Marketplace page.
6. Note this loads the new layout of the page.

Add promoted card to in-App marketplace page #30861

1. View the Featured page of WooCommerce > Marketplace on your WooCommerce site wp-admin/admin.php?page=wc-addons&section=_featured.
2. In the Discover our favorites group you should see the two new styles of card shown in this screenshot:
3. View a category page like wp-admin/admin.php?page=wc-addons&section=marketing-extensions or search results page. You should see the two styles of card shown here at the top:

Contribution

• Set up development environment
• Our Git Flow
• SCSS and JS minification
• Naming conventions
• CSS SASS coding guidelines and naming conventions
• Critical Flows
• API Critical Flows
• String localisation guidelines
• Translating WooCommerce
• Deprecation in core
• Adding Actions and Filters
• Common Issues
• Writing high-quality testing instructions

Release Notes

• Release Testing Instructions
• 3.6.x notes/FAQ
• 2.6.x to 3.0.0 Developer Migration Notes
• Select2 fields not working in 3.0.x
• Thumbnail Image Regeneration in 3.3+
• Customizing image sizes in 3.3+

REST API and CLI

• Getting started with the REST API
• Contributing to the REST API
• WC CLI Overview
• WC CLI Commands

CRUD & Data Descriptions

• Database Description
• CRUD Objects in 3.0
• Order and Order Line Item Data
• Coupon Data
• Customer Data
• Product Data
• Data Stores

Internal APIs

• Settings API
• Payment Token API
• Shipping Method API
• WC_Queue - WooCommerce Queue API

Theming

• Enabling product gallery features (zoom, swipe, lightbox)
• Template File Guidelines for Devs and Theme Authors

Examples / Guides

• How Taxes Work in WooCommerce
• Customising account page tabs
• End-to-end Testing
• wc_get_orders and WC_Order_Query
• wc_get_products and WC_Product_Query
• Importer and Exporter
• Testing Action Scheduler
• Core Profiler Testing Instructions

WooCommerce is an open source commerce platform built for WordPress and lovingly crafted by Automattic and the WooCommerce community 💜. Come and work with us!