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

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
• 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. Go to Settings > Neuroon in your WordPress admin
3. Enter your Neuroon API Key (found in your Neuroon dashboard)
4. Click “Activate” to verify your domain
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 demand. 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 – Product information (name, price, description, images, categories, stock status) 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)
• Conversion Events – Search-to-purchase mappings (only when conversion tracking consent is enabled)

When Data is Transmitted:

• During domain verification (when you click “Activate”)
• During product synchronization (initial sync and ongoing change detection)
• When customers search on your store (search queries are sent in real time)
• 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 when visitors interact with the search box on your store. 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. Search queries are processed in real time and are not stored beyond what is necessary to deliver results. 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.