Updated Release Testing Instructions WooCommerce 6.5 (markdown)
Barry Hughes
parent
ca4a899eb8
commit
a36b439757
|
|
@ -38,4 +38,89 @@ Testing instructions for WooCommerce 6.5
|
|||
4. Go to **WooCommerce > Home** and finish the onboarding flow
|
||||
5. The new task list should be present (looking like this [picture](https://user-images.githubusercontent.com/2240960/157700720-ddc3e7b8-bb7f-4f37-89ad-17112ed619b1.png))
|
||||
6. Completed tasks should be crossed through and the copy updated to past tense (ex: `Set up payments` > `You set up payments`)
|
||||
7. Step through each task and make sure things update correctly and each task still works as expected.
|
||||
7. Step through each task and make sure things update correctly and each task still works as expected.
|
||||
|
||||
### Product Downloads > Approved Download Directories > New Installations
|
||||
|
||||
When testing this, you may wish to refer to [the documentation here](https://woocommerce.com/document/approved-download-directories/).
|
||||
|
||||
- Start with a brand new WordPress installation. Install and activate WooCommerce.
|
||||
- Give a bit of time for any related scheduled actions to run (wait until there are no more pending `woocommerce_download_dir_sync` actions listed in **Tools ▸ Scheduled Actions**, or manually trigger a few times until no pending actions remain).
|
||||
- Then, visit **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories**:
|
||||
- You should see two entries, both describing the `wp-content/uploads/woocommerce_uploads` directory.
|
||||
- One will be an `http://` or `https://` URL.
|
||||
- The other will be a `file://` URL (describing the same location, but as a filepath).
|
||||
- Since this was a brand new installation, the feature should already be enabled. You can tell it is enabled if the toggle button near the top of the screen reads `Stop Enforcing Rules`.
|
||||
- Still operating as an admin user:
|
||||
- Create a downloadable product and add a downloadable file with the URL `https://remote.location/test/file.pdf`.
|
||||
- Save the product, it should save successfully.
|
||||
- Return to **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories** and you should see an enabled rule for `https://remote.location/test/` has been added.
|
||||
- Now create a shop manager-level user and login as that user.
|
||||
- Edit the same downloadable product, or create a new one.
|
||||
- Add a new downloadable file with the URL `https://new.test/ebook.pdf`.
|
||||
- Save the product, you should see an error warning the file was in an unapproved location.
|
||||
- Log back in as site administrator and return to **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories**, you should see a new rule for `https://new.test/` has been added *but it should not be enabled.* Enable it.
|
||||
- Log back in as shop manager and try adding `https://new.test/ebook.pdf` a second time. Save the product: this time it should work.
|
||||
|
||||
### Product Downloads > Approved Download Directories > Existing Installations
|
||||
|
||||
*When testing this, you may wish to refer to [the documentation here](https://woocommerce.com/document/approved-download-directories/).*
|
||||
|
||||
- Start with WooCommerce 6.4.0 or earlier.
|
||||
- Populate the catalog with multiple downloadable products, supplying a diverse range of downloadable files for each. Try to use:
|
||||
- Local filepaths, like `/var/www/public_html/wp-content/ebook.pdf`.
|
||||
- Local URLs, like `https://example.com/wp-content/uploads/ebook.pdf`.
|
||||
- Remote URLs, like `https://external.site.com/storage-bucket/ebook.pdf`.
|
||||
- Sometimes upload files, other times specify the location 'manually'.
|
||||
- Acting as a customer, purchase some of those downloadable products, and ensure you can access your downloads.
|
||||
- Upgrade (to 6.5)!
|
||||
- Acting as a customer, confirm you can still access your downloads.
|
||||
- Allow time to elapse for synchronization of the product catalog and the new Approved Download Directory list to occur.
|
||||
- As described in earlier instructions, this happens via Action Scheduler.
|
||||
- As a site admin, you should see a message alerting you to the fact that the Approved Download Directory has been populated and should be reviewed.
|
||||
- Go ahead and navigate to **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories**:
|
||||
- The feature should not yet be enabled (and you should see a `Start Enforcing Rules` button to enable it).
|
||||
- Enable it, and enable all rules (use the `Enable All` button)
|
||||
- Acting as a customer, confirm you can still access your downloads.
|
||||
|
||||
### Product Downloads > Approved Download Directories > Customer Impact
|
||||
|
||||
*When testing this, you may wish to refer to [the documentation here](https://woocommerce.com/document/approved-download-directories/).*
|
||||
|
||||
- Building on the previous steps, visit the storefront as a logged in customer.
|
||||
- Purchase the downloadable product.
|
||||
- As an admin user or shop manager, complete the order.
|
||||
- As the logged in customer, visit **My Account ▸ Downloads**
|
||||
- Confirm you see the correct downloads (if you used fake paths like `https://new.test/ebook.pdf` then of course no file actually exists, so trying to download them will not work, *but they should still be listed).*
|
||||
- As an admin user, disable the corresponding rules via the **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories** screen.
|
||||
- As the customer, confirm those disabled downloads are no longer listed (it will say, _"No downloads available yet.")_
|
||||
- As the admin user, disable the entire feature from **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories** by clicking the `Stop Enforcing Rules` button.
|
||||
- As the customer, confirm all the expected downloads are once again listed within the **My Account ▸ Downloads** page.
|
||||
|
||||
### Product Downloads > Approved Download Directories > Imports
|
||||
|
||||
*When testing this, you may wish to refer to [the documentation here](https://woocommerce.com/document/approved-download-directories/).*
|
||||
|
||||
- Create a **new** *(important!)* test site, install WooCommerce.
|
||||
- Per earlier testing scenarios, on a new installation the Approved Download Directory functionality should already be enabled.
|
||||
- As a shop manager, import [our sample product CSV data](https://github.com/woocommerce/woocommerce/blob/6.3.1/plugins/woocommerce/sample-data/sample_products.csv) via **Products ▸ Import**.
|
||||
- This should work, except for the two downloadable products (they will be rejected because there are no matching Approved Download Directory rules).
|
||||
- As a site admin, visit **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories** and confirm you see an entry for `https://demo.woothemes.com/woocommerce/wp-content/uploads/sites/56/2017/08/` (it will not however be enabled).
|
||||
- Start again (it may be easiest to start again using a clean test site, ie via JN) and this time perform the CSV import as a full site admin.
|
||||
- The import should work and all products should be imported this time, *including* the two downloadable products.
|
||||
- Visit **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories** and you should see an entry for `https://demo.woothemes.com/woocommerce/wp-content/uploads/sites/56/2017/08/` (this time it should be enabled).
|
||||
|
||||
### Product Downloads > Approved Download Directories > Admin Tools
|
||||
|
||||
*When testing this, you may wish to refer to [the documentation here](https://woocommerce.com/document/approved-download-directories/).*
|
||||
|
||||
- With the feature enabled, manually create a number of entries for the Approved Download Directories list:
|
||||
- We will also need some downloadable products complete with downloadable files in the product catalog.
|
||||
- The easiest way to achieve this would be to log in as an admin user and start manually creating downloadable products with random download URLs (and corresponding rules will automatically be added to the Approved Download Directories list).
|
||||
- Confirm that you see a set of rules (URLs) within the **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories** screen.
|
||||
- Now visit **WooCommerce ▸ Status ▸ Tools**
|
||||
- Look for the **Empty the approved download directories list** tool and run it.
|
||||
- Return to **WooCommerce ▸ Settings ▸ Products ▸ Approved Download Directories** (or refresh if already open in another tab) and all rules should have been wiped.
|
||||
- Via the Tools page, now try running **Synchronize approved download directories**. After some time has elapsed, the Approved Download Directory list will again be populated according to the downloadable product paths in your product catalog.
|
||||
- This work happens via scheduled actions: so there could be a considerable delay.
|
||||
- If necessary, run the relevant actions manually: to do this, visit **Tools ▸ Scheduled Actions** and look for an action named `woocommerce_download_dir_sync` then run it. Usually, once this completes, a new action of the same name will be generated, so you will need to repeat this step until no further `woocommerce_download_dir_sync` actions are created.
|
||||
Loading…
Reference in New Issue