Skip to main content

WordPress · Installation

This guide covers the official neuroon-search v0.8.4 plugin (the one that adds semantic search, catalog sync and the embeddable widget). If you are looking for the AI agents plugin (UCP, Google Search AI Mode), that one is called neuroon-agentic-commerce v0.1.0 and is a separate product documented elsewhere.

Download the plugin​

The plugin is not listed on wordpress.org. We distribute it as a signed ZIP from the dashboard:

  1. Log in at neuroon.ai/dashboard (or dev.neuroon.ai/dashboard for Development).
  2. Pick your shop → Integrations → WordPress.
  3. Click Download plugin (.zip). You get neuroon-search-0.8.4.zip (the latest version available to your account).

Don't see the download? The option appears after you create the shop and issue your first Shop API Key. The ZIP is available on the Free tier too.

Requirements​

ComponentMinimum versionTested up to
WordPress5.86.7
PHP7.48.x
WooCommerce6.09.4
MySQL / MariaDB5.7 / 10.3—

Citation: fields Requires at least: 5.8, Requires PHP: 7.4, WC requires at least: 6.0, WC tested up to: 9.4 in .

You will also need:

  • A Shop API Key (format sk_…) generated from the Neuroon dashboard (Production or Development).
  • The Shop ID (shop_…) associated with that key.

Installation methods​

1. Download neuroon-search-0.8.4.zip from the dashboard.
2. wp-admin → Plugins → Add New → Upload Plugin.
3. Select the ZIP → Install Now → Activate.

Initial configuration​

  1. wp-admin → Settings → Neuroon Search opens the Settings tab.
  2. Paste your Shop API Key and, if you know it, the Shop ID. The key is stored in the neuroon_api_key option and the id in neuroon_shop_id.
  3. Click Verify Domain. The plugin sends POST /api/plugin/shops/verify with the current domain (get_site_url()) in the body and as the Origin header.
  4. If verification succeeds, the Products, Widget and Diagnostics tabs appear automatically (progressive disclosure).

Citation: handler admin_post_neuroon_verify in wordpress-plugin/neuroon-search/neuroon-verification.php and endpoint listed in wordpress-plugin/CLAUDE.md.

URL override for development​

To point the plugin at a local backend or at dev-api.neuroon.ai, define the constant in wp-config.php:

define('NEUROON_API_BASE_URL', 'https://dev-api.neuroon.ai/api');

If you do not define the constant and WP_DEBUG = true, you can override the URL from Settings → Neuroon Search → Developer Tools → API URL Override (option neuroon_dev_api_url). In production https://api.neuroon.ai/api is always used.

Citation: neuroon_get_api_url() in .

Constants defined by the plugin​

define('NEUROON_VERSION',          '0.8.4');
define('NEUROON_WIDGET_VERSION',   '0.9.10');
define('NEUROON_WIDGET_CDN_URL',   'https://cdn.neuroon.ai/widget@0.9.10');
define('NEUROON_WIDGET_SRI_HASH',  'sha384-JTaG/IN0Jj/ImfUj2x5QVMG4HkbFHzui7fTpLtwl1hsP+kY9W8OODeSJRFWN1ZP5');

Citation: .

The SRI hash is pinned to the widget.js binary published under that exact version on the CDN. When you upgrade to a new widget version, recompute the hash with:

curl -s https://cdn.neuroon.ai/widget@VERSION/widget.js \
  | openssl dgst -sha384 -binary | openssl base64 -A

and prefix it with sha384-.

Quick diagnostics​

After activating:

# Check connectivity with the API
curl -s "https://dev-api.neuroon.ai/api/plugin/shops/me" \
  -H "X-Shop-API-Key: $NEUROON_API_KEY" \
  -H "Origin: https://your-domain.example"

The response includes id, plan, maxProducts, productsCount, maxSearchesPerMonth, searchesThisMonth. If you receive 401, check the key. If you receive 403, the Origin does not match the domain registered in Neuroon.

Next steps​

Last updated on