Install on WooCommerce

RequirementsCopy Anchor Link

• WordPress: >=6.7 <=7.1 (PHP >=7.4)
• WooCommerce: >=9.6 <=11.2 (PHP >=7.4)
• Latest plugin version: 1.0.0

• HTTPS on the site, and the WordPress REST API reachable from the internet (security plugins must not block /wp-json/shopassist/v1/).
• WP-Cron or a system cron running (the plugin queues changes with Action Scheduler).
• A WordPress user with the manage_woocommerce capability.

InstallCopy Anchor Link

The plugin makes no call to ShopAssist before you click Connect. On multisite, network activation is supported; each subsite is connected separately and becomes its own ShopAssist store.

ConnectCopy Anchor Link

Recommended: in WooCommerce → ShopAssist, click Connect. You are sent to shopassist.coec.dk/connect/woocommerce, sign in or sign up, confirm the site address and choose or create the store. You are then sent back to WordPress, and the plugin finishes the connection with a one-time code and a proof key, so nothing secret passes through your browser.

Alternative: in the dashboard, Add store → WooCommerce → Generate pairing code, then paste the code in the plugin page. Codes are valid for 15 minutes.

If connecting fails, the plugin shows a short message with a link to the matching connection error, for example rest_blocked when a security plugin blocks the REST API.

VerifyCopy Anchor Link

• The plugin page shows "Connected" and the sync progress.
• The launcher appears on your storefront. It is never shown on the checkout, order-pay or order-received pages.
• In "coming soon" mode, only users who can manage WooCommerce see the widget.

Send a test message

Signed-in customersCopy Anchor Link

Signed-in customers are recognised automatically through the plugin's WC-AJAX identity endpoint (/?wc-ajax=shopassist_identity). It is a POST endpoint that page caches don't store.

See WooCommerce identity.

Stock per locationCopy Anchor Link

WooCommerce has no stock per location of its own. ShopAssist supports, in this order:

1. Stock Locations for WooCommerce: detected automatically; each location becomes a store with its own stock.
2. Meta mapping: map post meta keys that hold stock per location in the plugin settings.
3. A local inventory feed or the Catalog Push API: see product feeds and Catalog Push API.
4. CSV import in the dashboard (inventory CSV import).

Without any of these, the assistant says it doesn't know the stock in a specific store. Pickup locations from WooCommerce's local pickup are shown as addresses.

UpdatingCopy Anchor Link

Update from Plugins like any WordPress plugin, or enable auto-updates. The dashboard tells you when your plugin is more than two minor versions behind.

Uninstall and data removalCopy Anchor Link

• Deactivate pauses the store: the widget disappears, credentials and data are kept, and reactivating resumes it.
• Delete (uninstall) disconnects the store, removes the plugin's options, tables and scheduled actions on every subsite, and keeps order notes. ShopAssist deletes the store's data 30 days after uninstall unless you reconnect.

See uninstall and data removal.

TroubleshootingCopy Anchor Link

• Optimisation plugins (WP Rocket "Delay JavaScript", LiteSpeed, Autoptimize, Cloudflare Rocket Loader) must not delay or combine the ShopAssist script. The plugin adds data-cfasync="false"; add cdn.shopassist.coec.dk and shopassist to the exclusion list of your optimisation plugin.
• WP-Cron disabled and Action Scheduler lagging
• The widget is not showing
• Content Security Policy errors