1. À quoi sert le module

Le module retient le prix de chaque produit au moment où le client l’ajoute à son panier. Si le client revient plus tard et que le prix a changé entre-temps — vous l’avez modifié, une promotion a pris fin ou a commencé —, le panier et la commande l’indiquent en haut de la page : « Le prix de T-shirt Hummingbird (Taille : M) est passé de 24,00 € à 29,00 € depuis que vous l’avez ajouté à votre panier. » À côté du produit, l’ancien prix apparaît barré.

Compatible avec PrestaShop 1.7.8, 8.x et 9.x (PHP 7.2.5 ou plus récent), avec les thèmes Classic et Hummingbird et avec le multiboutique.

2. Installation

  1. Téléchargez le module depuis Mon compte → Historique des commandes sur addonspresta.com.
  2. Dans votre back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
  3. Déposez le fichier ap_cartpricealert_v1.0.0.zip et attendez la confirmation.
  4. Cliquez sur Configurer sur la fiche du module.

Le module fonctionne dès l’installation : toutes les hausses et baisses de prix s’affichent dans le panier et dans la commande.

Si vous avez un accès en ligne de commande, vous pouvez aussi décompresser le fichier dans modules/, lancer php bin/console prestashop:module install ap_cartpricealert depuis le dossier de la boutique, puis vider le cache.

3. Fonctionnement

Le prix de référence. Quand le client ajoute un produit au panier, le module retient son prix unitaire tel que le client le voit à ce moment-là. Quand le client change la quantité d’un produit, ou en ajoute ou retire une autre déclinaison, le module reprend le prix actuel pour toutes les lignes de ce produit, car une remise sur quantité peut dépendre du nombre d’articles dans le panier. Les produits ajoutés pendant que le module était désactivé reçoivent leur référence à la prochaine modification du panier.

Ce qui compte comme un changement. Sur la page panier et pendant la commande, le module compare le prix unitaire actuel de chaque ligne à sa référence. Seuls les changements faits côté boutique comptent : le prix du produit, les prix spécifiques, les règles de prix catalogue, une promotion qui commence ou se termine, un nouveau taux de taxe. Les bons de réduction, les règles panier et les frais de port ne sont pas comparés, et les cadeaux offerts par une règle panier sont ignorés.

Ce qui est ignoré. Un prix qui diffère à cause d’une action du client lui-même ne déclenche pas d’alerte : le module prend discrètement le prix actuel comme nouvelle référence quand :

  • le client a changé de devise ;
  • le client s’est connecté (un visiteur devient client et peut obtenir les prix d’un autre groupe) ;
  • le pays de l’adresse servant au calcul des taxes a changé (International → Taxes → Basé sur : adresse de livraison ou de facturation ; sans adresse, le pays du visiteur) ;
  • le client a changé la quantité.

Combien de temps l’alerte reste affichée. L’alerte s’affiche à chaque visite du panier et de la commande, tant que le client n’a pas changé la quantité de ce produit (y compris en ajoutant ou en retirant une autre de ses déclinaisons), ne l’a pas retiré, n’a pas passé commande, ou tant que le prix n’est pas revenu à la référence. Le module n’ajoute aucun bouton pour la fermer définitivement ; la croix affichée par certains thèmes (Hummingbird) la masque seulement jusqu’à la page suivante. Passé le délai réglé dans Mémoriser les prix pendant, la ligne reprend discrètement le prix actuel comme nouvelle référence.

Où elle apparaît. En haut de la page panier et de la page de commande, dans la zone de notifications de votre thème, une entrée par produit modifié (une liste s’il y en a plusieurs). À côté du prix unitaire du produit, dans le panier et dans le récapitulatif de commande, le mot « Avant » et l’ancien prix barré. Quand le client change une quantité ou retire un produit sur la page panier, l’alerte de ce produit disparaît aussitôt, sans recharger la page. Une nouvelle alerte apparaît au prochain chargement de la page : les prix changent dans votre back-office, pas pendant que le client regarde son panier.

Réglages de la boutique pris en compte.

  • Taxes : les deux cas sont gérés — taxes activées ou désactivées dans International → Taxes, et prix TTC ou HT selon le groupe de clients (Clients → Groupes → Affichage des prix). Le module compare le prix tel que le client le voit : TTC pour un groupe « TTC », HT pour un groupe « HT ».
  • Mode catalogue (Paramètres de la boutique → Produits) : tant qu’il est activé, rien ne s’affiche.
  • Réafficher le panier après identification (Paramètres de la boutique → Clients) : quand PrestaShop rend à un client connecté le panier qu’il avait laissé, ce panier garde ses prix de référence, et un changement de prix survenu entre-temps s’affiche. Un panier rempli en tant que visiteur reçoit de nouveaux prix de référence quand le visiteur se connecte.
  • Les déclinaisons et les personnalisations sont gérées : chaque ligne (produit, déclinaison, personnalisation) a sa propre référence, et l’alerte indique la déclinaison, par exemple « T-shirt (Taille : M - Couleur : Blanc) ».

Ce que le module enregistre. Une table avec le prix de référence de chaque ligne de panier, effacé quand la ligne est retirée, quand la commande est passée et après la durée de conservation. Le module ne modifie jamais un prix, ne garde jamais l’ancien prix pour le client et ne bloque jamais une commande. Il ne modifie pas les tables natives de PrestaShop et ne se connecte ni à addonspresta.com ni à aucun autre serveur.

4. Fonctions et réglages

Ouvrez Modules → Gestionnaire de modules → Alerte prix du panier → Configurer. L’encadré Aide, en haut de la page, mène à ce manuel et à la page du module sur addonspresta.com dans la langue de votre back-office, donne notre adresse d’assistance et indique la version installée.

Activé

Active ou désactive le module dans la boutique sans le désinstaller. Désactivé, le module ne mémorise aucun prix et n’affiche aucune alerte. Par défaut : activé.

Changements à afficher

  • Hausses et baisses de prix (par défaut) : tous les changements.
  • Hausses de prix uniquement : pour prévenir le client seulement quand il paiera plus.
  • Baisses de prix uniquement : pour signaler seulement un meilleur prix.

Changement minimal

Le plus petit changement affiché, en pourcentage de l’ancien prix, de 0 à 100 avec deux décimales au plus (point ou virgule). Avec 0 (par défaut), tout changement d’au moins un centime — la plus petite unité de la devise — s’affiche. Avec 5, un T-shirt qui passe de 20,00 € à 20,90 € (4,5 %) ne déclenche rien, de 20,00 € à 21,00 € (5 %) il déclenche l’alerte.

Afficher dans le panier / Afficher dans la commande

Les pages où apparaissent l’alerte et l’ancien prix : la page panier et les étapes de la commande. Les deux sont activées par défaut.

Alerte en haut de la page

Place les alertes dans la zone de notifications de votre thème, en haut de la page panier et de la page de commande. Par défaut : activée. Désactivez-la si vous placez vous-même les alertes avec le widget {widget name='ap_cartpricealert'} dans un gabarit de votre thème, sinon elles s’affichent deux fois. Le widget affiche chaque alerte du panier en cours dans un encadré séparé, à l’endroit où vous le placez ; il suit Activé, Changements à afficher, Changement minimal et les messages, mais pas les choix de pages ci-dessus.

Ancien prix à côté du produit

Affiche le mot « Avant » et l’ancien prix barré à côté du prix unitaire d’un produit modifié, dans le panier et dans le récapitulatif de commande. Le texte prend le style de votre thème à cet endroit. Par défaut : activé.

Hausse de prix : type d’alerte / Baisse de prix : type d’alerte

Le type de notification de chaque sens : Avertissement, Information, Succès ou Erreur. La couleur de l’alerte vient de votre thème (dans Classic, par exemple, un avertissement est jaune et une erreur rouge). Par défaut : Avertissement pour une hausse, Information pour une baisse.

Message en cas de hausse / Message en cas de baisse

Le texte de l’alerte, dans chaque langue de la boutique. Par défaut :

  • hausse : « Le prix de {product} est passé de {old_price} à {new_price} depuis que vous l’avez ajouté à votre panier. »
  • baisse : « Bonne nouvelle : le prix de {product} a baissé de {old_price} à {new_price} depuis que vous l’avez ajouté à votre panier. »

Dans la boutique, ces variables sont remplacées par :

  • {product} : le nom du produit avec sa déclinaison, par exemple « T-shirt (Taille : M - Couleur : Blanc) » ;
  • {old_price} : le prix au moment de l’ajout ;
  • {new_price} : le prix actuel ;
  • {difference} : l’écart entre les deux, par exemple 5,00 € ;
  • {percent} : le changement en pourcentage de l’ancien prix, arrondi, par exemple 17 %.

Les prix s’affichent dans la devise du client, TTC ou HT selon son groupe. Un mot entre accolades qui ne figure pas dans cette liste reste tel quel. Le message est du texte brut : les balises HTML sont supprimées à l’enregistrement. Il peut contenir jusqu’à 500 caractères. Le texte dans la langue par défaut est obligatoire ; une langue laissée vide le reprend.

Mémoriser les prix pendant

Le nombre de jours de conservation d’un prix de référence, de 1 à 3650 ; 90 par défaut. Passé ce délai, la ligne prend le prix actuel comme nouvelle référence, sans alerte, et les anciens prix sont supprimés. Le nettoyage a lieu une fois par jour, à la première modification de panier de la journée : aucune tâche cron n’est nécessaire.

État

Le cadre sous le formulaire indique combien de lignes de panier ont un prix mémorisé dans la boutique choisie dans l’en-tête.

5. Multiboutique

Les réglages sont enregistrés pour la boutique ou le groupe choisi dans l’en-tête du back-office. Choisissez Toutes les boutiques pour appliquer les mêmes valeurs partout, ou une seule boutique pour lui donner ses propres messages, pages et seuils. Dans le contexte Toutes les boutiques ou groupe, seul un employé qui gère toutes ses boutiques peut enregistrer. Chaque panier garde ses prix de référence dans sa propre boutique, et le cadre État compte les lignes des boutiques choisies dans l’en-tête. Une licence couvre toutes les boutiques de l’installation.

6. Désinstallation

Gestionnaire de modules → Alerte prix du panier → Désinstaller supprime les réglages, les messages et la table des prix mémorisés. Pour les conserver, choisissez plutôt Désactiver.

7. Questions fréquentes et dépannage

J’ai changé un prix, mais aucune alerte n’apparaît dans le panier. Vérifiez dans l’ordre :

  • La référence est prise à l’ajout du produit ou au changement de sa quantité (y compris par l’ajout ou le retrait d’une autre déclinaison). Un produit ajouté après votre modification, ou dont la quantité a changé depuis, a déjà le nouveau prix comme référence.
  • Activé, Afficher dans le panier ou Afficher dans la commande, et Alerte en haut de la page doivent être activés.
  • Le changement doit atteindre le Changement minimal et aller dans un sens permis par Changements à afficher.
  • Changer de devise, se connecter ou choisir une adresse dans un autre pays donne une nouvelle référence sans alerte.
  • Le mode catalogue doit être désactivé.
  • Votre thème doit afficher les notifications en haut du panier. Sinon, utilisez le widget (voir plus bas).

L’alerte a disparu après la connexion du client. Un panier rempli en tant que visiteur reçoit de nouveaux prix de référence à la connexion, car un client connecté peut avoir d’autres prix (groupe de clients, pays). Un panier que le client a rempli en étant connecté et qu’il retrouve à sa connexion suivante (Réafficher le panier après identification) garde ses prix de référence et affiche l’alerte.

Mon thème n’a pas de notifications en haut du panier. Ajoutez {widget name='ap_cartpricealert'} dans le gabarit de votre thème, à l’endroit où les alertes doivent apparaître, par exemple au-dessus de la liste des produits du panier, et désactivez Alerte en haut de la page.

Les alertes s’affichent deux fois. Le widget et Alerte en haut de la page sont actifs en même temps. Désactivez Alerte en haut de la page ou retirez le widget.

Le module modifie-t-il les prix ou bloque-t-il les commandes ? Non. Il informe seulement le client. Le panier est calculé au prix actuel, et le client peut toujours commander.

Comment le client fait-il disparaître l’alerte ? En changeant la quantité du produit, en ajoutant ou en retirant une autre de ses déclinaisons, en retirant le produit ou en passant commande. Elle disparaît aussi si vous remettez l’ancien prix.

Un texte reste en anglais dans ma boutique en français. Remplissez les deux messages de cette langue dans la configuration du module. Le mot « Avant » à côté de l’ancien prix se traduit dans International → Traductions → Traductions des modules installés.

Puis-je modifier l’apparence de l’alerte ? Oui. Copiez views/templates/front/notification.tpl, views/templates/hook/was.tpl ou views/templates/widget/alerts.tpl dans themes/<votre-thème>/modules/ap_cartpricealert/ en gardant les mêmes sous-dossiers, puis modifiez la copie, ou ajoutez à votre thème des styles pour les classes .ap-cartpricealert__message et .ap-cartpricealert__was. Le module n’ajoute aucun style.

8. Mises à jour et assistance

Les mises à jour sont gratuites à vie : téléchargez les nouvelles versions depuis Mon compte → Historique des commandes sur addonspresta.com et installez-les comme un nouveau module. Vos réglages sont conservés.

L’assistance est incluse pendant un an à compter de la commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact d’addonspresta.com (du lundi au vendredi, de 10 h à 16 h ; réponse généralement sous 2 jours ouvrés). Indiquez votre version de PrestaShop, la version du module et les étapes qui mènent au problème.

Vous disposez de 30 jours après la commande pour retourner le module, comme le prévoit la Politique de vente et de licence d’addonspresta.com. Le code du module passe notre audit de sécurité assisté par l’IA.

Retour : Manuels des modules

Chargement...
Retour en haut