PS PrestaShop Intermédiaire

Smart Offers — Documentation complète

Configurer et exploiter Offres groupées sur PrestaShop 1.7.8, 8 et 9 : achetez X recevez Y, cadeaux de lot, offres au choix et lots, appliqués automatiquement et en toute sécurité dans le panier.

Mis à jour Version du module 3.0.0

Offres groupées vous permet de proposer les quatre promotions groupées les plus courantes sur PrestaShop : achetez X recevez Y du même produit, un cadeau pour des produits achetés ensemble, des offres au choix parmi une sélection et des lots. Le module ajoute les articles récompenses au panier, applique la remise et présente l’offre sur la fiche produit et dans le panier, sur PrestaShop 1.7.8, 8 et 9.

Nouveau en 3.0 : remise au choix (offert ou pourcentage), ajout automatique facultatif, plafond par panier, groupes de clients, tableau de bord avec résultats par offre, éditeur avec aperçu en direct, panier qui indique ce qui manque pour débloquer une offre, et moteur renforcé (une règle panier par produit remisé, codes non réutilisables, jamais de double remise).

Compatibilité

Élément Pris en charge
PrestaShop 1.7.8, 8.0 à 8.2, 9.0 et suivantes (un seul ZIP)
PHP 7.2 et plus (la version requise par votre PrestaShop s’applique)
Thèmes Classic, Hummingbird et leurs thèmes enfants
Multiboutique, multidevise, déclinaisons Oui
Langues anglais, français, espagnol, allemand, italien, polonais, néerlandais, portugais

Installation et mise à jour

  1. Dans le back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
  2. Déposez le fichier dfoffers-3.0.0.zip.
  3. Le module apparaît dans Catalogue → Réductions → Offres groupées, à côté des règles panier.

Mise à jour depuis la 2.x : envoyez le nouveau ZIP par-dessus l’ancien. Vos offres, produits, traductions et boutiques sont conservés. Le script de mise à jour ajoute les nouvelles options, déplace l’entrée de menu et sécurise les règles panier déjà créées par la 2.x (plus aucun bon d’achat de reliquat ne peut être généré).

Le tableau de bord

La page Offres affiche les offres en cours, les commandes valides qui ont utilisé une offre sur les 30 derniers jours, leur chiffre d’affaires et la remise accordée. Chaque offre présente sa règle en clair, son statut (en cours, programmée, terminée, désactivée), ses dates, ses commandes et sa remise. Vous pouvez rechercher, filtrer par statut, activer ou désactiver en un clic, dupliquer, supprimer et appliquer des actions groupées.

Tableau de bord Offres groupées dans le back-office PrestaShop : offres en cours, commandes, chiffre d'affaires et remise par offre
Tableau de bord Offres groupées dans le back-office PrestaShop : offres en cours, commandes, chiffre d’affaires et remise par offre

Les quatre types d’offres

  • Achetez X, recevez Y du même produit : le classique 1+1 ou 2+1. Chaque produit de la liste a sa propre offre ; laissez « toutes déclinaisons » pour compter toutes ses variantes ensemble.
  • Achetez des produits ensemble, recevez un cadeau : tous les produits déclencheurs doivent être dans le panier, les produits récompenses sont alors offerts ou à prix réduit.
  • Au choix parmi une sélection : le client choisit N articles parmi des produits ou des déclinaisons, les moins chers sont offerts ou remisés (3 pour 2 sur tous les mugs, par exemple).
  • Lot : pour chaque lot de X unités d’un produit, le client reçoit Y unités d’un autre produit.

Créer une offre

Cliquez sur Nouvelle offre, ou choisissez l’un des quatre modèles quand aucune offre n’existe encore. L’éditeur compte cinq étapes et, à droite, un aperçu en direct de la bannière produit et un récapitulatif de la règle en clair.

  1. Type d’offre : l’une des quatre cartes. Seuls les champs utiles s’affichent.
  2. Produits et quantités : ajoutez les produits avec la fenêtre de recherche, par nom, référence ou ID. Pour un produit à déclinaisons, ajoutez-le pour toutes ses déclinaisons ou choisissez-en une ou plusieurs.
  3. Récompense : offert (100 %) ou pourcentage (50 pour « le deuxième à moitié prix »), ajout automatique au panier ou non, répétition à chaque lot complet, maximum par panier.
  4. Affichage : nom, texte du badge et texte complémentaire dans chaque langue, couleur de l’offre. La couleur du texte du badge est choisie automatiquement pour rester lisible.
  5. Disponibilité : statut, dates de début et de fin, priorité, groupes de clients et boutiques.
Éditeur d'offre avec les quatre types d'offres et l'aperçu en direct de la bannière produit
Éditeur d’offre avec les quatre types d’offres et l’aperçu en direct de la bannière produit
Recherche de produit de l'éditeur d'offre avec sélection des déclinaisons en un clic
Recherche de produit de l’éditeur d’offre avec sélection des déclinaisons en un clic

Quand les articles récompenses ne sont pas ajoutés automatiquement, le client les ajoute lui-même et la remise s’applique dès qu’ils sont dans le panier ; le panier lui rappelle alors la récompense qui l’attend.

Produits, taille du lot et réglages de la récompense d'une offre par lot : -50 %, ajout manuel, plafond par panier
Produits, taille du lot et réglages de la récompense d’une offre par lot : -50 %, ajout manuel, plafond par panier
Le formulaire revérifie tout côté serveur : les produits inconnus et les déclinaisons d’un autre produit sont écartés, et en cas d’erreur tout ce que vous avez saisi est conservé.

La bannière de la fiche produit

Sur chaque produit concerné, une bannière présente l’offre avec les produits à acheter et la récompense, le prix habituel barré à côté des articles offerts ou remisés, la date de fin de l’offre, et l’état « Appliquée dans votre panier » dès que le client en profite. Elle s’adapte aux colonnes étroites et au mobile.

Bannière 1 acheté = 1 offert sur une fiche produit PrestaShop
Bannière 1 acheté = 1 offert sur une fiche produit PrestaShop
Bannière 3 pour 2 au choix : l'article le moins cher de la sélection est offert
Bannière 3 pour 2 au choix : l’article le moins cher de la sélection est offert
Bannière d'offre groupée : un pull et un coussin achetés, le carnet offert
Bannière d’offre groupée : un pull et un coussin achetés, le carnet offert
Bannières d'offres sur une fiche produit mobile
Bannières d’offres sur une fiche produit mobile

Le panier

Sous les lignes du panier, le client voit les offres appliquées avec le montant économisé et les articles reçus. Un badge (« Offert ×1 », « 1 à -50 % ») signale les lignes qui contiennent des unités remisées, dans le panier et dans le récapitulatif de commande. Le bloc se met à jour après chaque changement de quantité, sur Classic comme sur Hummingbird.

Panier avec trois offres appliquées : articles offerts ajoutés, badges sur les lignes et économie par offre
Panier avec trois offres appliquées : articles offerts ajoutés, badges sur les lignes et économie par offre

Vous y êtes presque liste ce qui manque pour débloquer une offre (« Ajoutez 1 × T-shirt »), et Une récompense vous attend rappelle au client d’ajouter une récompense qui n’est pas ajoutée automatiquement.

Aides du panier : ce qui manque pour débloquer une offre et une récompense à ajouter
Aides du panier : ce qui manque pour débloquer une offre et une récompense à ajouter

Si le client retire un cadeau, il n’est pas réimposé : l’offre est mise de côté et un bouton Le remettre s’affiche. Pour un « achetez X, recevez Y » sur le même produit, les unités retirées sont d’abord les offertes : le client ne perd jamais une unité payée.

Cadeau retiré par le client : le panier propose de le remettre
Cadeau retiré par le client : le panier propose de le remettre

Réglages

  • Position de la bannière : sous le bouton Ajouter au panier (recommandé), juste sous le prix, sous les images, dans le bloc de réassurance ou pleine largeur sous la description.
  • Bannière compacte, prix dans la bannière et date de fin.
  • Panier : afficher ce qui manque pour débloquer une offre, badge sur les lignes du panier.
  • Journal de débogage : écrit chaque calcul de panier dans Paramètres avancés → Logs ; à laisser désactivé en production.
  • Maintenance : nombre de règles panier créées par le module et nettoyage de celles des paniers abandonnés.
Réglages du module : position de la bannière, mode compact, prix, date de fin, aides du panier et maintenance des règles panier
Réglages du module : position de la bannière, mode compact, prix, date de fin, aides du panier et maintenance des règles panier

Fonctionnement du moteur

  1. À chaque modification du panier (et à l’affichage du panier ou du tunnel de commande), le module lit le panier et distingue les unités payées par le client de celles qu’il a ajoutées lui-même.
  2. Les offres sont évaluées par priorité (1 d’abord). Une unité utilisée par une offre n’est pas réutilisée par une autre : un même article n’est jamais remisé deux fois.
  3. Pour chaque offre applicable, les récompenses manquantes sont ajoutées (si vous l’avez choisi) et une règle panier par produit remisé est créée ou mise à jour (code DFOFFER_…).
  4. Les offres qui ne s’appliquent plus sont retirées : unités ajoutées reprises, règles panier supprimées.

Sécurité et taxes

  • Tout est calculé côté serveur à partir du panier et de vos offres ; rien de ce qu’envoie le navigateur n’entre dans un prix.
  • Chaque règle panier est limitée au produit remisé : elle ne peut jamais dépasser ce que le client a de ce produit dans le panier, et le taux de TVA de ce produit s’applique à la remise, y compris sur la facture.
  • Les règles ne génèrent jamais de bon d’achat de reliquat, n’apparaissent pas dans « Mes bons de réduction », et un code copié depuis un autre panier est retiré avant le paiement.
  • Une récompense en rupture ou désactivée n’est pas remisée. Une commande déjà passée n’est jamais modifiée.
  • Les actions du back-office respectent les droits de l’onglet par employé (voir, ajouter, modifier, supprimer).

Les règles panier des paniers abandonnés depuis 30 jours sont supprimées automatiquement une fois par jour à l’ouverture du module ; celles utilisées par une commande sont toujours conservées pour votre comptabilité.

Aide et dépannage

L’onglet Aide du module explique le fonctionnement et répond aux questions les plus fréquentes.

  • La bannière ne s’affiche pas : vérifiez que l’offre est activée, dans ses dates, ouverte au groupe de clients et à la boutique, et que le produit est actif. Essayez ensuite une autre position de bannière : certains thèmes n’appellent pas tous les hooks.
  • Un de vos bons est refusé avec une offre : un bon réglé « non cumulable avec d’autres règles panier » peut refuser la combinaison ; adaptez-le dans Catalogue → Réductions.
  • Le badge manque sur les lignes du panier : votre thème doit contenir {hook h='displayProductPriceBlock' product=$product type="unit_price"} ou {hook h='displayCartExtraProductActions' product=$product} dans le gabarit de ligne du panier.
Aide intégrée : fonctionnement, les quatre types d'offres et la FAQ sur la sécurité et les taxes
Aide intégrée : fonctionnement, les quatre types d’offres et la FAQ sur la sécurité et les taxes

Détails techniques

  • Hooks : displayProductAdditionalInfo (ou la position choisie), displayProductPriceBlock, displayAfterProductThumbs, displayReassurance, displayFooterProduct, displayShoppingCartFooter, displayCartExtraProductActions, actionCartSave, actionFrontControllerSetMedia, actionObjectProductDeleteAfter, actionObjectCombinationDeleteAfter.
  • Tables : ps_dfoffers_offer, _offer_lang, _trigger, _reward, _shop, _cart_auto, _rule, _cart_declined.
  • Gabarits surchargeables dans votre thème : views/templates/hook/product-banner.tpl, cart-offer.tpl, cart-line-gift.tpl. Les classes CSS utilisent le préfixe dfoffers-.
  • Aucun override, aucune tâche cron, aucun service externe. La désinstallation supprime les offres et les règles panier inutilisées ; celles utilisées par des commandes sont conservées.
Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support