Installation
Step 1 — Verify prerequisites
| Requirement | Minimum |
|---|---|
| PHP | 7.4 (8.0+ recommended) |
| WordPress | 6.0 |
| WooCommerce | 8.0 (tested up to 9.6) |
| MySQL / MariaDB | MySQL 5.7 / MariaDB 10.3 |
| Memory limit | 256 MB |
| HTTPS | Strongly recommended |
WooCommerce must be active before activating Auctions for WooCommerce — the plugin declares Requires Plugins: woocommerce in its header.
Step 2 — Upload the plugin
Option A: WordPress admin (recommended)
- Go to Plugins → Add New → Upload Plugin
- Choose
auctions-for-woocommerce.zip - Click Install Now, then Activate
Option B: SFTP / SSH
- Unzip
auctions-for-woocommerce.ziplocally - Upload the
auctions-for-woocommerce/folder towp-content/plugins/ - Go to Plugins in admin and click Activate next to Auctions for WooCommerce
Step 3 — License activation
After activation, a one-time popup asks for your purchase code (Envato / Webkul Store).
Development / staging
If you're running a local or staging environment and need to skip the license check, ask Webkul support how to enable dev mode for your environment.
Step 4 — Verify activation
On activation the plugin:
- Creates the auction database tables
- Registers the auction WooCommerce product type
- Adds the Auctions menu under WooCommerce → Webkul Addons
- Schedules its background workers (auction lifecycle, audit log retention, payouts)
- Declares HPOS and Cart / Checkout Blocks compatibility
Confirm by visiting WooCommerce → Webkul Addons → Auctions Dashboard — you should see the dashboard shell with zero values.
Step 5 — Permalinks flush
The plugin registers three new My-Account endpoints (my-auctions, my_wallet, wkwc_withdrawal). After activation, flush rewrite rules:
- Go to Settings → Permalinks
- Click Save Changes (no changes needed — just save)
This is the only manual step required after activation.
Step 6 — Test an existing flow
- Visit My Account while logged in as a customer
- Confirm three new tabs appear: My Auctions, My Wallet, Withdrawal
- Click each — they should render without errors
If any tab returns a 404, the permalink flush in Step 5 didn't take. Re-save permalinks.
Updating
Updates ship through the standard WordPress update channel — when a new version is available you'll see the usual update available notice on the Plugins page.
Always back up the database before updating — schema migrations run automatically on the first admin request after the new version activates.
Deactivating / uninstalling
- Deactivate removes the menu and stops the background workers — your database tables and data are preserved.
- Uninstall (delete the plugin) does not drop the auction tables by default. If you need to fully purge auction data, use Tools → Maintenance → Reset all auction data before deleting the plugin.
Troubleshooting installation
| Symptom | Fix |
|---|---|
| Plugin won't activate | Make sure WooCommerce is active first |
| 404 on My Account tabs | Resave permalinks (Step 5) |
| Tables not created | Confirm the WordPress database user has CREATE / ALTER privileges, then deactivate and reactivate |
| License popup keeps appearing | Clear the browser cache or contact Webkul support for a dev-environment workaround |
| Fatal error on activation | Check the PHP version (7.4+) and raise the memory limit to 256M |
For more, see Troubleshooting.
