Smart Offers — Documentación completa
Configure y gestione Ofertas combinadas en PrestaShop 1.7.8, 8 y 9: compre X reciba Y, regalos por lote, ofertas a elegir y lotes, aplicados de forma automática y segura en el carrito.
Ofertas combinadas le permite lanzar las cuatro promociones combinadas más habituales en PrestaShop: compre X y reciba Y del mismo producto, un regalo por productos comprados juntos, ofertas a elegir entre una selección y lotes. El módulo añade los artículos de recompensa al carrito, aplica el descuento y muestra la oferta en la ficha de producto y en el carrito, en PrestaShop 1.7.8, 8 y 9.
Compatibilidad
| Elemento | Compatible |
|---|---|
| PrestaShop | 1.7.8, 8.0 a 8.2, 9.0 y posteriores (un único ZIP) |
| PHP | 7.2 o superior (se aplica la versión exigida por su PrestaShop) |
| Temas | Classic, Hummingbird y sus temas hijos |
| Multitienda, multidivisa, combinaciones | Sí |
| Idiomas | inglés, francés, español, alemán, italiano, polaco, neerlandés, portugués |
Instalación y actualización
- En el back office, abra Módulos → Gestor de módulos y haga clic en Subir un módulo.
- Suelte el archivo
dfoffers-3.0.0.zip. - El módulo aparece en Catálogo → Descuentos → Ofertas combinadas, junto a las reglas de carrito.
Actualización desde la 2.x: suba el nuevo ZIP sobre el anterior. Se conservan sus ofertas, productos, traducciones y tiendas. El script de actualización añade las nuevas opciones, mueve la entrada del menú y asegura las reglas de carrito ya creadas por la 2.x (ya no puede generarse ningún vale por el importe restante).
El panel
La página Ofertas muestra las ofertas en curso, los pedidos válidos que usaron una oferta en los últimos 30 días, sus ingresos y el descuento concedido. Cada oferta muestra su regla en lenguaje claro, su estado (en curso, programada, finalizada, desactivada), sus fechas, sus pedidos y su descuento. Puede buscar, filtrar por estado, activar o desactivar con un clic, duplicar, eliminar y aplicar acciones en bloque.

Los cuatro tipos de oferta
- Compre X, reciba Y del mismo producto: el clásico 1+1 o 2+1. Cada producto de la lista tiene su propia oferta; deje «cualquier combinación» para contar juntas todas sus variantes.
- Compre productos juntos, reciba un regalo: todos los productos activadores deben estar en el carrito; los productos de recompensa son entonces gratis o con descuento.
- A elegir entre una selección: el cliente elige N artículos entre productos o combinaciones y los más baratos son gratis o con descuento (3 por 2 en todas las tazas, por ejemplo).
- Lote: por cada lote de X unidades de un producto, el cliente recibe Y unidades de otro producto.
Crear una oferta
Haga clic en Nueva oferta o elija uno de los cuatro modelos cuando aún no exista ninguna oferta. El editor tiene cinco pasos y, a la derecha, una vista previa en directo del banner de producto y un resumen de la regla en lenguaje claro.
- Tipo de oferta: una de las cuatro tarjetas. Solo se muestran los campos útiles.
- Productos y cantidades: añada los productos con la ventana de búsqueda, por nombre, referencia o ID. Para un producto con combinaciones, añádalo para todas sus combinaciones o elija una o varias.
- Recompensa: gratis (100 %) o porcentaje (50 para «la segunda a mitad de precio»), añadido automático al carrito o no, repetición en cada lote completo, máximo por carrito.
- Visualización: nombre, texto de la etiqueta y texto adicional en cada idioma, color de la oferta. El color del texto de la etiqueta se elige automáticamente para que siga siendo legible.
- Disponibilidad: estado, fechas de inicio y fin, prioridad, grupos de clientes y tiendas.


Cuando los artículos de recompensa no se añaden automáticamente, el cliente los añade y el descuento se aplica en cuanto están en el carrito; el carrito le recuerda entonces la recompensa pendiente.

El banner de la ficha de producto
En cada producto afectado, un banner explica la oferta con los productos que comprar y la recompensa, el precio habitual tachado junto a los artículos gratis o con descuento, la fecha de fin de la oferta y el estado «Aplicada en su carrito» en cuanto el cliente la consigue. Se adapta a columnas estrechas y al móvil.




El carrito
Bajo las líneas del carrito, el cliente ve las ofertas aplicadas con el importe ahorrado y los artículos recibidos. Una etiqueta («Gratis ×1», «1 a -50 %») señala las líneas con unidades con descuento, en el carrito y en el resumen del pedido. El bloque se actualiza tras cada cambio de cantidad, tanto en Classic como en Hummingbird.

Ya casi lo tiene indica lo que falta para desbloquear una oferta («Añada 1 × camiseta») y Le espera una recompensa recuerda al cliente que añada una recompensa que no se añade automáticamente.

Si el cliente quita un regalo, no se le vuelve a imponer: la oferta se deja de lado y aparece un botón Volver a añadirlo. En un «compre X, reciba Y» del mismo producto, primero se quitan las unidades gratuitas: el cliente nunca pierde una unidad pagada.

Ajustes
- Posición del banner: bajo el botón Añadir al carrito (recomendado), justo debajo del precio, bajo las imágenes, en el bloque de garantías o a todo lo ancho bajo la descripción.
- Banner compacto, precios en el banner y fecha de fin.
- Carrito: mostrar lo que falta para desbloquear una oferta, etiqueta en las líneas del carrito.
- Registro de depuración: escribe cada cálculo del carrito en Parámetros avanzados → Registros; déjelo desactivado en producción.
- Mantenimiento: número de reglas de carrito creadas por el módulo y limpieza de las de carritos abandonados.

Cómo funciona el motor
- En cada cambio del carrito (y al mostrar el carrito o el proceso de compra), el módulo lee el carrito y distingue las unidades que paga el cliente de las que ha añadido él mismo.
- Las ofertas se evalúan por prioridad (primero la 1). Una unidad usada por una oferta no la vuelve a usar otra: un mismo artículo nunca tiene doble descuento.
- Para cada oferta aplicable, se añaden las recompensas que faltan (si así lo eligió) y se crea o actualiza una regla de carrito por producto con descuento (código
DFOFFER_…). - Las ofertas que dejan de aplicarse se retiran: se quitan las unidades añadidas y se eliminan las reglas de carrito.
Seguridad e impuestos
- Todo se calcula en el servidor a partir del carrito y de sus ofertas; nada de lo que envía el navegador interviene en un precio.
- Cada regla de carrito está limitada al producto con descuento: nunca puede superar lo que el cliente tiene de ese producto en el carrito, y al descuento se le aplica el tipo de IVA de ese producto, también en la factura.
- Las reglas nunca generan un vale por el importe restante, no aparecen en «Mis vales» y un código copiado de otro carrito se retira antes del pago.
- Una recompensa agotada o desactivada no recibe descuento. Un pedido ya realizado nunca se modifica.
- Las acciones del back office respetan los permisos de la pestaña por empleado (ver, añadir, editar, eliminar).
Las reglas de carrito de los carritos abandonados desde hace 30 días se eliminan automáticamente una vez al día al abrir el módulo; las usadas en un pedido se conservan siempre para su contabilidad.
Ayuda y solución de problemas
La pestaña Ayuda del módulo explica el funcionamiento y responde a las preguntas más frecuentes.
- El banner no aparece: compruebe que la oferta está activada, dentro de sus fechas, disponible para el grupo de clientes y la tienda, y que el producto está activo. Después pruebe otra posición del banner: algunos temas no llaman a todos los hooks.
- Uno de sus cupones se rechaza con una oferta: un cupón configurado como «no acumulable con otras reglas de carrito» puede negarse a combinarse; ajústelo en Catálogo → Descuentos.
- Falta la etiqueta en las líneas del carrito: su tema debe incluir
{hook h='displayProductPriceBlock' product=$product type="unit_price"}o{hook h='displayCartExtraProductActions' product=$product}en la plantilla de línea del carrito.

Detalles técnicos
- Hooks: displayProductAdditionalInfo (o la posición elegida), displayProductPriceBlock, displayAfterProductThumbs, displayReassurance, displayFooterProduct, displayShoppingCartFooter, displayCartExtraProductActions, actionCartSave, actionFrontControllerSetMedia, actionObjectProductDeleteAfter, actionObjectCombinationDeleteAfter.
- Tablas: ps_dfoffers_offer, _offer_lang, _trigger, _reward, _shop, _cart_auto, _rule, _cart_declined.
- Plantillas que puede sobrescribir en su tema:
views/templates/hook/product-banner.tpl,cart-offer.tpl,cart-line-gift.tpl. Las clases CSS usan el prefijodfoffers-. - Sin override, sin tarea cron, sin servicio externo. La desinstalación elimina las ofertas y las reglas de carrito no usadas; las usadas en pedidos se conservan.