Live Search Inteligente — Guía completa
Instalar, configurar y explotar DFLiveSearch: búsqueda live, sugerencias, productos recomendados, estadísticas, avisos email y personalización para PrestaShop 8 y 9.
Presentación y requisitos
DFLiveSearch sustituye la búsqueda nativa de PrestaShop por un motor live en AJAX: un panel de resultados se abre desde los primeros caracteres, con la imagen, el nombre, el precio y las insignias promocionales de cada producto. El módulo añade además carruseles de sugerencias (búsquedas populares y productos recomendados), un panel analítico completo y avisos email sobre las búsquedas sin resultado.
- Compatible con PrestaShop 8.0 a 9.x, tema Classic y temas derivados.
- PHP 8.1 y superior.
- Multi-tienda y multilingüe (FR/EN/ES/DE/IT).
- Sin sobrescritura de archivos: solo hooks nativos.
El módulo se apoya en los hooks displayHeader, displayTop, displaySearch, displayBackOfficeHeader y actionOrderStatusPostUpdate. Crea cuatro tablas: dflivesearch_stats, dflivesearch_log, dflivesearch_alerts y dflivesearch_popular.
Instalación
Instala el módulo como cualquier otro módulo de PrestaShop:
- Descarga el archivo
dflivesearch.zipdesde tu cuenta de cliente. - En el back-office, ve a Módulos > Gestor de módulos.
- Haz clic en Subir un módulo y suelta el archivo.
- Una vez instalado, haz clic en Configurar.
Al instalarse, el módulo registra sus hooks, crea sus tablas y rellena un texto de marcador (placeholder) traducido a los cinco idiomas. El campo de búsqueda live queda activo en tu tienda de inmediato.
Actualización
La actualización se realiza normalmente desde el Gestor de módulos. El script de actualización integrado aplica automáticamente los valores por defecto de las nuevas opciones (colores, ancho de la ventana, modo de productos recomendados) sin tocar tu configuración existente. No se requiere ninguna acción manual. Tras actualizar, vacía la caché de PrestaShop y regenera los assets para purgar el JavaScript antiguo.
Configuración general
La página de configuración reúne los ajustes del comportamiento de la búsqueda:
- Activar el módulo: activa o desactiva el campo de búsqueda live en la tienda.
- Texto de marcador (placeholder): texto mostrado en el campo, traducible por idioma.
- Número mínimo de caracteres: umbral de activación de la búsqueda (2 por defecto).
- Número máximo de productos: límite de resultados mostrados en el panel.
- Búsquedas populares y búsquedas recientes: visualización de los carruseles de sugerencias antes de escribir.
- Autocompletar: sugerencias de términos (productos, categorías, búsquedas populares) durante la escritura, con un máximo configurable.
- Añadir rápidamente al carrito y selector de cantidad: opciones para añadir un producto directamente desde los resultados.
- Productos personalizados: tiene en cuenta el historial del cliente conectado para las recomendaciones automáticas.
Apariencia
La sección Apariencia permite adaptar la ventana de búsqueda a tu identidad gráfica:
- Color principal: color de los botones y acentos (por defecto
#2196F3). - Color principal (hover): color al pasar el ratón por los botones (por defecto
#1976D2). - Ancho máx. de la ventana: ancho máximo del panel de búsqueda. Acepta un valor CSS como
900px,1200pxo100%.
Estos valores se inyectan como CSS en el front. Para una ventana a ancho completo tanto en móvil como en escritorio, introduce 100% en el campo de ancho.
Productos recomendados
Los productos recomendados aparecen en carrusel nada más abrir el campo de búsqueda. Hay dos modos disponibles mediante el ajuste Origen de los productos recomendados:
- Automático: el módulo selecciona los más vendidos (y tiene en cuenta el historial del cliente si la opción «Productos personalizados» está activada).
- Manual: eliges exactamente qué productos se destacan.
En modo manual aparece un selector dedicado: busca un producto por nombre o referencia, haz clic para añadirlo y luego reordena las miniaturas arrastrando y soltando. El orden definido se respeta en la tienda.
En el selector solo se ofrecen productos activos y visibles. El orden de las miniaturas determina el orden de aparición en el carrusel.
Comportamiento de la búsqueda
Búsqueda por palabras
La búsqueda funciona por palabras: cada palabra introducida debe encontrarse (en el nombre, la referencia, el código EAN o la descripción corta), en cualquier orden. Una consulta como «estetoscopio campana simple» encuentra así el producto aunque esas palabras no estén seguidas en el nombre. Los resultados se clasifican por relevancia (nombre exacto, luego nombre que empieza por la consulta, luego coincidencias parciales).
Productos con combinaciones
Para un producto con combinaciones, el botón de añadir al carrito se sustituye por un botón «Ver opciones» que redirige a la ficha de producto, para que el cliente elija su combinación antes de añadir.
Disponibilidad y stock
Los productos sin stock siguen mostrándose en los resultados con una insignia «Sin stock». Esta insignia no aparece en los productos cuyo pedido sin stock está permitido (ajuste «Permitir pedidos» de PrestaShop): esos siguen pudiéndose añadir al carrito.
Si introduces una cantidad superior al stock disponible de un producto que no se puede pedir sin stock, el módulo no añade el producto y muestra un mensaje con la cantidad restante.
Panel de control y estadísticas
El módulo registra cada búsqueda (término introducido, número de resultados, posible clic en un producto, conversión en pedido). El panel del back-office muestra:
- el total de búsquedas y el número de búsquedas únicas;
- las tasas de éxito, de clic y de conversión;
- un gráfico de evolución de las búsquedas por día;
- el top 20 de búsquedas con clics y conversiones;
- el top 20 de búsquedas sin resultado;
- una exportación CSV de todos los datos.
El seguimiento de conversiones se realiza mediante el hook actionOrderStatusPostUpdate: un pedido realizado tras un clic en los resultados de búsqueda se cuenta como convertido.
Avisos email
El sistema de avisos vigila los términos que no devuelven ningún resultado. En cuanto un término supera el umbral configurable (5 por defecto), se envía un aviso email a la dirección elegida y aparece una notificación en el encabezado del back-office. Cada aviso puede marcarse como leído o eliminarse. Estas búsquedas sin resultado son una fuente valiosa para detectar lagunas del catálogo o errores tipográficos frecuentes.
Retención de datos
Los logs de búsqueda se conservan 90 días por defecto (duración configurable). Hay un botón de limpieza manual en el back-office para purgar de inmediato las entradas antiguas.
FAQ y resolución de problemas
La búsqueda no devuelve nada con varias palabras
Desde la versión 1.1.9, la búsqueda funciona por palabras independientes del orden. Si acabas de actualizar, vacía la caché de PrestaShop y regenera los assets para cargar el nuevo JavaScript.
El panel de autocompletar tapa los resultados
El autocompletar se cierra automáticamente cuando el campo pierde el foco. Asegúrate de usar la última versión y vacía la caché si el comportamiento antiguo persiste.
Añadir al carrito no funciona con un carrito vacío
Este caso está resuelto: el módulo ahora persiste el carrito recién creado. Actualiza a la última versión y luego vacía la caché.
Aparece una insignia «sin stock» en un producto que se puede pedir
El módulo lee el ajuste «Permitir pedidos» en la pestaña Cantidades de la ficha de producto (almacenado del lado de StockAvailable en PrestaShop 8). Comprueba este ajuste: si permite el pedido, no se mostrará ninguna insignia.
¿Qué ocurre al desinstalar?
La desinstalación elimina limpiamente los hooks, las variables de configuración y las tablas del módulo. No queda ningún dato residual en la base de datos.