dfbundlevisual — Comprados juntos habitualmente

Presentación

dfbundlevisual muestra en la ficha de producto un bloque « Comprados juntos habitualmente » estilo Amazon: tarjetas de producto seleccionables separadas por signos « + », un precio total recalculado en directo y un único botón para añadir la selección al carrito. Un descuento de lote (porcentaje o importe fijo con IVA) se aplica automáticamente cuando el lote completo está en el carrito. Sin lote manual, el módulo puede sugerir los productos realmente comprados juntos según su historial de pedidos.

Instalación

1. En el back-office, abra Módulos > Gestor de módulos > Subir un módulo.
2. Suba el archivo dfbundlevisual.zip y haga clic en Instalar.
3. El módulo crea sus tablas, su pestaña Catálogo > Lotes visuales y se registra en los hooks necesarios.

Configuración

Abra la página de configuración del módulo (Módulos > Gestor de módulos > dfbundlevisual > Configurar):

• Activar el módulo: interruptor general del bloque front.
• Hook de visualización: displayFooterProduct (pie de ficha de producto, recomendado) o displayProductAdditionalInfo (bajo el botón de compra, según el tema).
• Título del bloque: personalizable por idioma. Por defecto « Comprados juntos habitualmente » en español.
• Activar sugerencias automáticas: muestra sugerencias por co-compra cuando no existe un lote manual para el producto consultado.
• Máx. de sugerencias automáticas: número de productos complementarios propuestos (2 por defecto).
• Co-compras mínimas: número mínimo de pedidos que contienen ambos productos para que aparezca una sugerencia (2 por defecto).
• Ventana de historial de pedidos (días): periodo analizado para la co-ocurrencia (365 por defecto).

Crear un lote

1. Abra Catálogo > Lotes visuales y haga clic en Añadir.
2. Nombre del lote: nombre interno, también utilizado como etiqueta del descuento en el carrito.
3. Producto principal: busque por nombre, referencia o ID. El bloque se mostrará en la ficha de este producto.
4. Productos del lote: añada uno o varios productos complementarios mediante la búsqueda con autocompletado.
5. Tipo y valor del descuento: sin descuento, porcentaje (máx. 100) o importe fijo con IVA.
6. Active el lote y guarde.

Funcionamiento del descuento

El descuento se aplica mediante una regla de carrito dinámica creada al vuelo para cada carrito (código DFBV-{id_lote}-{id_carrito}) y restringida únicamente a los productos del lote:

• Solo se crea si el lote completo está presente en el carrito — verificación realizada en el servidor.
• Un descuento porcentual se aplica únicamente a los productos del lote, nunca al resto del carrito.
• Si el cliente retira un producto del lote, el descuento se elimina automáticamente.
• Al validar el pedido, la regla se desactiva para que no pueda reutilizarse.
• Al desinstalar el módulo, todas las reglas generadas se purgan.

Sugerencias automáticas

Cuando no existe un lote manual activo para el producto consultado y la opción está activada, el módulo analiza la co-ocurrencia de productos en sus pedidos válidos durante la ventana configurada y muestra las combinaciones más frecuentes que respetan el umbral de co-compras. Los productos sin stock quedan excluidos. El resultado se almacena en caché para preservar el rendimiento. No se aplica ningún descuento a las sugerencias automáticas: los descuentos están reservados a los lotes manuales.

Estadísticas

La lista Catálogo > Lotes visuales muestra para cada lote sus vistas (visualizaciones del bloque) y sus conversiones (añadidos completos al carrito). Las sugerencias automáticas se contabilizan globalmente. Utilice estas cifras para ajustar composiciones y descuentos.

Solución de problemas

• El bloque no aparece: verifique que el módulo está activado, que existe un lote activo para el producto (o que las sugerencias automáticas están activadas con historial suficiente) y que el hook elegido está presente en su tema.
• El descuento no aparece: solo se crea cuando todos los productos del lote están en el carrito. Compruebe también que el tipo de descuento no es « Sin descuento ».
• Sin sugerencias automáticas: reduzca el umbral mínimo de co-compras o amplíe la ventana de historial; se requieren pedidos válidos que contengan los productos juntos.
• Productos con combinaciones: se utiliza la combinación por defecto al añadir al carrito, con control de stock.