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

Component	Minimum version	Tested up to
WordPress	5.8	6.7
PHP	7.4	8.x
WooCommerce	6.0	9.4
MySQL / MariaDB	5.7 / 10.3	—

You will also need:

• A API Key (format Bearer token) 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.

The whole guide defaults to the Development environment (dev.neuroon.ai). When you are ready, switch to Production using the toggle at the top.

Initial configuration

1. wp-admin → Settings → Neuroon Search opens the Settings tab.
2. Paste your API Key and, if you know it, the Shop ID.
3. Click Verify Domain. The plugin verifies the current domain (get_site_url) automatically against Neuroon — no manual call needed.
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.neuroon.ai, define the constant in wp-config.php:

define('NEUROON_API_BASE_URL', 'https://dev.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. In production https://api.neuroon.ai/api is always used.

Quick diagnostics

After activating:

# Check connectivity with the API
curl -s "https://api.neuroon.ai/api/integrations/v1/shop" \
-H "Authorization: Bearer $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

• Domain verification — verify / unverify flow and common errors.
• Product sync — WooCommerce hooks, batches, latency.
• Cart bridge — how the plugin emits neuroon:cart-update.
• Admin dashboard — tabs, AJAX, capabilities.
• Recipe · WooCommerce end-to-end — full tutorial.