Documentation

Installation, configuration et fonctionnement du module Empreinte Carbone (moteur matières → calcul → affichage).

Navigation

Démarrage

Le module calcule une empreinte carbone estimée à partir de matières (facteurs d’émission) liées aux produits avec un pourcentage de présence. Le résultat est mis en cache et peut être affiché sur la fiche produit et dans le panier/checkout.

  1. Créer des matières (facteur kgCO₂e/kg + source).
  2. Lier les matières aux produits (pourcentages).
  3. Vérifier le poids produit (champ “weight” PrestaShop) pour obtenir une empreinte par unité.

Si un produit n’a pas de matières liées ou un poids nul, l’empreinte affichée sera nulle (ou non affichée selon le hook).

Installation

Installation via le Module Manager (Back-office → Modules → Module Manager).

  1. Uploader le module (ZIP) puis installer.
  2. Configurer le module (prix par tonne, activation affichages, etc.).
  3. Accéder aux onglets Back-office du module pour gérer les matières et les liaisons.
  4. Optionnel : activer la page CMS “méthode de calcul” (lien “en savoir plus”).

Le module crée ses tables SQL à l’installation et peut créer un produit “compensation” (virtuel, caché) utilisé pour la facturation de la compensation.

Back-office

Le module ajoute un groupe “Empreinte carbone” dans le Back-office (Catalogue).

  • Onglet Matières : création/édition des matières (multilingue).
  • Onglet Liaisons produits / matières : associer des matières à un produit et gérer les pourcentages.

Chaque modification de liaison déclenche un recalcul de l’empreinte (cache).

Matières

Une matière contient un facteur d’émission (kgCO₂e/kg) et des métadonnées de source (libellé, URL, année) + un statut actif/inactif.

  • Nom et description multilingues.
  • Facteur d’émission au format décimal (les virgules sont converties).
  • Sources et notes pour traçabilité.

Depuis “Liaisons produits / matières”, vous pouvez sélectionner un produit, puis gérer une liste de matières avec un pourcentage de présence.

  • Vue d’ensemble : nombre de matières, somme des %, EF/kg, EF/unité (si cache disponible).
  • Édition par produit : mise à jour groupée des pourcentages.
  • Ajout rapide : ajouter/mettre à jour une matière avec un pourcentage.
  • Recalcul global : bouton “Recalculer toutes les empreintes”.

Si la somme des pourcentages dépasse 100%, le module ajuste les valeurs proportionnellement à 100% lors d’une mise à jour groupée.

Affichage front

Le module peut afficher une carte “empreinte carbone estimée” sur la fiche produit (selon configuration).

  • Empreinte par kg de produit : mix pondéré des matières.
  • Empreinte par unité : dépend du poids produit (weight).
  • Lien “en savoir plus” vers une page CMS optionnelle (si activée).

La carte peut être rendue via les hooks de fiche produit (selon votre thème). En cas de thème très personnalisé, un ajustement d’intégration peut être nécessaire.

Compensation checkout

Si activée, une option de compensation peut être proposée dans le panier/checkout sous forme de case à cocher. Le montant est calculé à partir du total d’empreinte du panier (kgCO₂e) et d’un prix par tonne (€/tCO₂e).

  • Activation/désactivation via AJAX (controller module).
  • Montant arrondi au centime (arrondi supérieur) + montant minimum optionnel.
  • Affichage d’un message de statut (succès/erreur) lors de la mise à jour.

Le script front met à jour certains sélecteurs de total panier : selon le thème/checkout, ces sélecteurs peuvent nécessiter un ajustement.

CSV & exports

Des fichiers CSV d’exemple sont copiés dans le répertoire d’import du Back-office pour faciliter un premier import.

  • Exemples : matières et liaisons produit/matières (fichiers “samples”).
  • Export CSV : “Exporter les empreintes produits (CSV)” depuis l’onglet liaisons.
  • Export inclut notamment : EF/kg, EF/unité, poids utilisé et date de calcul.

Les formats CSV exacts dépendent de votre mapping d’import PrestaShop. Les exemples servent de base de démarrage.

Multiboutique

Le module est compatible multiboutique (installation, configuration et affichage). Les empreintes sont mises en cache et utilisées côté boutique courante.

Recommandation : si vous utilisez des données différentes selon boutique (poids/liaisons), validez le comportement sur votre contexte multiboutique (tests).

FAQ

Je ne vois rien sur la fiche produit

Vérifiez que l’affichage front est activé, que le produit a des matières liées, et que les hooks sont présents dans votre thème. En dernier recours, testez sur le thème Classic.

L’empreinte est à 0

Vérifiez le poids produit (weight) et les liaisons matière (% + matière active). Sans matière liée ou sans poids, l’empreinte par unité peut être nulle.

Le total panier ne se met pas à jour

Le module met à jour des sélecteurs standards. Si votre thème modifie le checkout, un ajustement des sélecteurs JS peut être requis.

Je veux modifier le texte “compensation”

Le libellé de la case peut être configuré dans la configuration du module. Vous pouvez aussi modifier les traductions du module dans PrestaShop.

Les valeurs ont été ajustées à 100%

Lors d’une mise à jour groupée, si la somme des % dépasse 100, le module applique un ajustement proportionnel à 100%.

Note
Le module fait l’objet d’améliorations continues. Une revue fonctionnelle et technique peut être menée avant publication Addons (compatibilité checkout/thème, robustesse multiboutique, logs, etc.).