Popularidad del Carrito — Documentación
Instalar y configurar el módulo de conteo de carritos en la ficha de producto.
El módulo Popularidad del Carrito muestra en la ficha de producto una insignia de prueba social que indica el número de carritos que contienen el producto, por ejemplo «En más de 20 carritos». Esta guía cubre la instalación, la configuración de cada ajuste, el funcionamiento del conteo y la resolución de problemas.
Instalación
El módulo se instala como cualquier módulo de PrestaShop, sin dependencias externas.
- Desde el back-office, abra Módulos > Gestor de módulos.
- Haga clic en Subir un módulo y seleccione el archivo
dfcartpopularity.zip. - Una vez finalizada la instalación, haga clic en Configurar.
Compatible con PrestaShop 8.0 a 9.x. No se requiere ninguna dependencia de Composer ni biblioteca JavaScript externa.
Configuración
La página de configuración reúne todos los ajustes de visualización y de conteo.
Texto mostrado
El mensaje presentado en la insignia, traducible por idioma. Utilice el marcador {count} para insertar el número de forma dinámica. Ejemplo: En más de {count} carritos. Las traducciones francesa, inglesa, española, alemana e italiana se incluyen por defecto.
Umbral de visualización
Número mínimo de carritos a partir del cual aparece la insignia. Por debajo de este umbral no se muestra nada, lo que evita mostrar una cifra poco atractiva. Valor por defecto: 20.
Modo de visualización del número
- Escalón redondeado: el contador se redondea hacia abajo según un escalón (p. ej. 23 carritos muestra «más de 20»). Ideal para un efecto creíble que evoluciona por tramos.
- Número exacto: se muestra la cifra real, para las tiendas que prefieren la transparencia total.
Escalón de redondeo
Se utiliza únicamente en modo escalón. Determina el tramo de redondeo: un escalón de 10 transforma 23 en «más de 20» y 37 en «más de 30».
Ventana temporal (horas)
Solo cuenta los carritos actualizados dentro de esta ventana. Por ejemplo, 168 = 7 días. Ajuste a 0 para no aplicar ningún límite de tiempo.
Solo carritos activos
Cuando esta opción está activada, los carritos ya convertidos en pedido se excluyen del conteo. Así refleja únicamente la demanda activa.
Ubicación
Elija dónde se muestra la insignia en la ficha: bajo el bloque de añadir al carrito (información adicional) o cerca de los botones de compra.
Duración de la caché (segundos)
Tiempo de conservación del conteo antes de recalcularlo. Por defecto 600 segundos (10 minutos). Ajuste a 0 para recalcular en cada visualización, lo cual no se recomienda en producción.
Cada vez que guarda los ajustes, la caché de conteo se vacía automáticamente para aplicar de inmediato sus nuevos parámetros.
Cómo funciona el conteo
El módulo cuenta los carritos reales que contienen el producto. El conteo está deduplicado por carrito —un mismo carrito nunca se cuenta dos veces— y se limita a la tienda actual en contexto multitienda. La ventana temporal y la opción «solo carritos activos» afinan este conteo para que refleje la demanda pertinente.
Rendimiento y caché
Para evitar una consulta de conteo en cada vista de producto, el resultado se almacena en una tabla de caché dedicada con una duración de vida configurable. El conteo solo se recalcula al expirar la caché, lo que preserva el rendimiento incluso en tiendas con mucho tráfico.
Multitienda y multiidioma
En multitienda, el conteo se limita a la tienda consultada. En cuanto a los idiomas, el texto de la insignia es totalmente traducible: se ajusta de forma independiente para cada idioma activo de la tienda, con el marcador {count} para el número.
Integración en el tema
La insignia se renderiza del lado del servidor mediante una plantilla del módulo. Si desea reposicionarla con precisión en su tema, la variable Smarty {$dfcp_message} contiene el mensaje listo para usar y puede insertarse en una sobrescritura de la ficha de producto.
Resolución de problemas
La insignia no aparece
Compruebe que el número real de carritos que contienen el producto alcanza el umbral definido. Si el umbral es 20 pero el producto solo está en 5 carritos, no aparece ninguna insignia; es el comportamiento esperado. Reduzca temporalmente el umbral para probar la visualización.
El número no se actualiza de inmediato
Es el efecto de la caché. Espere a que expire la duración configurada, o guarde los ajustes para forzar un vaciado inmediato de la caché.
El contador parece demasiado bajo
Si la opción «solo carritos activos» está activada y la ventana temporal es corta, solo se cuentan los carritos recientes y no pedidos. Amplíe la ventana temporal o desactive la opción para un conteo más inclusivo.