Guide — WooCommerce
A WordPress plugin: Action Scheduler jobs, HPOS-compatible orders, updates from the Wamia update server.
Requirements
- WordPress 6.4+, WooCommerce 8.6+ with HPOS enabled or compatible, PHP 8.1+.
- An HTTPS shop URL reachable from the internet (webhooks).
- WP-Cron or a system cron hitting
wp-cron.phpevery minute.
Install
- Install from the WordPress plugin directory, or upload the ZIP from the Downloads page under Plugins › Add New › Upload.
- Updates come from the Wamia update server (
/connect/wp-update) with signature verification; the WordPress updates screen shows them like any other plugin.
Connect the shop
- Wamia › Connect › Connect with Wamia opens the consent page; after approval the key is stored encrypted with the site salts.
- Without a browser round-trip, paste a pairing code from Wamia Shop instead.
First import
- Wamia › Import: filter by category or tag, map categories to Wamia families, preview (dry-run) and run; variable products become one proposal with variants.
- Images are passed by URL from the media library; Wamia copies them.
Daily operation
- Price and stock hooks enqueue bulk updates coalesced every 30 seconds.
- Wamia orders arrive as WooCommerce orders in status "Wamia – to prepare"; completing the order with tracking hands over the parcel.
- Held batches show as an admin notice with a link to the dashboard.
Troubleshooting
- Wamia › Status shows the last webhook, the queue depth and the API rate-limit headroom.
- Download a support bundle from the same screen before opening a ticket.