Arrondi Solidaire & Don au Checkout — Guide complet
Installer, configurer et exploiter l'arrondi solidaire et le microdon caritatif au checkout (trois modes, don sans TVA, suivi des dons) pour PrestaShop 8 et 9.
Présentation
Le module Arrondi Solidaire & Don au Checkout (dfsolidarityround) permet à vos clients de soutenir une association en quelques secondes, directement dans le panier : en arrondissant leur commande à l’euro supérieur, en choisissant un montant de don prédéfini, ou en saisissant un montant libre. Le don s’intègre proprement au total — TVA, devise et multiboutique étant gérés par le cœur de PrestaShop, jusqu’à la facture.
Le don n’est pas un simple affichage : il est porté par un produit virtuel dédié et un prix spécifique limité au panier du client. Le montant se retrouve donc naturellement dans les totaux, la commande et la facture.
Compatibilité
- PrestaShop 8.0 à 9.x
- Mono-boutique et multiboutique
- PHP 7.4 à 8.3
- Thème Classic et thèmes personnalisés
- Interface livrée en français, anglais, espagnol, allemand et italien
- Aucune dépendance (ni Composer ni framework)
Installation
- Dans le back-office, ouvrez Modules > Gestionnaire de modules.
- Cliquez sur Installer un module puis sélectionnez le fichier
dfsolidarityround.zip. - Une fois installé, cliquez sur Configurer.
À l’installation, le module crée sa table d’historique, enregistre ses hooks (ressources front, bloc au panier et au checkout, validation de commande), ajoute l’onglet back-office Dons solidaires et génère un produit virtuel caché « Don solidaire » : non visible en boutique, sans TVA, sans frais de livraison. C’est lui qui porte le montant du don dans le panier. Ne le supprimez pas manuellement.
Configuration
Modes de don
Trois modes sont disponibles et s’activent indépendamment. Vous pouvez n’en proposer qu’un seul, ou les trois à la fois.
- Arrondi à l’euro supérieur : propose au client de porter sa commande au montant rond supérieur. Le pas d’arrondi est configurable (
1,00pour l’euro supérieur,0,50pour le demi-euro, etc.). - Montants fixes : affiche des boutons prêts à cliquer. La liste des montants est configurable (par exemple
1;2;5). - Montant libre : laisse le client saisir la somme de son choix, encadrée par un don minimum et un don maximum.
En mode arrondi, si le total du panier est déjà un montant rond, le module propose un don d’un pas complet pour que l’opt-in du client ait toujours du sens.
Personnalisation de l’association
- Titre du bloc : intitulé affiché en tête du bloc (champ multilingue).
- Nom de l’association : nom de la cause soutenue (champ multilingue).
- Description : court texte d’accompagnement (champ multilingue).
- Logo de l’association : visuel affiché dans le bloc (PNG, JPG, GIF, WEBP ou SVG).
Emplacements d’affichage
- Afficher sur la page Panier : affiche le bloc au bas de la page panier (emplacement principal et fiable).
- Afficher dans le tunnel de commande : affiche le bloc dans le récapitulatif de commande, si votre thème expose l’emplacement correspondant.
Fonctionnement côté client
Arrondi à l’euro supérieur
Le client voit un bouton du type « Arrondir et donner 0,73 € ». Le montant proposé correspond à la différence entre son total et le montant rond supérieur, selon le pas configuré.
Montants fixes
Le client clique sur l’un des montants proposés (1 €, 2 €, 5 €…). Le don correspondant est ajouté immédiatement.
Montant libre
Le client saisit le montant de son choix puis valide. La valeur est contrôlée par rapport au minimum et au maximum définis.
Une fois le don ajouté, le bloc affiche un remerciement et un lien « Retirer le don ». Le client garde la main : il peut changer de montant ou retirer son don à tout moment avant le paiement.
Comment le don est ajouté au panier
À chaque choix, le module crée un prix spécifique (SpecificPrice) limité au panier courant (id_cart) et l’applique au produit virtuel « Don solidaire ». Ce produit est ajouté au panier lorsque le montant est supérieur à zéro, retiré sinon. PrestaShop applique alors la devise et le contexte multiboutique, et le don apparaît comme une ligne claire dans les totaux, la commande et la facture.
Recalcul automatique de l’arrondi
En mode arrondi, le montant du don est recalculé à chaque affichage du bloc. Ainsi, si le client modifie son panier après avoir choisi l’arrondi, le don reste cohérent avec le nouveau total jusqu’au paiement.
Don sans TVA
Le produit « Don solidaire » est créé sans règle de taxe : le montant affiché et collecté correspond exactement au geste du client, sans surprise de TVA.
Suivi des dons en back-office
Un onglet Dons solidaires est ajouté sous Commandes (contrôleur AdminDfDonations). Il liste chaque don avec :
- le montant du don ;
- le mode utilisé (arrondi, montant fixe ou montant libre) ;
- le client et la commande associée ;
- la date du don.
Un bandeau de synthèse affiche le total collecté et le nombre de dons. Le don est figé dans l’historique à la validation de la commande (actionValidateOrder).
Reversement à l’association
Le module ne reverse pas automatiquement les dons à l’association : c’est volontaire. Il collecte les dons au sein de vos commandes et vous fournit le total et l’historique. Vous gardez la main sur le moment et le canal de reversement à votre association partenaire, selon votre propre process.
Compatibilité PrestaShop 9
Le module est conçu et testé de PrestaShop 8.0 à 9.x :
- le contrôleur back-office utilise
ModuleAdminController, compatible 8 et 9 ; - le code évite les méthodes supprimées en PrestaShop 9 (jeton AJAX et formatage de prix portables) ;
- le contrôleur AJAX renvoie directement du JSON, sans override de signature incompatible.
FAQ et dépannage
Le bloc ne s’affiche pas dans le tunnel de commande
Le bloc s’affiche de façon fiable au bas de la page panier. Dans le récapitulatif de commande, l’affichage dépend du thème, qui doit exposer l’emplacement correspondant. Le don choisi sur la page panier est de toute façon conservé jusqu’au paiement.
Le total n’est pas mis à jour après le clic
Le bloc déclenche un rafraîchissement du panier après l’ajout ou le retrait du don. Videz le cache de PrestaShop, puis rechargez la page. Vérifiez aussi que le produit « Don solidaire » n’a pas été supprimé manuellement.
La boutique devient blanche après installation
Assurez-vous d’utiliser la dernière version du module et videz le cache. Le produit de don est volontairement non visible en boutique ; ne le rendez pas visible et ne le supprimez pas manuellement.
Le don d’arrondi me semble incorrect
Vérifiez le pas d’arrondi configuré. En mode arrondi, le don est recalculé à chaque affichage du bloc à partir du total hors don ; si le panier change, le montant est ajusté automatiquement.
Comment traduire le bloc dans une autre langue ?
Le titre, le nom de l’association et la description sont des champs multilingues : sélectionnez chaque langue dans la configuration pour les traduire. Les libellés d’interface se traduisent via Paramètres avancés > Traductions > Traductions des modules installés, en choisissant dfsolidarityround.
Est-ce compatible PrestaShop 9 ?
Oui. Le module est conçu et testé de PrestaShop 8.0 à 9.x, en mono-boutique comme en multiboutique.
Désinstallation
La désinstallation supprime le produit « Don solidaire », l’onglet back-office et la table d’historique des dons. Si vous souhaitez conserver l’historique, désactivez le module sans le désinstaller.