Page:
Release Testing Instructions WooCommerce 6.1
Pages
3.6.x notes FAQ
API Critical Flows
Adding Actions and Filters
COT Upgrade Recipe Book
Common Issues
Contributing to the WooCommerce REST API
Core Profiler Testing Instructions
Critical Flows
Customizing image sizes in 3.3
Declaring WooCommerce support in themes
End to end Testing
Extra VVV Configurations
HPOS CLI commands
HPOS: new order querying APIs
High Performance Order Storage Upgrade Recipe Book
High perfromance Order Storage Upgrade Recipe Book
Home
How to set up WooCommerce development environment
Minification of SCSS and JS
Naming conventions
Puppeteer to Playwright Migration Guide for e2e Testing
Release Testing Instructions WooCommerce 3.8
Release Testing Instructions WooCommerce 3.9
Release Testing Instructions WooCommerce 4.0
Release Testing Instructions WooCommerce 4.1
Release Testing Instructions WooCommerce 4.2
Release Testing Instructions WooCommerce 4.3
Release Testing Instructions WooCommerce 4.4
Release Testing Instructions WooCommerce 4.5
Release Testing Instructions WooCommerce 4.6
Release Testing Instructions WooCommerce 4.7
Release Testing Instructions WooCommerce 4.8
Release Testing Instructions WooCommerce 4.9
Release Testing Instructions WooCommerce 5.0
Release Testing Instructions WooCommerce 5.1
Release Testing Instructions WooCommerce 5.2
Release Testing Instructions WooCommerce 5.3
Release Testing Instructions WooCommerce 5.4
Release Testing Instructions WooCommerce 5.5
Release Testing Instructions WooCommerce 5.6
Release Testing Instructions WooCommerce 5.7
Release Testing Instructions WooCommerce 5.8
Release Testing Instructions WooCommerce 5.9
Release Testing Instructions WooCommerce 6.0
Release Testing Instructions WooCommerce 6.1
Release Testing Instructions WooCommerce 6.2
Release Testing Instructions WooCommerce 6.3
Release Testing Instructions WooCommerce 6.4
Release Testing Instructions WooCommerce 6.5
Release Testing Instructions WooCommerce 6.6
Release Testing Instructions WooCommerce 6.7
Release Testing Instructions WooCommerce 6.8
Release Testing Instructions WooCommerce 6.9
Release Testing Instructions WooCommerce 7.0
Release Testing Instructions WooCommerce 7.1
Release Testing Instructions WooCommerce 7.2
Release Testing Instructions WooCommerce 7.3
Release Testing Instructions WooCommerce 7.4
Release Testing Instructions WooCommerce 7.5
Release Testing Instructions WooCommerce 7.6
Release Testing Instructions WooCommerce 7.7
Release Testing Instructions WooCommerce 7.8
Release Testing Instructions WooCommerce 7.9
Release Testing Instructions WooCommerce 8.0
Release Testing Instructions WooCommerce 8.1
Release Testing Instructions
Roadmap and release process
Select2 fields not working in 3.0.x
Structured data for products
Testing Action Scheduler
Testing Backlog
Testing the Core Profiler
Thumbnail Image Regeneration in 3.3
Translating WooCommerce
Upgrading the database using WP CLI
Using WP_DEBUG_LOG to log errors
WC_Queue WooCommerce Worker Queue
WooCommerce Git Flow
Writing high quality testing instructions
wc_get_orders and WC_Order_Query
wc_get_products and WC_Product_Query
13
Release Testing Instructions WooCommerce 6.1
Greg edited this page 2022-01-07 15:47:36 -07:00
Table of Contents
- WooCommerce Admin Updates:
- Inbox - Read notes
- Inbox - Dismiss single note
- Inbox - Activity menu
- Inbox - Dismiss all notes
- Onboarding Workflow - Add number of employees field
- The activity panel is not visible after hiding the setup task list #8109
- WooCommerce Blocks Updates:
- WooCommerce Core Updates:
- Make the setting's name for default customer location more accurately reflect the effect of it. #31383
- Fix errant stock adjustment when saving partially refunded orders. #31172
- Add support for Gutenberg 12.1.0 block template naming convention #31522
- WooCommerce API Updates:
WooCommerce 6.1 includes:
- WooCommerce Admin Updates
- WooCommerce Blocks Updates
- WooCommerce Core Updates
- WooCommerce API Updates
WooCommerce Admin Updates:
Smoke testing task list
- Make sure the task lists and all tasks are returned as expected
- Go to Products->Help (tab)->Setup Wizard
- Attempt to Disable/Enable the task lists and make sure these actions work as expected
- Smoke test the task list, viewing, snoozing, dismissing, and undoing those actions
Smoke testing Payment Methods
- Set up a store where WC Pay is not supported (ex: Brazil).
- Go to WooCommerce > Settings > Payments the payment method table should be displayed correctly without any blank rows
- Set your store address to a supported WC Pay country (Canada or USA)
- Go to the payment settings page and see if the promotion shows up now
- Add this filter to your theme or a test plugin, or using the Code Snippets plugin:
add_filter( 'woocommerce_allow_marketplace_suggestions', '__return_false' );
- Go to WooCommerce > Settings > Payments and notice how the WooCommerce Payment promotion is not displayed.
Inbox - Read notes
- Go to WooCommerce home screen
- Interact with a note by clicking on its title or action buttons.
- Return to the WooCommerce home screen
- See that the note is in a read state, with duller appearance.
Inbox - Dismiss single note
- Go to WooCommerce home screen
- Dismiss a single note using the "Dismiss" button when hovering over a note.
- See the "Message dismissed" notification.
- Click "Undo" on the notification.
- See the note returns to inbox.
- Dismiss the note again.
- Re-load the WooCommerce home screen.
- See that the note no longer appears.
Inbox - Activity menu
- Go to WooCommerce products screen
- On Menu bar, see that "Activity" menu item exists in top right corner.
- Click "Activity" menu item.
- See notes appear in panel.
Inbox - Dismiss all notes
- Go to WooCommerce home screen
- On "Inbox" heading panel, click kebab menu (3 dots).
- Click "Dismiss all".
- On confirmation dialog, press "Cancel" button.
- See that notes still remain.
- Dismall all notes again and press "Yes, dismiss all" on confirmation dialog.
- See that all notes are removed.
Onboarding Workflow - Add number of employees field
- Go to step 4 of the OBW (Business details).
- Under
Currently selling elsewhere?
select any option other than "No". - A drop-down list with the following options should be visible:
It's just me
<10
10-50
50-250
+250
I'd rather not say
- Select one of those options and fill out the rest of the options.
- Open the browser devtools, go to the
Console
and enable the debug messages. You can do this by runninglocalStorage.setItem( 'debug', 'wc-admin:*' );
in theConsole
and looking for the verbose console messages.
Make sure the debug
level is selected to be able to see the messages:
- Verify that the event
wcadmin_storeprofiler_store_business_details_continue_variant
is recorded with the propertynumber_employees
after pressingContinue
.
The activity panel is not visible after hiding the setup task list #8109
- Add a product.
- Create an order with the status:
processing
. - Hide the setup task list.
- The activity panel should still be visible.
WooCommerce Blocks Updates:
Blocks 6.4.0
Blocks 6.5.0
Blocks 6.6.0
WooCommerce Core Updates:
Make the setting's name for default customer location more accurately reflect the effect of it. #31383
- Go to WooCommerce > Settings and check the new string is present in the
Default customer location
section in the General settings section. Previously it wasShop base address
in the dropdown, now it should beShop country/region
. - Check that there is no change in the Tax section under
Calculate tax based on
dropdown (it should still sayShop base address
.
Fix errant stock adjustment when saving partially refunded orders. #31172
- Create an order for 2 products with set stock levels (products with manage stock enabled and an inventory quantity)
- Refund one of the products on the order and select the "restock refunded items" option.
- Notice the note is added confirming the stock has been restored.
- Update the order (click "update").
- Verify there is not a new note indicating the stock level has been reduced again.
- Verify the product inventory levels have not changed (beyond the restocking) by checking the product edit screen.
Add support for Gutenberg 12.1.0 block template naming convention #31522
Starting on WordPress 5.8:
- Install Gutenberg plugin and a block theme which is using the old template directory names such as TT1 Blocks.
- Check that the WC block templates render/are available in the Site Editor (under Appearance), and on the frontend.
- Activate a block theme which is using the new template directory names such as the latest version of Tove)
- Check that the WC block templates still render/are available in the Site Editor (under Appearance), and on the frontend.
Update to WordPress 5.9 and replicate the steps above with the Gutenberg plugin deactivated.
WooCommerce API Updates:
Fix taxes endpoint returning incorrect X-WP-Total and X-WP-TotalPages headers #30890
- On a previous version of WooCommerce, such as 6.0, create more than 10 tax rates
- Make an API call to list the existing tax rates:
GET {base_url}/wp-json/wc/v3/taxes
- Note that the headers
x-wp-total
always returns 10 andx-wp-totalpages
always returns 1 - Update to WooCommerce 6.1 and make the same API request
- Note that the headers
x-wp-total
now returns the number of tax rates you created andx-wp-totalpages
always returns the number of pages based on the number of tax rates (10 per page)
Consistently Store Coupon Data in Order Item Meta #31338
- Ensure you have a coupon you can apply to a new order
- Ensure you have a product you can add to the order
- Create a new order via the REST API (
POST https://example.com/wp-json/wc/v3/orders
):
{
"status": "on-hold",
"currency": "USD",
"payment_method": "cod",
"payment_method_title": "Cash on Delivery",
"line_items": [
{
"product_id": 5,
"quantity": 1
}
],
"coupon_lines": [
{
"code": "couponcode"
}
]
}
- Verify that the resulting order response has
meta_data
in thecoupon_lines
that contains data like:
"meta_data": [
{
"id": 2016,
"key": "coupon_data",
"value": {
"id": 130,
"code": "couponcode",
"amount": "7",
"date_created": {
"date": "2020-10-30 11:06:20.000000",
"timezone_type": 3,
"timezone": "Europe/Madrid"
},
"date_modified": {
"date": "2020-10-30 11:07:19.000000",
"timezone_type": 3,
"timezone": "Europe/Madrid"
},
"date_expires": null,
"discount_type": "percent",
"description": "",
"usage_count": 2,
"individual_use": false,
"product_ids": [],
"excluded_product_ids": [],
"usage_limit": 0,
"usage_limit_per_user": 0,
"limit_usage_to_x_items": null,
"free_shipping": false,
"product_categories": [],
"excluded_product_categories": [],
"exclude_sale_items": false,
"minimum_amount": "",
"maximum_amount": "",
"email_restrictions": [],
"virtual": false,
"meta_data": []
}
}
]
- Create a new order through the wp-admin dashboard (WooCommerce > Orders > Add Order)
- Add a product ("Add item(s)")
- Add a coupon ("Apply coupon")
- Retrieve the order from the REST API (
GET https://example.com/wp-json/wc/v3/orders/[ORDER_ID]
) - Verify the
coupon_lines
containsmeta_data
like the previous example
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
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
Theming
- Enabling product gallery features (zoom, swipe, lightbox)
- Template File Guidelines for Devs and Theme Authors
Examples / Guides
WooCommerce is an open source commerce platform built for WordPress and lovingly crafted by Automattic and the WooCommerce community 💜. Come and work with us!