Dock for WooCommerce — Setup Guide

1. In WordPress admin, go to Plugins → Add New → Upload Plugin, choose the downloaded zip, install and activate.
2. Go to WooCommerce → Settings, open the Integration tab, and click Dock. You should see a settings screen titled Dock with five fields: Hub base URL, Tenant ID, Widget API key, Server secret and Webhook secret.
3. Enter your Tenant ID, Widget API key and Server secret — all three are ready to copy in your Dock workspace under Settings → Widget Integration. Leave Hub base URL at its default unless instructed otherwise.
4. Click Save changes at the bottom of the page. The test in the next step reads your saved settings only — testing before saving fails with "Dock tenant ID is not configured".
5. Click Test connection. It runs two separate checks and must report both Connected (the widget key, which reads your product catalogue) and Server secret OK (order access). If either fails, re-copy that credential from your Dock workspace, save again, and re-test.
6. Copy the webhook URL shown on that screen into Dock at Settings → Webhooks, paste the Dock-generated secret back into the plugin's Webhook secret field, and click Save changes again — this is how production status updates reach your orders.

Use WooCommerce → Dock Import to create a draft WooCommerce product for each merchandised product in your Dock catalogue (re-running it updates ones already imported). Review and publish the drafts you want to sell, then add the Dock Configurator block (or the [soloflo_configurator] shortcode) to each product page.

Customers pay through your own WooCommerce gateway (Stripe, PayPal, WooPayments…). When an order reaches Processing (successful payment on most gateways), the plugin submits the configured items to Dock. New orders then pass a review step in Dock before being released to production — they are not printed instantly.

If anything fails on the way to Dock, the WooCommerce order is put on hold with a note naming the problem, and you can use the Resubmit to Dock order action once it's fixed. Artwork issues found by preflight also appear as order notes.

• "Proceed to checkout" goes to the home page (or the wrong page) — two usual causes. A theme-bundled funnel plugin (for example CartFlows with "Store Checkout" enabled) overrides WooCommerce's checkout URL: deactivate the funnel plugin, or turn off its store-checkout override. And on fresh template sites the shop pages often ship unassigned: go to WooCommerce → Settings → Advanced → Page setup and make sure Cart page and Checkout page are set to the pages named Cart and Checkout.
• "Could not add to basket" — WooCommerce refuses to sell a product whose price field is blank, and imported Dock products currently arrive without one. Until the next plugin release: edit the product, and under Product data → General set Regular price to 0. The basket always charges the live configurator quote — never this placeholder.
• Checkout has no way to pay — a fresh store has no payment method enabled. Go to WooCommerce → Settings → Payments and enable at least one (Cash on delivery is fine for testing).

Email soloflo@solopress.com — include your store URL and, for order issues, the order number.