Módulo Carrito Sticky y Cross-sell IA — Instalación y configuración
Instalación, configuración y funcionamiento del módulo Carrito Sticky y Cross-sell IA.
Descripción general
El módulo Carrito Sticky y Cross-sell IA (dfstickycart) añade a tu tienda PrestaShop un cajón de carrito lateral que se abre mediante Ajax en cada añadido, sin recargar la página. Muestra el contenido del carrito, una barra de progreso de envío gratis y un bloque de recomendaciones cross-sell calculadas a partir de tus pedidos reales, con una capa de IA opcional.
El motor de recomendación está totalmente autoalojado: el módulo funciona sin ninguna clave API. La IA es solo una capa de reordenación opcional.
Compatibilidad
- PrestaShop 8.0 a 9.x
- Tienda simple y multitienda
- 5 idiomas: FR, EN, ES, DE, IT
- Sin dependencias (ni Composer ni framework)
Instalación
- En el back office, abre Módulos > Gestor de módulos.
- Haz clic en Subir un módulo y selecciona el archivo
dfstickycart.zip. - Una vez instalado, haz clic en Configurar.
El módulo registra automáticamente sus hooks (actionFrontControllerSetMedia, displayHeader, displayFooter) y crea su tabla de caché al instalarse. La desinstalación elimina esa tabla.
Configuración
General
- Activar el módulo: muestra u oculta el cajón y el botón flotante.
- Posición del cajón: a la derecha o a la izquierda de la pantalla.
- Apertura automática: abre el cajón en cada añadido al carrito.
- Botón flotante: muestra un botón de carrito permanente con el contador de artículos.
- Color principal: color de acento del cajón, los botones y la barra.
Recomendaciones
- Activar las recomendaciones: muestra el bloque cross-sell en el cajón.
- Número de productos: número de sugerencias mostradas (3 por defecto).
- Estrategia: Auto (solo el motor autoalojado) o IA (reordenación por inteligencia artificial).
- Mensaje de carrito vacío: texto mostrado cuando el carrito aún no tiene artículos.
Envío gratis
Indica el umbral de envío gratis en la moneda por defecto. La barra de progreso muestra automáticamente el importe restante («Solo X € para el envío gratis») y se convierte a la moneda activa del cliente. Indica 0 para ocultar la barra.
Inteligencia artificial (opcional)
- Proveedor: Mistral por defecto, o cualquier servicio compatible con OpenAI.
- Endpoint: URL de la API de completado (por defecto el endpoint de chat de Mistral).
- Modelo: nombre del modelo (por ejemplo un modelo ligero de Mistral).
- Clave API: tu clave. Nunca se vuelve a mostrar y se conserva si dejas el campo vacío al actualizar.
Si falta la clave o la API no responde, el módulo recurre silenciosamente al motor autoalojado. El cajón nunca se bloquea por un error de IA.
Cómo funciona el motor de recomendación
Las sugerencias se construyen a partir de un grupo de productos procedente de tres fuentes, por orden de prioridad:
- Co-compra (market-basket): productos realmente pedidos junto con los del carrito, a partir de pedidos válidos (mayor peso).
- Afinidad de categoría: productos de las mismas categorías que el carrito.
- Más vendidos: recurso cuando el historial es insuficiente.
El resultado se almacena en caché por composición del carrito durante una duración configurable, para limitar los cálculos. Si la estrategia IA está activa, la capa de inteligencia artificial reordena este grupo y genera un breve motivo personalizado para cada producto.
Rendimiento
El contenido del cajón se carga mediante Ajax solo al abrirlo: no se ejecuta ninguna petición adicional hasta que el cliente abre el carrito. Las recomendaciones en caché evitan recalcular el motor en cada visualización.
FAQ y resolución de problemas
El cajón no se abre
Comprueba que el módulo está activado, vacía la caché de PrestaShop (Parámetros avanzados > Rendimiento) y verifica que el tema carga jQuery en el front.
No aparece ninguna recomendación
En una tienda nueva sin historial de pedidos, el motor se apoya en la afinidad de categoría y luego en los más vendidos. Asegúrate de tener productos activos y visibles en el catálogo.
Las sugerencias de IA no cambian
Los resultados se almacenan en caché por composición del carrito. Reduce la duración de la caché durante las pruebas, o modifica el carrito para generar una nueva clave de caché.