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.

Requirements​

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

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).

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.

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');

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://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