DF Quantity Tiers — Documentación
Instale, configure y aproveche DF Quantity Tiers: visualización de precios por volumen, añadir por tramo, incentivo en carrito, modo B2B, JSON-LD y estadísticas.
Presentación y requisitos
DF Quantity Tiers transforma los descuentos por cantidad nativos de PrestaShop en un bloque de venta claro y con botones. El módulo no introduce ninguna lógica de precios nueva: lee los precios específicos por cantidad ya configurados en su catálogo y los presenta en tarjetas o en tabla, con un botón de añadir al carrito para cada tramo.
- Compatible con PrestaShop 8.0 a 9.x, tema Classic y temas derivados.
- PHP 7.4 a 8.3.
- Multitienda y multiidioma (FR/EN/ES/DE/IT).
- Sin sobrescritura de archivos: solo hooks nativos.
Los tramos provienen de Catálogo > Producto > Precios > Precios específicos, campo «A partir de la cantidad». Si un producto no tiene precios específicos por cantidad, el bloque no se muestra para ese producto.
Instalación
Instale el módulo como cualquier módulo de PrestaShop:
- Descargue el archivo
dfquantitytiers-1.1.0.zipdesde su cuenta de cliente. - En el back office, vaya a Módulos > Gestor de módulos.
- Haga clic en Subir un módulo y suelte el archivo.
- Una vez instalado, haga clic en Configurar.
Al instalarse, el módulo registra sus hooks, crea su tabla de estadísticas y rellena un título de bloque traducido a los cinco idiomas. Sus descuentos por cantidad existentes aparecen de inmediato en las fichas de producto correspondientes.
Actualización desde la 1.0.0
La actualización a la 1.1.0 se realiza normalmente desde el Gestor de módulos. El script de actualización integrado crea la tabla de estadísticas, registra el nuevo hook de la página del carrito y aplica los valores por defecto de las nuevas opciones (modo fiscal, JSON-LD, incentivo en el carrito, estadísticas, etiquetas de embalaje). No se requiere ninguna acción manual y su configuración existente se conserva.
Configuración general
La página de configuración reúne todos los ajustes de visualización:
- Título del bloque: texto mostrado encima de los tramos, traducible por idioma.
- Disposición: «Tarjetas» (recomendada, una tarjeta por tramo) o «Tabla compacta» (una fila por tramo).
- Posición en la ficha de producto: debajo del bloque de compra (hook
displayProductAdditionalInfo, por defecto) o directamente bajo el precio (hookdisplayProductPriceBlock). - Color de acento: aplicado al tramo «Mejor oferta», a las insignias y a los botones.
- Visualización del ahorro: en porcentaje, en importe o ambos.
- Mostrar el precio total del tramo: añade el total para la cantidad del tramo.
- Mostrar el tramo «por unidad»: muestra el precio base como primer tramo de comparación.
El tramo con el mayor descuento unitario recibe automáticamente la insignia «Mejor oferta». Cuando el cliente cambia la cantidad, la tarjeta correspondiente a su elección se resalta en tiempo real.
Modo fiscal (B2B)
El modo fiscal determina si los precios de los tramos se muestran sin impuestos o con impuestos:
- Automático: sigue el ajuste de visualización del grupo de clientes actual (comportamiento estándar de PrestaShop).
- Forzar sin impuestos: muestra siempre los precios sin impuestos, con la etiqueta «sin imp.» junto a cada precio unitario. Ideal para una tienda profesional.
- Forzar con impuestos: muestra siempre los precios con impuestos, con la etiqueta «con imp.».
El modo elegido se aplica tanto a las tarjetas de la ficha de producto como al bloque de incentivo del carrito.
Etiquetas de embalaje
Puede asociar una etiqueta comercial a cada cantidad, por ejemplo «caja» o «palet». En el campo Etiquetas de embalaje, introduzca una asociación por línea con el formato cantidad=etiqueta:
12=Caja de 12
48=Medio palet
96=PaletLa etiqueta se muestra bajo la cantidad del tramo correspondiente. Este campo es traducible: rellénelo en cada idioma desde el selector de idioma del formulario.
Incentivo al siguiente tramo
Hay dos mecanismos de incentivo disponibles, activables de forma independiente.
En la ficha de producto
Una barra de progreso muestra un mensaje del tipo «Añada 3 unidad(es) más para ahorrar un 15 %», recalculado en tiempo real según la cantidad introducida. Cuando el cliente alcanza el tramo más ventajoso, el mensaje cambia a «¡Disfruta del mejor descuento!».
En la página del carrito
Para cada producto del carrito cuyo tramo superior siga siendo alcanzable, el módulo muestra bajo el carrito un bloque que indica «Añada N unidades más para pasar a X / unidad», con un botón de añadir en un clic. El botón utiliza el mecanismo nativo de actualización del carrito de PrestaShop y luego recarga la página. Si no hay ningún tramo superior alcanzable, no se muestra ningún bloque.
Datos estructurados (JSON-LD)
Cuando la opción está activada, el módulo añade en la ficha de producto un marcado JSON-LD de tipo AggregateOffer, con una oferta por tramo y su cantidad elegible asociada. Esto permite a los buscadores comprender sus rangos de precios por cantidad.
Si su tema u otro módulo SEO ya genera un marcado Offer completo para sus productos, desactive esta opción para evitar un marcado duplicado señalado en Search Console.
Estadísticas de clics por tramo
Cuando la opción está activada, cada clic en un botón de añadir por tramo se registra de forma anónima: producto, combinación, cantidad y descuento del tramo pulsado. No se utiliza ningún dato personal ni cookie, lo que hace que la función cumpla el RGPD.
La página de configuración muestra un panel de los últimos 30 días: número total de clics y las combinaciones producto / tramo / descuento más pulsadas. Estos datos le ayudan a calibrar sus descuentos identificando qué tramos generan realmente añadidos al carrito.
FAQ y resolución de problemas
El bloque no aparece en un producto
Compruebe que el producto tiene precios específicos con una cantidad de inicio superior a 1 y que esos precios se aplican al grupo de clientes, la divisa y el país actuales. El tramo base por sí solo no activa la visualización si no existe ningún tramo de descuento.
El botón de añadir no funciona con mi tema
El módulo se basa en el botón estándar de añadir al carrito del tema Classic. En un tema muy personalizado, asegúrese de que el campo de cantidad y el botón de añadir siguen el marcado estándar de PrestaShop.
¿Funciona con las combinaciones?
Sí. Los tramos se recalculan para cada combinación y el bloque se actualiza automáticamente al cambiar de variante, sin recargar la página.
¿Qué ocurre al desinstalar?
La desinstalación elimina limpiamente los hooks, las variables de configuración y la tabla de estadísticas. No queda ningún dato residual en la base de datos.