Módulo Precio «Desde» (dffromprice) — Documentación

El módulo dffromprice («Desde») muestra el precio por cantidad más bajo directamente en tus listados de productos cuando un producto tiene un descuento por cantidad. Esta documentación cubre la instalación, la configuración completa y la resolución de problemas.

Presentación

Cuando un producto tiene descuentos por cantidad (por ejemplo «compra 3 = ahorra un 20%»), esta información solo es visible en la ficha de producto, al final. El módulo hace subir una etiqueta «Desde X» a la miniatura del producto, en categorías, búsqueda, ventas cruzadas y bloques de productos destacados. El precio mostrado se calcula con el mecanismo nativo de PrestaShop, teniendo en cuenta el grupo de cliente, la moneda, el país y el método de cálculo del impuesto.

Instalación

Desde el back-office

1. Ve a Módulos > Gestor de módulos.
2. Haz clic en Subir un módulo y selecciona el archivo ZIP del módulo.
3. Una vez completada la subida, el módulo se instala automáticamente y registra sus hooks.

Por FTP

1. Descomprime el archivo y coloca la carpeta dffromprice en el directorio /modules de tu tienda.
2. En Módulos > Gestor de módulos, busca «Desde» y haz clic en Instalar.

Ajustes

La configuración se encuentra en Módulos > Gestor de módulos > dffromprice > Configurar. Está organizada en dos paneles.

Visualización

• Activar el módulo: interruptor general.
• Mostrar en los listados de productos: categorías, búsqueda, ventas cruzadas, productos destacados.
• Mostrar en la ficha de producto: añade el precio «Desde» tras el precio principal de la ficha.
• Etiqueta: texto mostrado antes del precio, traducible por idioma («Desde», «From»…).
• Mostrar la cantidad mínima: indica la cantidad necesaria para obtener el mejor precio.
• Etiqueta de cantidad: texto que acompaña a la cantidad, con la variable %qty% (ej. «desde %qty% unidades»).
• Mostrar el porcentaje de ahorro: insignia «-21%» basada en la diferencia entre el precio base y el mejor precio por cantidad.
• Etiqueta de impuesto (IVA incl./excl.): Nunca, Según los ajustes de la tienda, o Siempre.
• Modo de visualización: Reemplazar el precio normal o Mostrar junto al precio normal.
• Selector(es) CSS a ocultar: en modo reemplazo, selectores CSS ocultados cuando se muestra el precio «Desde».

Apariencia y restricciones

• Color del texto: selector de color, #f1a019 por defecto.
• Ahorro mínimo para mostrar (%): oculta el precio «Desde» si el ahorro es inferior a este porcentaje. 0 = mostrar siempre.
• IDs de productos excluidos: lista de IDs separados por comas.
• IDs de categorías excluidas: lista de IDs separados por comas (según la categoría por defecto del producto).
• CSS personalizado: añadido en todas las páginas del front, para apuntar al bloque .df-fromprice y sus hijos.

Funcionamiento y cálculo del precio

El módulo se basa en SpecificPrice::getQuantityDiscounts() con los mismos parámetros que la tabla nativa «Descuento por cantidad» (tienda, moneda, país, grupo de cliente, cliente). Para cada tramo de cantidad superior a 1, el precio unitario real se calcula mediante Product::getPriceStatic(). El precio «Desde» solo se muestra si este precio es estrictamente inferior al precio base. Una caché estática por producto y combinación garantiza una sola consulta de cálculo por miniatura dentro de una página.

Compatibilidad con temas

El módulo se engancha al hook displayProductPriceBlock, presente en todos los listados de productos estándar de PrestaShop. En modo reemplazo, el precio normal se oculta con el selector CSS configurable. El valor por defecto cubre los temas basados en Classic y el tema Falcon:

.df-fromprice + .wrapper-price-taxe, .df-fromprice + .price

Para otro tema, inspecciona el contenedor del precio en la miniatura y ajusta el selector en consecuencia.

Resolución de problemas

El precio «Desde» no aparece

• Comprueba que el producto tiene realmente un descuento por cantidad (tramo de cantidad superior a 1) y que el precio por tramo es inferior al precio base.
• Comprueba que la visualización en los listados de productos está activada.
• Revisa el umbral mínimo de ahorro: si es demasiado alto, la visualización puede quedar bloqueada.
• Asegúrate de que el producto o su categoría no figuran en las exclusiones.

El precio normal sigue visible en modo reemplazo

El selector CSS de ocultación no coincide con el contenedor de precio de tu tema. Ajusta el campo «Selector(es) CSS a ocultar» y luego vacía la caché.