DF Quantity Tiers — Documentation

Présentation et prérequis

DF Quantity Tiers transforme les remises par quantité natives de PrestaShop en un bloc de vente clair et cliquable. Le module n’introduit aucune nouvelle logique de prix : il lit les prix spécifiques « à partir de N unités » déjà configurés dans votre catalogue et les met en scène sous forme de cartes ou de tableau, avec un bouton d’ajout au panier pour chaque palier.

• Compatible PrestaShop 8.0 à 9.x, thème Classic et thèmes dérivés.
• PHP 7.4 à 8.3.
• Multiboutique et multilingue (FR/EN/ES/DE/IT).
• Aucune surcharge de fichiers : uniquement des hooks natifs.

Installation

Installez le module comme n’importe quel module PrestaShop :

1. Téléchargez l’archive dfquantitytiers-1.1.0.zip depuis votre compte client.
2. Dans le back-office, allez dans Modules > Gestionnaire de modules.
3. Cliquez sur Installer un module et déposez l’archive.
4. Une fois installé, cliquez sur Configurer.

À l’installation, le module enregistre ses hooks, crée sa table de statistiques et pré-remplit un titre de bloc traduit dans les cinq langues. Vos prix dégressifs existants s’affichent immédiatement sur les fiches produit concernées.

Mise à jour depuis la 1.0.0

La mise à jour vers la 1.1.0 s’effectue normalement depuis le Gestionnaire de modules. Le script d’upgrade intégré crée la table de statistiques, enregistre le nouveau hook de page panier et applique les valeurs par défaut des nouvelles options (mode fiscal, JSON-LD, nudge panier, statistiques, libellés de conditionnement). Aucune action manuelle n’est nécessaire et votre configuration existante est conservée.

Configuration générale

La page de configuration regroupe l’ensemble des réglages d’affichage :

• Titre du bloc : texte affiché au-dessus des paliers, traduisible par langue.
• Disposition : « Cartes » (recommandé, une carte par palier) ou « Tableau compact » (une ligne par palier).
• Position sur la fiche produit : sous le bloc d’achat (hook displayProductAdditionalInfo, par défaut) ou directement sous le prix (hook displayProductPriceBlock).
• Couleur d’accent : appliquée au palier « Meilleure offre », aux badges et aux boutons.
• Affichage de l’économie : en pourcentage, en montant, ou les deux.
• Afficher le prix total du palier : ajoute le total pour la quantité du palier.
• Afficher le palier « à l’unité » : affiche le prix de base comme premier palier de comparaison.

Mode fiscal (B2B)

Le mode fiscal détermine si les prix des paliers sont affichés hors taxes ou toutes taxes comprises :

• Automatique : suit le réglage d’affichage du groupe client courant (comportement standard PrestaShop).
• Forcer HT : affiche systématiquement les prix hors taxes, avec la mention « HT » à côté de chaque prix unitaire. Idéal pour une boutique professionnelle.
• Forcer TTC : affiche systématiquement les prix toutes taxes comprises, avec la mention « TTC ».

Le mode choisi s’applique à la fois aux cartes de la fiche produit et au bloc de relance du panier.

Libellés de conditionnement

Vous pouvez associer un libellé métier à chaque quantité, par exemple « carton » ou « palette ». Dans le champ Libellés de conditionnement, saisissez une association par ligne au format quantité=libellé :

12=Carton de 12
48=Demi-palette
96=Palette

Le libellé s’affiche sous la quantité du palier correspondant. Ce champ est traduisible : renseignez-le dans chaque langue depuis le sélecteur de langue du formulaire.

Relance vers le palier suivant

Deux mécanismes d’encouragement sont disponibles, activables indépendamment.

Sur la fiche produit

Une barre de progression affiche un message du type « Ajoutez encore 3 unité(s) pour économiser 15 % », recalculé en temps réel selon la quantité saisie. Lorsque le client atteint le palier le plus avantageux, le message bascule sur « Vous bénéficiez de la meilleure remise ! ».

Sur la page panier

Pour chaque produit du panier dont un palier supérieur reste atteignable, le module affiche sous le panier un bloc « Ajoutez encore N unités pour passer à X € / unité », accompagné d’un bouton d’ajout en un clic. Le bouton utilise le mécanisme natif de mise à jour du panier de PrestaShop, puis rafraîchit la page. Si aucun palier supérieur n’est atteignable, aucun bloc n’est affiché.

Données structurées (JSON-LD)

Lorsque l’option est activée, le module ajoute sur la fiche produit un balisage JSON-LD de type AggregateOffer, avec une offre par palier et la quantité éligible associée. Cela permet aux moteurs de recherche de comprendre vos fourchettes de prix par quantité.

Statistiques de clics par palier

Quand l’option est activée, chaque clic sur un bouton d’ajout par palier est enregistré de façon anonyme : produit, déclinaison, quantité et remise du palier cliqué. Aucune donnée personnelle ni cookie n’est utilisé, ce qui rend la fonction conforme au RGPD.

La page de configuration affiche un tableau de bord des 30 derniers jours : nombre total de clics et top des combinaisons produit / palier / remise les plus cliquées. Ces données vous aident à calibrer vos remises en identifiant les paliers qui déclenchent réellement des ajouts au panier.

FAQ et dépannage

Le bloc ne s’affiche pas sur un produit

Vérifiez que le produit possède bien des prix spécifiques avec une quantité de départ supérieure à 1, et que ces prix s’appliquent au groupe client, à la devise et au pays courants. Le palier de base seul ne déclenche pas l’affichage s’il n’existe aucun palier de remise.

Le bouton d’ajout ne fonctionne pas avec mon thème

Le module s’appuie sur le bouton d’ajout au panier standard du thème Classic. Sur un thème fortement personnalisé, assurez-vous que le champ de quantité et le bouton d’ajout suivent le balisage standard de PrestaShop.

Fonctionne-t-il avec les déclinaisons ?

Oui. Les paliers sont recalculés pour chaque combinaison et le bloc se met à jour automatiquement au changement de déclinaison, sans rechargement de page.

Que se passe-t-il à la désinstallation ?

La désinstallation supprime proprement les hooks, les variables de configuration et la table de statistiques. Aucune donnée résiduelle n’est laissée en base.