Instalar en la tienda PrestaShop

El módulo, el handshake, la primera indexación y la activación del panel de búsqueda, en el orden correcto.

El módulo Buskara para PrestaShop hace tres cosas: conecta la tienda a su cuenta, mantiene el catálogo indexado, e inyecta el script del panel de búsqueda en las páginas. Instalar el módulo no cambia nada en la tienda: el panel de búsqueda solo aparece a los visitantes al final de esta guía, cuando el catálogo ya esté indexado.

1. La clave de API

La cuenta nace sin ninguna, y la primera aparece sola: justo después del registro, Buskara le lleva por tres pasos (descargar el módulo, copiar la clave, esperar a la tienda) y es en el segundo donde se emite y se muestra. Si cerró esa pantalla antes de copiarla, vuelva a /ativar y pida una nueva.

La clave completa (bk_live_…) aparece una sola vez: cópiela en ese momento. La lista muestra después solo el prefijo y cuándo se usó por última vez. Para emitir más (una por tienda, por ejemplo), abra el perfil de la cuenta en el panel, pestaña Integraciones.

Cada clave de la lista tiene tres destinos posibles. Revocar corta al momento todo lo que la estuviera usando, y tiene vuelta atrás: una clave revocada se reactiva en el botón de al lado, con el mismo valor de antes. Eliminar es lo que no tiene vuelta atrás, porque el valor no está guardado en ningún sitio; si elimina la clave que usa la tienda, emita otra y vuelva a pegarla en el módulo.

2. Instalar y conectar

1. Instale el módulo Buskara en el back-office de PrestaShop y abra la configuración.
2. Mientras la tienda no esté conectada, el módulo muestra una pantalla de bienvenida con dos campos: pegue ahí la clave de API y confirme la dirección de Buskara (https://buskara.com).
3. Pulse Conectar la tienda.

El módulo no genera claves ni se las inventa: recibe la que emitió su cuenta. Quien instale el módulo antes de tener cuenta encuentra en esa misma pantalla el botón para crearla.

Este último clic es el handshake: la tienda se presenta (URL, versiones, tiendas, idiomas y monedas) y recibe de vuelta su identificador, la clave pública de búsqueda y un motor de búsqueda por tienda × idioma × moneda. Es en este momento cuando la tienda aparece en el panel, en Búsqueda → Tiendas; no hay nada que crear a mano. Y es a partir de aquí cuando la configuración del módulo muestra todo lo demás: estado, indexación, apariencia y datos compartidos.

El número de tiendas conectadas es un límite del plan. Si el handshake se rechaza por eso, el mensaje dice el plan y el límite; volver a conectar una tienda que ya existe nunca se bloquea.

3. La primera indexación

Haga clic en Reindexar todo en el módulo. El catálogo sale en lotes, y en el panel (Búsqueda → Tiendas) ve el progreso: En cola, Indexando… (enviados / total) y por fin Al día, con el total de documentos.

En un catálogo grande, el botón puede chocar con el tiempo máximo de ejecución de PHP. Para esos casos el módulo trae una alternativa por línea de comandos, que no tiene ese límite:

php modules/buskara/cli/reindex.php

Después de la primera indexación completa, el día a día se resuelve solo por tres vías:

• Tiempo real: guardar, eliminar o cambiar el stock de un producto empuja el cambio al momento.
• Sincronización periódica: la plataforma pide la reindexación a la tienda en ciclos regulares. Para eso, la dirección https://su-tienda/module/buskara/sync tiene que estar accesible desde fuera; ojo con los cortafuegos y el basic-auth en tiendas de preproducción.
• Manual: el botón o el CLI, cuando quieras forzarlo.

4. Probar sin enseñárselo a nadie

Antes de activar el panel de búsqueda para todos, use la caja IPs de depuración del módulo: con su IP ahí dentro, solo usted recibe el panel de búsqueda, y puede probar en la tienda en producción a sus anchas.

Lo inverso es importante: mientras haya IPs en esa caja, nadie más recibe el panel de búsqueda. Si un día "la búsqueda ha desaparecido de la tienda", este es el primer sitio donde mirar.

5. Activar el panel de búsqueda

La primera indexación completa que ponga productos en el índice activa el panel de búsqueda por sí sola. A partir de ese momento, cada página de la tienda carga una única etiqueta de script, y la búsqueda pasa a ser la de Buskara: la barra del tema sigue en su sitio, pero quien responde somos nosotros.

Hasta entonces el interruptor del panel de búsqueda está apagado a propósito. Activarlo con el índice aún vacío daría a sus clientes una búsqueda que no encuentra nada, que es peor que no tenerla. El interruptor se queda en la configuración del módulo, y es suyo: si lo apaga, apagado se queda, y ninguna indexación posterior lo vuelve a activar sin usted.

Si el selector por defecto (input[name='s']) no atrapa la barra de su tema, ajuste el selector de la barra de búsqueda. En temas con búsqueda propia en el móvil, es normal que haga falta rellenar también los selectores de botones que abren la búsqueda y ocultar durante la búsqueda; eso se afina en la ficha de la tienda en el panel, y está explicado en la guía de apariencia e integración en el tema.

Las demás opciones del módulo

• Precios con IVA y tamaño de imagen: cómo llegan los productos al índice.
• Productos sin stock: indexarlos igualmente, bajarlos en los resultados, u ocultarlos.
• Datos que la tienda comparte: tres señales opcionales que mejoran el producto. El volumen de ventas por producto alimenta la ordenación "más vendidos" y la detección de best-sellers invisibles; el precio de coste da márgenes en la analítica; los pedidos conectan la búsqueda con los ingresos (ver la guía de analítica). Cambiar el compartir de ventas o de coste pide una reindexación completa para que el índice lo refleje; el módulo avisa.
• Artículos y contenido: indexar también el blog/CMS en un motor separado, que aparece en los resultados sin robarle el sitio a los productos.
• Estrellas: de dónde vienen las valoraciones que se muestran en las tarjetas (detección automática de los módulos habituales).

Si algo sale mal

• La tienda no aparece en el panel: el handshake ha fallado. Confirme el endpoint, la clave (sin espacios de más) y vuelva a Conectar a Buskara.
• "Indexando" no llega nunca al final: use el CLI; el botón choca con el tiempo de ejecución de PHP en catálogos grandes.
• El panel de búsqueda no aparece: en este orden, ¿el interruptor del panel de búsqueda está activado? ¿La caja de IPs de depuración está vacía? ¿La tienda está Activa (y no En pausa) en el panel de Buskara?
• El panel de búsqueda aparece pero la barra del tema sigue respondiendo: el selector de la barra no está atrapando el input correcto; inspeccione el tema y ajústelo.

Desinstalar el módulo borra toda la configuración local. El índice del lado de Buskara se queda; es la tienda la que deja de alimentarlo.