WooCommerce integration

The official Skryx WooCommerce plugin is the fastest path to production on a WordPress + WooCommerce store. It handles:

• Catalogue sync — product create / update / delete fire automatically from WooCommerce hooks into Skryx, no cron jobs to maintain.
• Widget injection — the Skryx Search dropdown attaches to your theme's existing search input (most themes need zero config; a selector override is one click in plugin settings if needed).
• One-click OAuth — connect your WordPress install to Skryx without copy-pasting API keys between two admin panels.

# Install

# 1. Download

Download the latest plugin (.zip, ~35 KB). The same file is also available from the in-app Integrations page, where you can also see your live connection status.

# 2. Upload to WordPress

In your WordPress admin:

1. Plugins → Add New → Upload Plugin
2. Choose skryx-woo-1.3.2.zip
3. Click Install Now, then Activate

A new top-level Skryx menu appears in the WordPress sidebar.

# 3. Connect

Open Skryx → Connect to Skryx. You'll be redirected to log in to your Skryx account and approve the connection. On return, the plugin stores a public key automatically — no manual copy-paste.

The plugin's status panel will show Connected with the tenant name and the date of the connection.

# What gets synced

• Product title, description, short description, SKU, price, stock status, categories, tags, featured image, and product URL.
• Variations are flattened into the parent record (the search hit links to the parent's product page).
• Drafts, private products, and _yoast_wpseo_meta-robots-noindex flagged items are excluded by default.

Custom fields and ACF data can be added via the Skryx → Custom Attributes tab in the plugin settings.

# Widget placement

The plugin's widget injector looks for the first matching search input on every page using this selector:

.search-field:not(.adminbar-input),
input[name="s"]:not(.adminbar-input):not(#adminbar-search),
input[type="search"]:not(.adminbar-input):not(#adminbar-search)

The adminbar-input and #adminbar-search exclusions prevent the widget from attaching to the WordPress admin bar search (visible only to logged-in admins) instead of your theme's header search.

If your theme uses a non-standard search input markup, override the selector in Skryx → Settings → Widget Selector.

# Custom Attributes

By default the plugin syncs the standard WooCommerce product fields listed above. To include additional fields:

1. Open Skryx → Custom Attributes
2. Add the WooCommerce attribute (e.g. pa_brand) or post meta key (e.g. _my_custom_field) and the name it should have in your Skryx index (e.g. brand)
3. Save — the next sync will include the new field

Custom attributes become available as facets, filters, and ranking-rule conditions inside Skryx.

# Updating

When a new plugin version is released, the Skryx admin page shows an "Update available" notice with the changelog. Click Update now — the plugin will replace itself with the latest .zip from https://app.skryx.io/plugins/skryx-woo-latest.zip.

Your widget settings, OAuth connection, and custom attributes survive the upgrade.

# Uninstalling

Plugins → Installed Plugins → Skryx → Deactivate → Delete.

Deleting the plugin removes its options from the WordPress database but does NOT delete your data on the Skryx side — your indexes, keys, and analytics stay intact. To remove the Skryx-side data, visit your account settings on skryx.io.

# Troubleshooting

• Widget doesn't appear — the auto-attach selector didn't match. See Widget troubleshooting.
• Products don't sync — confirm WP cron is firing. The plugin enqueues a one-off sync job on activation; ongoing changes use the standard WooCommerce hooks.
• Connection lost — re-run Skryx → Connect to Skryx. OAuth tokens are long-lived but a manual revoke from skryx.io ends them.

Anything not covered here, email hello@skryx.io.