WordPress · Instalación

Esta guía cubre el plugin oficial neuroon-search v0.8.4 (el que añade búsqueda semántica, sync de catálogo y widget embebible). Si buscas el plugin para agentes de IA (UCP, Google Search AI Mode), ése se llama neuroon-agentic-commerce v0.1.0 y es un producto separado que se documenta aparte.

Requisitos

Componente	Versión mínima	Comprobada hasta
WordPress	5.8	6.7
PHP	7.4	8.x
WooCommerce	6.0	9.4
MySQL / MariaDB	5.7 / 10.3	—

Necesitarás además:

• Una API Key (formato Bearer token) generada desde el dashboard de Neuroon (Production o Development).
• El Shop ID (shop_…) asociado a esa key.

Métodos de instalación

1. Descarga neuroon-search-0.8.4.zip desde el dashboard.
2. wp-admin → Plugins → Add New → Upload Plugin.
3. Selecciona el ZIP → Install Now → Activate.

Toda la guía usa por defecto el entorno Development (dev.neuroon.ai). Cuando estés listo, conmuta a Production con el switch superior.

Configuración inicial

1. wp-admin → Settings → Neuroon Search abre la pestaña Settings.
2. Pega tu API Key y, si lo conoces, el Shop ID.
3. Pulsa Verify Domain. El plugin verifica el dominio actual (get_site_url) automáticamente contra Neuroon — no necesitas hacer ninguna llamada manual.
4. Si la verificación tiene éxito, las pestañas Products, Widget y Diagnostics aparecerán automáticamente (progressive disclosure).

Override de URL para desarrollo

Para apuntar el plugin a un backend local o a dev.neuroon.ai, define la constante en wp-config.php:

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

Si no defines la constante y WP_DEBUG = true, podrás sobreescribir la URL desde Settings → Neuroon Search → Developer Tools → API URL Override. En producción siempre se usa https://api.neuroon.ai/api.

Diagnóstico rápido

Después de activar:

# Comprueba la conectividad con el API
curl -s "https://api.neuroon.ai/api/integrations/v1/shop" \
-H "Authorization: Bearer $NEUROON_API_KEY" \
-H "Origin: https://your-domain.example"

La respuesta incluye id, plan, maxProducts, productsCount, maxSearchesPerMonth, searchesThisMonth. Si recibes 401, revisa la key. Si recibes 403, el Origin no coincide con el dominio registrado en Neuroon.

Próximos pasos

• Verificación de dominio — flujo verify / unverify y errores frecuentes.
• Sync de productos — hooks WooCommerce, batches, latencia.
• Cart bridge — cómo el plugin emite neuroon:cart-update.
• Admin dashboard — tabs, AJAX, capabilities.
• Recipe · WooCommerce end-to-end — tutorial completo.