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.

Descargar el plugin​

El plugin no está publicado en wordpress.org. Lo distribuimos como ZIP firmado desde el dashboard:

  1. Entra en neuroon.ai/dashboard (o dev.neuroon.ai/dashboard si trabajas contra Development).
  2. Selecciona tu tienda → Integraciones → WordPress.
  3. Pulsa Descargar plugin (.zip). Obtendrás neuroon-search-0.8.4.zip (la última versión disponible para tu cuenta).

¿No ves la descarga? La opción aparece tras crear la tienda y emitir tu primera Shop API Key. Si tu plan es Free, el ZIP también está disponible.

Requisitos​

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

Cita: campos Requires at least: 5.8, Requires PHP: 7.4, WC requires at least: 6.0, WC tested up to: 9.4 en .

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

Cita: handler admin_post_neuroon_verify en wordpress-plugin/neuroon-search/neuroon-verification.php y endpoint en wordpress-plugin/CLAUDE.md.

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.

Cita: neuroon_get_api_url() en .

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');

Cita: .

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://dev-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