Requirements
Active subscription and admin access to your WooCommerce account
An HTTPS WordPress address
WooCommerce 3.5+ and WordPress 4.4+
Wondersign subscription with access to Connectors or API ("Clicks" plan or higher)
Access to my.catalogkiosk.com using Google Chrome
You will also need to install a Media Library cleanup plugin in WordPress — see the Media Library Management section at the end of this article.
⚠️ Important: How the Connector Manages Your Store Data
The WooCommerce Connector manages tags, attributes, and categories globally. It will delete any tag, attribute, or category it did not create, including ones you added manually or through other third-party plugins.
If your store has an established taxonomy, review it before installing. There is currently no write-only mode that would leave your existing tags, attributes, and categories untouched.
Set Up WordPress and WooCommerce
1. Copy your WordPress Address.
Log in to your WordPress account. From your admin console, go to Settings > General. Copy the WordPress Address (URL) field, you will need this to Install the WooCommerce Connector.
Please Note: An HTTPS WordPress Address is required.
2. Create an API key in WooCommerce.
Go to the WooCommerce admin console and select Settings. Under the Advanced tab, click Create an API key.
3. Fill in the Key details:
Description: This doesn't affect how the Connector will work, it is to help you identify the API key you create.
User: The selected user must have an Administrator role.
Permissions: The permissions must be set to Read/Write.
Next, click Generate API Key.
Please Note: Products, categories, attributes, tags, and images created by the Connector will be traced to the API Key user.
4. Save your credentials immediately. ⚠️ IMPORTANT: DO NOT SKIP THIS STEP
An API key is generated. Copy the entire Consumer key and Consumer secret fields.
WooCommerce does not allow you to re-access or view this information later. Save your consumer key and consumer secret somewhere safe before closing or exiting this screen.
5. Set your Permalinks to a "pretty" structure.
Go to Settings > Permalinks and switch from the default "Plain" setting to what WordPress calls a "pretty" setting.
We recommend Post Name as the preferred Permalink structure. More information about the "pretty" Permalink structure can be found here.
This concludes the settings and setup inside the WordPress dashboard. Part 2 takes place in Wonder's Commerce Automation Manager (CAM) at my.catalogkiosk.com.
Installing The WooCommerce Connector
1. Open the Connectors page.
In your Wonder account at my.catalogkiosk.com, click your email address in the top right, then select Connectors from the drop-down menu.
2. Select the WooCommerce tile.
A popover window will display.
3. Enter your credentials.
Complete the form with the fields you copied from your WordPress and WooCommerce settings:
WordPress Address (URL)
Consumer key
Consumer secret
Click Verify & Continue.
4. Add your status alert recipients.
The Connector Settings page will display. Under Status Alerts, add the email address(es) where you would like to receive important notifications and alerts about your connector.
Click Create a Virtual Device to finish your setup.
5. Configure your Virtual Device.
Complete the required information:
Name: Name your new virtual device (e.g. "WooCommerce Store" or "My Website"). This is only visible to you and not to the consumer.
Address: Enter the address associated with your online store. In most cases this is your physical store address.
Timezone: Select a timezone for your virtual device.
Wonder Connector: Select your newly connected WooCommerce store from the drop-down menu.
Initialize settings from Device Group: Select the Device Group you would like to use for your virtual device's settings. This determines which catalog(s) and products are loaded into your online store.
Click Finish.
6. Confirm the installation.
When the installation is complete, you will be redirected back to the WooCommerce Connector page in the Commerce Automation Manager. The Connector will show as set up and running with a green checkmark.
What Happens Next
Configure your sync settings before your first sync completes.
To control how your catalog data maps into WooCommerce (including Category Hierarchy and Tag Management) click the WooCommerce connector tile and select the Sync Management tab in the left navigation.
Tag Management is ON by default, meaning Wonder will manage all product tags in your store. Review these settings before your catalog syncs.
Full instructions: How to Configure Your WooCommerce Virtual Device (Sync Management)
Sync timing. If the setup is successful, your device will begin syncing after 15 minutes. An initial sync may take hours depending on the catalog size.
Media Library Management
Every time the connector adds an image or video to a product or category, WooCommerce adds these assets to the WordPress Media Library.
When the connector deletes products and categories or removes their images and videos, WooCommerce does NOT delete them from the library. WooCommerce doesn't allow technical access to delete these assets from the Media Library.
To avoid filling the WordPress server with unnecessary and unused media, it is required to install a plugin app to manage and clean up the Media Library.
There are several plugins available. Please choose the one that best suits your WordPress and WooCommerce preferences and workflows.
Find a Plugin Here: https://wordpress.org/plugins/search/Media+Cleaner
