Módulo de búsqueda para PrestaShop, y el tema ni se entera

En resumen

• El módulo hace tres cosas: conecta la tienda a la cuenta, mantiene el catálogo indexado, e inyecta una etiqueta de script. No cambia el tema ni la estructura del catálogo.
• La barra de búsqueda del tema se queda donde está. Cambia quién le responde, y eso es una línea de configuración, no un rediseño.
• Instalar no cambia nada para los visitantes. El layer solo aparece cuando se activa, y se puede probar en producción solo para una dirección IP.
• Compatible con PrestaShop 1.7.6 y superior, incluidas la línea 8 y la línea 9.
• Desinstalar limpia la configuración local y devuelve la búsqueda a la plataforma. No hay nada atrapado.

Instalar un módulo de búsqueda en PrestaShop tiene mala fama, y con razón. Suele implicar tocar el tema, aprender un lenguaje de plantillas que no es el de la plataforma, y descubrir tres meses después que una actualización ha roto la integración.

El módulo de Buskara se diseñó para no ser eso. Sustituye la búsqueda de PrestaShop sin tocar un solo archivo del tema, y este artículo explica qué hace, qué no toca, y qué cambia una vez activado.

Qué hace el módulo de búsqueda, y qué no toca

Tres cosas, y nada más:

1. Conecta la tienda a la cuenta. Un clic en Conectar a Buskara y la tienda se presenta: dirección, versiones, tiendas, idiomas y monedas. Recibe de vuelta su identificador y un motor de búsqueda por cada combinación de tienda, idioma y moneda. No hay nada que crear a mano de este lado.
2. Mantiene el catálogo indexado. Guardar, eliminar o cambiar el stock de un producto empuja el cambio al momento. Además de eso hay una sincronización periódica y un botón de reindexación completa.
3. Inyecta una etiqueta de script. Una sola, en cada página, y solo cuando el interruptor del layer está activado.

Lo que se queda exactamente como estaba importa tanto como lo que cambia:

La barra de búsqueda del tema de PrestaShop no se sustituye ni se mueve. Sigue en el mismo sitio, con el mismo aspecto; lo que cambia es quién responde cuando alguien escribe en ella. Si el selector por defecto no atrapa la barra de un tema menos convencional, se ajusta en un campo de texto, y el asunto está tratado en apariencia e integración en el tema.

La búsqueda que viene con PrestaShop

Antes de decir qué cambia, conviene ser justo con lo que ya está ahí, y la mejor fuente para eso es la documentación de la propia plataforma.

La búsqueda nativa de PrestaShop es un índice de palabras que se configura en Parámetros de la tienda. La documentación oficial describe las piezas: se define la longitud mínima de las palabras que entran en el índice, se recomienda limitar la longitud máxima a 15 caracteres para que la búsqueda aproximada se mantenga rápida, y el índice puede reconstruirse desde el back-office cuando las cuentas no cuadran.

Para las erratas, la plataforma ofrece alias: una lista donde se escribe la palabra con error y la palabra correcta a la que debe apuntar. Es una solución honesta y funciona. Lo que pide es que alguien se acuerde de cada error antes de que un cliente lo cometa.

Ahí está la diferencia de fondo, y no es una cuestión de calidad de código:

La última fila es la más importante de la tabla y no se debe esconder. La búsqueda nativa no cuesta nada y, en una tienda con doscientos productos y un vocabulario estable, suele bastar perfectamente. El caso para cambiarla aparece cuando el catálogo crece, cuando el vocabulario del cliente se aleja del vocabulario del proveedor, o cuando nadie tiene tiempo de mantener una lista de alias.

Qué cambia para quien compra

La parte visible se describe en dos líneas: la búsqueda responde mientras escribes, y responde a más cosas.

Se escribe mal y se encuentra igual. La tolerancia a las erratas es automática y proporcional a la longitud de la palabra, lo que evita el problema clásico de corregir de más: «taza» y «tapa» distan una letra y no son la misma búsqueda, por eso en palabras cortas no se tolera nada. La mecánica está en por qué la corrección de erratas no puede ser silenciosa.

Se describe en vez de nombrar. «Algo para colgar bicicletas en el garaje» no tiene ninguna palabra en común con la ficha del producto. Es la categoría de búsqueda que los catálogos sirven peor: en el benchmark de búsqueda del Baymard Institute, el 43% de los sitios evaluados tiene problemas con las búsquedas por caso de uso y el 39% con las búsquedas por característica.

Se pregunta por lo que no es producto. «Cuánto tarda el envío» se escribe en la caja de búsqueda con mucha más frecuencia de lo que se imagina, y con el contenido de la tienda indexado la respuesta aparece en los resultados, en un bloque aparte que no les roba sitio a los productos.

La columna de filtros sale de la búsqueda y no de la categoría. Una búsqueda cuyos resultados tienen color y talla gana esas casillas; una en la que ningún resultado tiene color no las muestra. El razonamiento está en demasiados filtros son el sitio donde muere la venta.

Qué cambia para quien gestiona la tienda

Esta es la mitad que no aparece en las capturas de pantalla y es la que decide si un módulo de búsqueda vale lo que cuesta.

La búsqueda pasa a producir una lista de trabajo. Los términos que volvieron vacíos aparecen clasificados por tipo de problema y ordenados por la estimación de lo que se recupera al mes, y cada uno trae la acción al lado: un sinónimo, un campo del producto por corregir, una decisión de compras. Es el asunto de las búsquedas sin resultados son la lista de la compra que nadie lee.

Hay también tres señales opcionales que la tienda puede compartir, y que cambian lo que el panel es capaz de decir:

• el volumen de ventas por producto, que alimenta la ordenación por más vendidos y la detección de productos que venden bien pero nunca aparecen en los resultados;
• el precio de coste, que pone márgenes en la analítica en vez de solo ingresos;
• los pedidos, que conectan la búsqueda con los ingresos atribuidos.

Ninguna de estas señales es obligatoria, y el compartir se activa y se desactiva en la configuración del módulo. Cambiar la de ventas o la de coste pide una reindexación completa, y el módulo avisa cuando es el caso.

Instalar el módulo de búsqueda en PrestaShop

Los pasos exactos están en la guía de instalación, y no vale la pena duplicarlos aquí. Lo que sí vale la pena es la forma, porque es ella la que responde a la pregunta que todo el mundo hace primero, que es cuánto riesgo tiene esto.

1. Emitir una clave de API en el panel. Aparece una sola vez, y es revocable sin ser eliminada, lo que significa que un despiste se deshace. Ver clave de API.
2. Instalar el módulo y pegar la clave. Instalar no cambia nada para los visitantes.
3. Reindexar. En catálogos grandes el botón puede chocar con el tiempo máximo de ejecución de PHP, y para esos casos hay un comando de línea que no tiene ese límite. Ver cómo se indexa el catálogo y reindexar el catálogo.
4. Probarlo tú solo. La caja de IPs de depuración hace que el layer aparezca solo a quien esté en la lista, lo que permite probar en la tienda en producción sin que nadie se entere.
5. Activar el layer cuando esté todo a tu gusto.

El punto cuatro es el que suele sorprender para bien, y tiene un reverso que conviene saberse de memoria: mientras haya direcciones en esa caja, nadie más recibe el layer. Si un día la búsqueda parece haber desaparecido de la tienda, es el primer sitio donde mirar.

Pros y contras de cambiar la búsqueda nativa de PrestaShop

La primera fila de la columna de la derecha es la objeción seria, y no tiene respuesta que la anule. La respuesta posible es la de la última fila de la izquierda: la salida está siempre ahí, desinstalar limpia la configuración local y la búsqueda vuelve a ser la de la plataforma en esa misma hora.

Versiones de PrestaShop compatibles

El módulo de búsqueda declara compatibilidad a partir de PrestaShop 1.7.6.0 y sin límite superior fijo, lo que incluye la línea 8 y la línea 9. No exige un tema concreto ni obliga a migrar de versión.

En temas con búsqueda propia en el móvil, es normal que haga falta indicar también qué botones abren la búsqueda y qué esconder mientras está abierta. Son campos de texto en la ficha de la tienda, no cambios en el tema.

Preguntas frecuentes

¿Qué hace un módulo de búsqueda para PrestaShop?

Sustituye la búsqueda nativa de la plataforma por un motor propio, que pasa a responder a la barra que el tema ya tiene. En la práctica cambia tres cosas: el índice, que deja de reconstruirse a mano y pasa a acompañar al catálogo; el tratamiento de las erratas y del vocabulario, que deja de ser una lista de alias escrita error a error; y los informes, porque la búsqueda nativa no tiene ninguno. El tema, el carrito y la estructura del catálogo se quedan como estaban.

¿Cómo mejorar la búsqueda de PrestaShop sin cambiar de módulo?

Hay tres cosas que se hacen sin instalar nada, y vale la pena hacerlas antes de decidir. Reconstruir el índice en Parámetros de la tienda, porque las cuentas que no cuadran entre productos y productos indexados explican muchos «no encuentra». Bajar la longitud mínima de las palabras, si el catálogo tiene referencias cortas. Y escribir alias para los errores de escritura más frecuentes, que se descubren en los registros de búsqueda. Si después de esto los clientes siguen sin encontrar, el problema es de vocabulario y de relevancia, y ahí ninguna configuración lo resuelve.

¿El módulo de Buskara cambia el tema de PrestaShop?

No cambia plantillas, CSS ni la estructura del catálogo. Añade una etiqueta de script a las páginas y pasa a responder a la barra de búsqueda que el tema ya tiene. Si el selector por defecto no atrapa esa barra, se indica otro en un campo de configuración.

¿Con qué versiones de PrestaShop funciona?

A partir de la 1.7.6.0, sin límite superior declarado, lo que incluye las líneas 8 y 9. No hace falta cambiar de tema ni de versión para instalarlo.

¿Puedo probarlo sin que lo vean los clientes?

Puedes. La configuración del módulo tiene una caja de direcciones IP de depuración: con tu dirección ahí dentro, el layer aparece solo para ti, incluso en la tienda en producción. Mientras esa caja no esté vacía, ningún otro visitante lo recibe.

¿Qué pasa si desinstalo el módulo?

La configuración local se limpia y la tienda vuelve a usar la búsqueda de la plataforma. El índice del lado de Buskara sigue existiendo, solo deja de ser alimentado por la tienda.

¿Cada cuánto tiempo se sincroniza el catálogo?

Los cambios en productos, incluido el stock, se empujan en el momento en que se guardan. Además hay una sincronización periódica pedida desde fuera, y un botón de reindexación completa para cuando se quiera forzar. En catálogos grandes, la reindexación completa debe correr por la línea de comandos.

¿Vale la pena si la tienda es pequeña?

No siempre, y no cuesta nada decirlo. En un catálogo pequeño con vocabulario estable, la búsqueda nativa y una lista corta de alias suelen bastar. El caso para cambiar aparece cuando el catálogo crece, cuando los clientes usan palabras diferentes de las del catálogo, o cuando la lista de alias lleva un año sin mantenerse. Los planes empiezan en el tamaño de tienda donde esa cuenta todavía tiene sentido.

¿El módulo comparte datos de clientes?

El catálogo siempre se comparte, porque es lo que se indexa. Volumen de ventas, precio de coste y pedidos son tres señales opcionales, con interruptor propio, y sirven respectivamente a la ordenación por más vendidos, los márgenes en la analítica y los ingresos atribuidos a la búsqueda. Se quedan desactivadas hasta que alguien las active.