WooCommerce
Connect a WordPress / WooCommerce store with the Konfiwear plugin, link products, enable add-to-cart and receive orders as quotes.
Where to find it
Settings → Settings → Integrations → WooCommerce card. Requires a Pro plan and a WordPress site with WooCommerce active, HTTPS and the REST API reachable.
Connect — with the plugin (recommended)
- On the WooCommerce card click Download plugin. The zip is generated for your workspace (it carries a one-time pairing token — don't reuse an old zip).
- In WordPress go to Plugins → Add New → Upload Plugin, upload the zip and Activate.
- The plugin creates its own REST API keys and pairs with Konfiwear automatically. Back in Konfiwear the card shows Connected with the store name, and an initial sync runs: your linked Konfiwear products are pushed and the WooCommerce catalog is pulled.
- The plugin also adds a Customize button, a tiered price table and the 3D viewer on single-product pages of linked products — no theme edits.
- A new Konfiwear menu appears in the WordPress sidebar, and a Konfiwear box on the WordPress Dashboard shows the connection, your counts and latest quotes. Settings controls the button (label, classes, style, placement), where the customizer opens, the product page, cart behavior and email links; Status & tools shows the connection and lets you reconnect.
The plugin also creates a Customize page on your store. The customizer opens inside it with your theme's header and menu, and the card shows the page's address under Plugin → Customizer page.
Update from plugin 1.x
Upload the new zip over the old plugin (WordPress asks to replace it) and open any WordPress admin page once. The plugin updates its own data, renews its connection to Konfiwear and creates the Customize page — you don't need to reconnect. Until then the card shows Plugin update required; if it stays after you've opened the admin, download a fresh zip from the card and upload it. A card showing A newer plugin version is available means you're connected but running an older 2.x build.
Connect — manually (fallback)
Use this only if your host blocks plugin uploads.
- In WordPress: WooCommerce → Settings → Advanced → REST API → Add key, permissions Read/Write. Copy the
ck_…andcs_…keys. - In Konfiwear click Connect manually, enter the store URL and both keys.
- Paste the provided
<script>snippet into your theme footer and create the bridge file as shown in the dialog (it captures the customizer's cart parameters into the order).
Link products
Two equivalent ways — both write the same link:
- From Konfiwear: open a Konfiwear product → Overview → WooCommerce mapping card → Link and pick the WooCommerce product (and variation if any). Use Re-sync on the integration card if the picker is empty.
- From WordPress (plugin 2.0+): edit the WooCommerce product and use the Konfiwear Product box under the product image. Pick the Konfiwear product, then Link (or Unlink). Products already linked to another WooCommerce product are greyed out. The box appears in the classic product editor and applies to the parent product; variations are linked from Konfiwear.
Linked products show a WC badge in the products list.
Cart & orders
- Set Settings → Global → Call to action → Mode = Cart. The storefront's button adds the configured item to the WooCommerce cart and redirects to it; price, size quantities and the design reference travel with the line item.
- Every WooCommerce order containing a Konfiwear line creates a quote in Leads → Quotes with a WooCommerce badge and the order number.
Volume pricing
Volume pricing is edited only in Konfiwear (product → pricing). With plugin 2.1+ the store mirrors it and applies it in the cart:
- Adding a linked product with the normal WooCommerce button uses the price of the tier that matches the cart quantity (for 20 pieces: the 11–25 tier price for every piece).
- A WooCommerce sale price wins while it is active.
- The WooCommerce regular price follows the first tier, and the product shows "From" the lowest tier price.
- Items customized in the customizer keep their own final price, and their quantity is locked in the cart by default because the price depends on it (Konfiwear → Settings → Cart & checkout).
- In the product editor, the Konfiwear tab under Product data shows the tiers (read-only), when they were last synced, Edit pricing in Konfiwear, Refresh pricing and a switch to turn Konfiwear pricing off for that product.
- If Konfiwear and the store use different currencies, tiers are not applied. Prices are not converted.
Changes you save in Konfiwear reach the store within seconds; the plugin also re-checks once a day.
Links in emails
Saved-design and quote emails send customers back to the store page they started from (your theme, header and menu stay around the customizer). The link falls back to the Konfiwear customizer page when the store can't be verified. To keep all email links on Konfiwear, turn off Allow Konfiwear emails to link to this store in the plugin's Links & emails tab.
Troubleshooting
| Symptom | Check |
|---|---|
| "Could not reach REST API" | /wp-json/ must return JSON. Permalinks ≠ Plain; disable "Disable REST API" security plugins; some hosts cache REST routes |
| 401 on connect | Key permissions must be Read/Write; regenerate keys |
| Add to cart does nothing | CTA mode is not Cart, or the product is not linked |
| "Wix integration is not connected" (or another platform) on Add to cart | Update the plugin to 2.1+. The customizer inside your store page always uses WooCommerce; disconnecting another platform takes effect immediately |
| Cart uses the regular price instead of the volume price | Check the product's Konfiwear tab (switch on, tiers present, Refresh pricing), that no sale price is active and that the currencies match |
| Old blue "Customize Now" button still shows | Update to plugin 2.1+ (hidden at render time) and run Re-sync on the card to clean stored descriptions |
| Order created but no quote | Webhooks blocked by a firewall; click Re-register webhooks on the card |
| Old widget after update | Update the Konfiwear plugin in WordPress; it cache-busts the storefront script |
| "Plugin update required" on the card | The store has no plugin connection yet: update to plugin 2.0+, open a WordPress admin page once, or reconnect with a fresh zip |
| "Konfiwear Product" box missing | It shows in the classic product editor only, for users who can manage WooCommerce; check Screen Options in case it's hidden |
| Customize opens Konfiwear instead of your store | Choose a published page under Konfiwear → Settings → Customizer page (a Customize page is created for you after connecting) |