Saltar al contenido principal

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​

ComponenteVersión mínimaComprobada hasta
WordPress5.86.7
PHP7.48.x
WooCommerce6.09.4
MySQL / MariaDB5.7 / 10.3—

Necesitarás además:

  • Una Shop API Key (formato sk_…) 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.

Configuración inicial​

  1. wp-admin → Settings → Neuroon Search abre la pestaña Settings.
  2. Pega tu Shop API Key y, si lo conoces, el Shop ID. La key se guarda en la opción neuroon_api_key y el id en neuroon_shop_id.
  3. Pulsa Verify Domain. El plugin envía un POST /api/plugin/shops/verify con el dominio actual (get_site_url) en el body y como cabecera Origin.
  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-api.neuroon.ai, define la constante en wp-config.php:

define('NEUROON_API_BASE_URL', 'https://dev-api.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 (opción neuroon_dev_api_url). En producción siempre se usa https://api.neuroon.ai/api.

Constantes definidas por el 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');

El SRI hash está fijado al binario widget.js publicado bajo esa versión exacta en el CDN. Cuando subas a una nueva versión del widget, recalcula el hash con:

curl -s https://cdn.neuroon.ai/widget@VERSION/widget.js \
| openssl dgst -sha384 -binary | openssl base64 -A

y prefíjalo con sha384-.

Diagnóstico rápido​

Después de activar:

# Comprueba la conectividad con el 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"

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​

Última actualización en