Installation
Three ways to install. Pick whichever you're comfortable with.
What your site needs
| What | Minimum | Recommended |
|---|---|---|
| WordPress | 6.4 | Latest stable (6.8+) |
| WooCommerce | 8.0 | 9.x |
| PHP | 8.1 | 8.2 |
| MySQL / MariaDB | 5.7 / 10.4 | 8.0 / 10.6 |
| HTTPS | If your UnoPim is on HTTPS (recommended) | TLS 1.2+ |
Not sure if your site meets the requirements?
Open Tools → Site Health → Info in your WordPress admin. The PHP and database versions are listed there. If anything is below the minimum, ask your host to upgrade — most managed WooCommerce hosts will do this for free.
What you'll need before you start
- A working UnoPim instance — note its web address
- An UnoPim API client ID and client secret
- An UnoPim admin username and password
- A WordPress login as an administrator or shop manager
Method 1 — Upload through the WordPress admin (recommended)
- In your WordPress admin, go to Plugins → Add New → Upload Plugin.
- Click Choose File and pick the connector ZIP.
- Click Install Now.
- Click Activate Plugin.
A new menu UnoPim Configuration appears in the WordPress admin sidebar.
Method 2 — FTP or SFTP
- Unzip the connector on your computer.
- Upload the resulting
unopim-connectorfolder to your site'swp-content/plugins/directory. - In WordPress admin, open Plugins → Installed Plugins.
- Find UnoPim Connector and click Activate.
Method 3 — Hand the file to your developer
If your site is locked down or managed by an agency, send them the ZIP and ask them to install and activate it. They won't need any extra information from you.
What activation does
When you activate the connector for the first time, it sets itself up automatically:
- Creates the tables it needs to track your synced data
- Seeds safe defaults (dry-run is off, deletes go to trash, automatic sync is hourly)
- Tells WooCommerce it's compatible with the new high-performance order storage and block-based checkout
It does not contact UnoPim, change your products, or alter any of your existing data. You can safely activate first and configure later.
Quick check after activation
Open UnoPim Configuration in your WordPress admin sidebar. You should see:
- The Connection form with empty fields
- A red Not connected badge at the top of the page
- A second tab, Channels & Stores (it'll be empty until you save valid credentials)
If the menu doesn't appear, your user account doesn't have the right permissions. Sign in as an administrator or shop manager.
Updating the plugin
When a new version is available:
- Back up your site (your host usually has a one-click option).
- Replace the plugin folder, or upload the new ZIP and overwrite.
- Visit any WordPress admin page — the connector finishes its update automatically.
The connector never destroys data on update. Schema changes are additive.
Deactivating versus deleting
| Action | What's kept | What's removed |
|---|---|---|
| Deactivate | Everything — tables, mappings, logs | The connector stops running, and scheduled syncs pause |
| Delete (default) | Everything | Just the plugin code |
| Delete with "Remove data on uninstall" turned on | Nothing | Tables, mappings, logs — fully scrubbed |
The "remove data on uninstall" toggle lives in General Settings. Leave it off unless you really mean it.
Multisite
If you run a WordPress network, you can either network-activate the connector (it sets itself up on every site) or activate it per site. The channel-to-site mapping happens later, on the Channels & Stores tab. See Multisite.
Troubleshooting installation
| Symptom | Likely cause | Fix |
|---|---|---|
| "Plugin could not be activated…" | Your site is on an older PHP version | Ask your host to upgrade to PHP 8.1 or newer |
| Activation worked but no menu appears | Your account doesn't have the right permissions | Sign in as an administrator or shop manager |
| Activation worked but the Connection tab errors | WooCommerce isn't activated, or your site is missing standard security keys | Activate WooCommerce; ask your developer to add WordPress secret keys to wp-config.php |
More fixes in Troubleshooting.
