Module Prix « À partir de » (dffromprice) — Documentation

Le module dffromprice (« À partir de ») affiche le prix par quantité le plus bas directement dans vos listes produit dès qu’un produit possède une remise sur la quantité. Cette documentation couvre l’installation, la configuration complète et le dépannage.

Présentation

Lorsqu’un produit dispose de remises sur la quantité (par exemple « 3 achetés = 20 % d’économie »), cette information n’est visible que sur la fiche produit, tout en bas. Le module fait remonter un libellé « À partir de X € » sur la vignette du produit, dans les catégories, la recherche, les blocs de ventes croisées et de produits phares. Le prix affiché est calculé avec le mécanisme natif de PrestaShop, en tenant compte du groupe client, de la devise, du pays et de la méthode de calcul de la taxe.

Installation

Par le back-office

1. Rendez-vous dans Modules > Module Manager.
2. Cliquez sur Installer un module et sélectionnez le fichier ZIP du module.
3. Une fois l’upload terminé, le module s’installe automatiquement et enregistre ses hooks.

Par FTP

1. Décompressez l’archive et déposez le dossier dffromprice dans le répertoire /modules de votre boutique.
2. Dans Modules > Module Manager, recherchez « À partir de » et cliquez sur Installer.

Réglages

La configuration se trouve dans Modules > Module Manager > dffromprice > Configurer. Elle est organisée en deux panneaux.

Affichage

• Activer le module : interrupteur général.
• Afficher dans les listes produit : catégories, recherche, ventes croisées, produits phares.
• Afficher sur la fiche produit : ajoute le prix « À partir de » après le prix principal de la fiche produit.
• Libellé : texte affiché avant le prix, traduisible par langue (« À partir de », « From »…).
• Afficher la quantité minimale : indique la quantité requise pour obtenir le meilleur prix.
• Libellé de quantité : texte accompagnant la quantité, avec la variable %qty% (ex. « dès %qty% unités »).
• Afficher le pourcentage d’économie : badge « -21% » basé sur l’écart entre le prix de base et le meilleur prix par quantité.
• Libellé de taxe (TTC / HT) : Jamais, Selon les réglages de la boutique, ou Toujours.
• Mode d’affichage : Remplacer le prix normal ou Afficher en plus du prix normal.
• Sélecteur(s) CSS à masquer : en mode remplacement, sélecteurs CSS masqués quand le prix « À partir de » s’affiche.

Apparence et restrictions

• Couleur du texte : sélecteur de couleur, #f1a019 par défaut.
• Économie minimale pour afficher (%) : masque le prix « À partir de » si l’économie est inférieure à ce pourcentage. 0 = toujours afficher.
• IDs de produits exclus : liste d’IDs séparés par des virgules.
• IDs de catégories exclues : liste d’IDs séparés par des virgules (basé sur la catégorie par défaut du produit).
• CSS personnalisé : ajouté sur toutes les pages du front, pour cibler le bloc .df-fromprice et ses enfants.

Fonctionnement et calcul du prix

Le module s’appuie sur SpecificPrice::getQuantityDiscounts() avec les mêmes paramètres que le tableau natif « Remise sur la quantité » (boutique, devise, pays, groupe client, client). Pour chaque palier de quantité supérieur à 1, le prix unitaire réel est calculé via Product::getPriceStatic(). Le prix « À partir de » ne s’affiche que si ce prix est strictement inférieur au prix de base. Un cache statique par produit et déclinaison garantit une seule requête de calcul par vignette au sein d’une même page.

Compatibilité thèmes

Le module se branche sur le hook displayProductPriceBlock présent dans toutes les listes produit standard de PrestaShop. En mode remplacement, le prix normal est masqué par le sélecteur CSS configurable. La valeur par défaut couvre les thèmes basés sur Classic et le thème Falcon :

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

Pour un autre thème, inspectez le conteneur du prix dans la miniature et ajustez le sélecteur en conséquence.

Dépannage

Le prix « À partir de » ne s’affiche pas

• Vérifiez que le produit possède bien une remise sur la quantité (palier de quantité supérieur à 1) et que le prix par palier est inférieur au prix de base.
• Vérifiez que l’affichage dans les listes produit est activé.
• Contrôlez le seuil minimal d’économie : s’il est trop élevé, l’affichage peut être bloqué.
• Assurez-vous que le produit ou sa catégorie ne figure pas dans les exclusions.

Le prix normal reste visible en mode remplacement

Le sélecteur CSS de masquage ne correspond pas au conteneur de prix de votre thème. Ajustez le champ « Sélecteur(s) CSS à masquer » puis videz le cache.