woocommerce / wc-smooth-generator
A smooth product, order, customer, and coupon generator for WooCommerce.
Installs: 18 245
Dependents: 0
Suggesters: 0
Security: 0
Stars: 310
Watchers: 100
Forks: 49
Open Issues: 11
Type:wordpress-plugin
Requires
- php: ^7.4 || ^8.0
- composer/installers: ~1.2
- fakerphp/faker: ^1.21.0
- jdenticon/jdenticon: ^0.10.0
- mbezhanov/faker-provider-collection: ^2.0.1
- psr/container: 1.0.0
- symfony/deprecation-contracts: ^2.2
Requires (Dev)
- dev-trunk
- 1.2.0
- 1.1.0
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.0-beta
- dev-tweak/set-paid-and-completed-dates
- dev-release-1.2.0
- dev-fix/131/coherent-users
- dev-fix/121/ui-batch-generation
- dev-add/batch-to-customer
- dev-add/batch-to-coupon
- dev-update/readme-installation
- dev-add/order-attribution-support
- dev-fix-consistent-versions
- dev-release-1.1.0
- dev-update/cli-docs
- dev-add/term-generator
- dev-add/coupon-readme
- dev-update/admin-notice
- dev-update/cli-elapsed-time
- dev-add/hpos-compat
- dev-try/high-performance
- dev-fix/97-email-sent-out-on-generation
- dev-22-07/lower-version-requirement
- dev-22-07/phpcs-ci-php7
- dev-22-07/phpcs-ci
- dev-prep/1.1.0
- dev-add_subscription_support
This package is auto-updated.
Last update: 2024-09-27 00:28:25 UTC
README
A super-smooth generator for products, orders, coupons, customers, and terms. WP-CLI is the preferred interface for using the plugin. There is also a WP Admin UI at Dashboard > Tools > WooCommerce Smooth Generator with (for now) more limited functionality.
Installation
- Download the latest release as a zip file from https://github.com/woocommerce/wc-smooth-generator/releases/
- Install in your WordPress site as you would any other plugin zip file.
WP-CLI Commands
You can see a summary of all available commands by running wp help wc generate
, and more detailed guidance for each individual command is available by running wp help wc generate <command name>
.
Products
Generate products based on the number of products parameter.
wp wc generate products <nr of products>
Generate products of the specified type. simple
or variable
.
wp wc generate products <nr of products> --type=simple
Orders
Generate orders from existing products based on the number of orders parameter, customers will also be generated to mimic guest checkout.
Generate orders for the current date
wp wc generate orders <nr of orders>
Generate orders with random dates between --date-start
and the current date.
wp wc generate orders <nr of orders> --date-start=2018-04-01
Generate orders with random dates between --date-start
and --date-end
.
wp wc generate orders <nr of orders> --date-start=2018-04-01 --date-end=2018-04-24
Generate orders with a specific status.
wp wc generate orders <nr of orders> --status=completed
Order Attribution
Order Attribution represents the origin of data for an order. By default, random values are generated and assigned to the order. Orders with a creation date before 2024-01-09 will not have attribution metadata added, as the feature was not available in WooCommerce at that time.
Skip order attribution meta data genereation.
wp wc generate orders <nr of orders> --skip-order-attribution
Coupons
Generate coupons based on the number of coupons parameter.
wp wc generate coupons <nr of coupons>
Generate coupons with a minimum discount amount.
wp wc generate coupons <nr of coupons> --min=5
Generate coupons with a maximum discount amount.
wp wc generate coupons <nr of coupons> --max=50
Customers
Generate customers based on the number of customers parameter.
wp wc generate customers <nr of customers>
Terms
Generate terms in the Product Categories taxonomy based on the number of terms parameter.
wp wc generate terms product_cat <nr of terms>
Generate hierarchical product categories with a maximum number of sub-levels.
wp wc generate terms product_cat <nr of terms> --max-depth=5
Generate product categories that are all child terms of an existing product category term.
wp wc generate terms product_cat <nr of terms> --parent=123
Generate terms in the Product Tags taxonomy based on the number of terms parameter.
wp wc generate terms product_tag <nr of terms>
Development
Requirements
- Node.js v16
- Composer v2+
- If you use Node Version Manager (nvm) you can run
nvm use
to ensure your current Node version is compatible. - Run
npm run setup
to get started. This will install a pre-commit Git hook that will lint changes to PHP files before they are committed. It uses the same phpcs ruleset that's used by WooCommerce Core.
Releasing a new version
- Create a new branch with a name like
release-x.x.x
. - Add a new entry to the changelog.txt file with all the changes since the last release. Follow the conventions of previous changelog entries.
- If necessary, update the
Tested up to
andWC tested up to
values in the plugin header in wc-smooth-generator.php. - Update the plugin version with the new value in the wc-smooth-generator.php and package.json files.
- Run
npm run build
to generate a production-ready zip file. - Test the zip file by installing it in a WordPress instance and ensuring it has the expected version number and changes.
- Commit the changes to your release branch, and push to the repository. Create a pull request from the release branch.
- Merge the pull request.
- In GitHub, go to the Releases screen and click "Draft a new release".
- Set the release title as "Version x.x.x" (but with the actual version number). In the release description, add a brief summary of highlights, and then paste the new changelog entry below that. From the "Choose a tag" dropdown, type the new version number and then click "Create a new tag". Ensure the target is trunk.
- Upload the new zip file to the release where it says "Attach binaries".
- Publish the release!
After finishing the release, you may want to run npm run setup
again, because the build
script removes dev dependencies.