Neuroon Search

Neuroon Search is a SaaS connector plugin for WooCommerce. It enhances your store’s product search by sending product data to the Neuroon semantic-search service and rendering the results back on your site via a drop-in widget. It works similarly to other established WooCommerce search add-ons (e.g. Algolia for WooCommerce, Doofinder, Klevu, Searchanise).

The widget has two modes, and you choose which ones to enable: a fast search that shows instant results with filters as the shopper types, and a conversational sales assistant that understands what the shopper is looking for, recommends and compares products, assembles kits, answers questions about the catalogue and can add products to the WooCommerce cart when the shopper asks for it. The assistant always identifies itself as an AI system, and every cart change either follows an explicit request from the shopper or is offered as a proposal they confirm with one tap.

What this plugin is

• A client for the Neuroon hosted search service.
• A connector that synchronises your WooCommerce product catalog with Neuroon’s index so semantic search can return relevant products.
• A drop-in search widget that you embed on your store via shortcode, Gutenberg block, classic widget, Elementor widget, menu item, or seamless replacement of the WooCommerce native search.

What this plugin is NOT

• It is NOT a storefront / marketplace / installer plugin. It does NOT install plugins or themes from anywhere — neither from WordPress.org nor from any third-party source.
• It does NOT download executable code from external locations at runtime. The only external script it loads is the public search widget (widget.js) from Neuroon’s CDN (cdn.neuroon.ai), and that load is protected with Subresource Integrity (SRI hash pinned in the plugin’s PHP source). This is the same pattern used by Algolia for WooCommerce, Doofinder, Klevu Smart Search, Jetpack and many other approved plugins on this directory.
• It does NOT modify, replace or shadow any WordPress core or WooCommerce functionality beyond rendering the search widget where you ask it to.

This plugin requires a paid Neuroon subscription to function. Without an active subscription and API Key, the connector cannot send products to the service nor render search results. The plugin itself, including all its PHP source, is free and GPL-licensed.

Key Features

• Semantic Search Widget – Drop-in search bar that replaces default WooCommerce search with AI-powered results
• Conversational Sales Assistant – AI chat mode that recommends, compares and bundles products, answers catalogue questions and adds to the cart on request, with the cart drawer, free-shipping progress and cross-sell inside the widget
• Automatic Product Sync – Keeps your product catalog indexed and up to date with Neuroon’s search engine
• Drift Detection – Automatically detects product changes (price, stock, name) and re-syncs only what changed
• Batch Sync with Progress Tracking – Sync hundreds or thousands of products with real-time progress updates
• Auto-Retry Failed Products – Automatically retries products that failed to sync due to temporary errors
• Rate Limiting – Built-in API rate limit handling to prevent throttling
• Gutenberg Block & Shortcode – Add the search widget via Gutenberg block, shortcode, or classic widget
• Elementor Integration – Native Elementor widget for drag-and-drop placement
• WooCommerce HPOS Compatible – Fully compatible with High-Performance Order Storage
• Conversion Tracking – Track search-to-purchase conversions from your Neuroon dashboard
• Secure Token Authentication – Short-lived tokens for widget-to-API communication, no API key exposed to the browser

How It Works

1. Install and activate the plugin
2. Open the Neuroon Search menu in your WordPress admin (the setup wizard opens on first run)
3. Enter your Neuroon API Key (found in your Neuroon dashboard)
4. Click “Verify Key” to verify your domain and connect the store
5. Sync your WooCommerce products to Neuroon
6. Add the search widget to your site via Gutenberg block, shortcode, or widget area
7. Customers now search with natural language

Requirements

• WordPress 5.8 or higher
• WooCommerce 6.0 or higher
• PHP 7.4 or higher
• A paid Neuroon subscription (neuroon.ai)
• Your shop’s API Key (found in your Neuroon dashboard)

Support

• Documentation: https://docs.neuroon.ai
• Support: soporte@neuroon.ai
• Dashboard: https://neuroon.ai

Building from Source

This plugin is open source under GPLv2 (or later). All source code is bundled inside the ZIP.

Plugin source

All PHP code lives in includes/ and neuroon-verification.php. No build step is required.

Gutenberg block source

The Gutenberg search block is built with @wordpress/scripts. Source + build output ship together inside the ZIP:

• Source: includes/widget/gutenberg/src/ (JSX / JavaScript, readable)
• Build output: includes/widget/gutenberg/build/
• Build command: cd includes/widget/gutenberg && npm install && npm run build

Search widget (CDN)

The search widget JavaScript loads from cdn.neuroon.ai on the pages that render the widget. It is a proprietary Neuroon SaaS service (similar to Stripe.js, Google Analytics or Mailchimp) and is not bundled in the plugin. A Subresource Integrity (SRI) hash protects against tampering. See the “External Services” section below.

Third-party libraries

Bundled libraries are listed with versions and upstream URLs in assets/vendor/LICENSES.md.

External Services

This plugin connects to two Neuroon services. A paid Neuroon subscription is required for the plugin to function.

1. Neuroon API (https://api.neuroon.ai)

Provides AI-powered semantic search, product indexing, and conversion tracking.

Data Transmitted:

• Domain URL – Your website domain for verification
• Product Data – Name, price, main image, product URL, main category, stock, rating and review count, plus the description on the first send (fields configurable in the Settings tab) for search indexing
• API Key – Your shop’s API key for authentication
• Search Queries – Customer search queries to generate search results (when the search widget is active)
• Chat Messages – What the shopper writes to the sales assistant, the products they attach to a message and the assistant’s replies, to generate the answers (only when the assistant mode is enabled)
• Cart Contents – The current cart lines (products, quantities, prices) and the shipping destination country, sent while the assistant is helping with the cart so it can recommend and act on them
• Conversion Events – Search-to-purchase mappings (only when conversion tracking consent is enabled)

When Data is Transmitted:

• During domain verification (when you click “Verify Key” or “Connect to Neuroon”)
• During product synchronization (initial sync and ongoing change detection)
• When customers search on your store (search queries are sent in real time)
• When customers talk to the sales assistant (each message, in real time, together with the cart contents when the conversation involves the cart)
• When orders are placed (conversion events, only if conversion tracking is enabled)

2. Neuroon Widget CDN (https://cdn.neuroon.ai)

The search widget JavaScript is loaded from Neuroon’s CDN on the pages of your store that render the search widget. This pattern is similar to how Stripe.js, Google Analytics, or Mailchimp load their scripts from their respective CDNs.

• URL pattern: https://cdn.neuroon.ai/widget@VERSION/widget.js
• When loaded: Only on pages that render the search widget
• Integrity: Subresource Integrity (SRI) hash verification ensures the script cannot be tampered with
• Bundle policy: The widget is a proprietary service of Neuroon and is not bundled with this plugin. If the CDN is temporarily unavailable, the search widget shows an inline error message and the rest of the plugin (admin, sync) continues to work normally.

Service Links

• Neuroon Website: https://neuroon.ai
• Privacy Policy: https://neuroon.ai/privacy
• Terms of Service: https://neuroon.ai/terms

Data Processing

All data is transmitted securely via HTTPS. Product data is processed to generate search embeddings using AI models. Chat messages are processed by Neuroon with large language models, including third-party AI providers acting on Neuroon’s behalf as described in the Privacy Policy, and conversations are stored with the same identifiers as search queries. Search queries are processed in real time and are also stored by Neuroon, linked to your shop, to an anonymous visitor identifier and to the visitor’s IP address and browser user agent, so that the plugin and the Neuroon dashboard can show search analytics, the activity log and search-to-purchase attribution; they are kept for as long as your Neuroon shop account exists. The site administrator must explicitly authorize data processing during plugin activation, and this consent is recorded with timestamp. Conversion tracking is a separate optional consent and disabled by default. For complete details about how your data is handled, please review the Neuroon Privacy Policy.