Wo WooCommerce Beginner

Carbon Footprint + Offset Checkout: volledige handleiding

Versie 2.0 installeren en gebruiken: installatieassistent, bijdragebedrag, projecten en overboekingen, emissiefactoren en methode, productgegevens, weergave, klantteksten en formuleringscontrole, afrekenen met blokken, register, transparantiepagina, migratie vanaf 1.x en tools voor ontwikkelaars.

Bijgewerkt Moduleversie 2.0.0

Overzicht

DataFirefly – Klimaatbijdrage schat de broeikasgasemissies van je WooCommerce-producten en laat klanten bij het afrekenen een bijdrage aan klimaatprojecten toevoegen. Elke bijdrage wordt vastgelegd in een register dat de bestelling volgt, elke overboeking naar een project wordt bewaard met het bewijsstuk, en een transparantiepagina laat klanten zien wat er wordt ingezameld, waar het naartoe gaat en hoe het wordt berekend.

Versie 2.0 voegt toe: het afrekenen met blokken, het register, projecten en overboekingen, een installatieassistent, een dashboard, aanpasbare emissiefactoren met hun bronnen, een formuleringscontrole in acht talen en een tab “Klimaatbijdragen” in Mijn account.

DataFirefly Klimaatbijdrage – Dashboard: ingezamelde en overgemaakte bedragen, deelname, maandgrafiek, productgegevens en tekstcontrole
Dashboard: ingezamelde en overgemaakte bedragen, deelname, maandgrafiek, productgegevens en tekstcontrole

Kort gezegd: installeer de plugin, volg de installatieassistent, controleer de emissiefactoren die je gebruikt in Klimaat > Methode & factoren, publiceer de transparantiepagina en registreer daarna elke overboeking naar je project met het bewijsstuk.

Installatie en update

  1. Kies in Plugins > Nieuwe plugin toevoegen > Plugin uploaden het bestand df-carbon-offset-2.0.0.zip en activeer daarna DataFirefly – Klimaatbijdrage.
  2. De installatieassistent wordt geopend. Je kunt er op elk moment naar terugkeren met de knop Installatieassistent in het menu Klimaat.

Vereisten: WordPress 6.4 of hoger, WooCommerce 8.2 of hoger, PHP 7.4 tot en met 8.5. De plugin is compatibel met HPOS en met de blokken Winkelwagen en Afrekenen.

Updaten vanaf 1.x: upload het nieuwe zipbestand en kies Huidige vervangen door geüploade. Instellingen, factoren, categoriekoppelingen en bijdragen blijven behouden; de Climatiq-sleutel wordt verplaatst naar een beveiligde optie; er wordt een project aangemaakt op basis van je vroegere “aanbieder”, zodat je het kunt aanvullen. Bijdragen die met 1.x via het afrekenen met blokken in rekening zijn gebracht maar nooit zijn vastgelegd, worden opgespoord en aan het register toegevoegd.

Installatieassistent

Vijf korte stappen:

  1. Bijdrage — hoe het bedrag wordt berekend (zie hieronder) en het minimum.
  2. Project — het project dat de bijdragen ontvangt: naam, partner, type, standaard, land, link naar het openbare register en beschrijving.
  3. Productgegevens — een emissiefactor voor elke productcategorie, vooraf geselecteerd op basis van de categorienamen.
  4. Weergave — geschatte uitstoot op productpagina’s, drempel voor de datakwaliteit, stijl, tab in Mijn account.
  5. Transparantie — maakt de transparantiepagina aan als concept en toont wat er nog moet gebeuren voordat je live gaat.
DataFirefly Klimaatbijdrage – Installatiehulp in vijf stappen: bedrag, project, productgegevens, weergave, transparantie
Installatiehulp in vijf stappen: bedrag, project, productgegevens, weergave, transparantie

De bijdrage bij het afrekenen

De optie verschijnt in het besteloverzicht van het afrekenen met blokken, of boven de betaalmethoden van het klassieke afrekenen (en optioneel op de winkelwagenpagina). Ze is nooit vooraf geselecteerd en wordt bij elke bestelling opnieuw gevraagd. Als de klant de optie aanvinkt, wordt er een regel Klimaatbijdrage aan de bestelling toegevoegd; uitvinken verwijdert de regel weer. “Hoe wordt dit berekend?” toont de formule, het project en een link naar de transparantiepagina.

DataFirefly Klimaatbijdrage – Vrijwillige bijdrage aan klimaatprojecten bij het afrekenen met WooCommerce-blokken
Vrijwillige bijdrage aan klimaatprojecten bij het afrekenen met WooCommerce-blokken

Kies hoe het bedrag wordt berekend in Klimaat > Instellingen > Bijdrage:

  • Op basis van de geschatte uitstoot — uitstoot van de bestelling × prijs per ton. Gebruik de prijs die je partner werkelijk rekent, zodat het bedrag overeenkomt met wat er wordt gefinancierd.
  • Vast bedrag — hetzelfde bedrag voor elke bestelling.
  • Naar boven afronden — het totaal van de bestelling, naar boven afgerond op de volgende 1, 2, 5 of 10.
  • Percentage — een deel van het productentotaal.

Minimum, maximum en afronding (0,01 tot 1) gelden voor de eerste, tweede en vierde manier. De bijdrage is standaard niet belastbaar; je kunt haar belastbaar maken met een belastingklasse naar keuze, waarna het bedrag dat de klant ziet inclusief belasting is. De fiscale behandeling hangt af van je land en van hoe je het geld doorgeeft: vraag het aan je accountant.

DataFirefly Klimaatbijdrage – Instellingen van de bijdrage: vier manieren om het bedrag te berekenen, met live voorbeeld
Instellingen van de bijdrage: vier manieren om het bedrag te berekenen, met live voorbeeld

Het voorbeeld rechts wordt bijgewerkt terwijl je typt, met een voorbeeldbestelling.

Na de betaling ziet de klant een bedankbericht, de bijdrage in de bestelmails en de tab Klimaatbijdragen in Mijn account.

DataFirefly Klimaatbijdrage – Mijn account: de klimaatbijdragen van de klant
Mijn account: de klimaatbijdragen van de klant

Projecten en overboekingen

Beschrijf in Klimaat > Projecten & overboekingen elk project dat je financiert. Klanten zien het project bij het afrekenen en op de transparantiepagina, dus houd je aan controleerbare feiten: wie het beheert, volgens welke standaard (Gold Standard, Verra VCS, Label Bas-Carbone, Puro.earth…), waar, en de link naar de vermelding in een openbaar register. Eén project ontvangt de nieuwe bijdragen; de andere kunnen actief blijven voor de weergave of worden gedeactiveerd.

Klik elke keer dat je een project betaalt op Overboeking registreren: datum, bedrag en valuta, de gecertificeerde tonnen die op het certificaat van de partner staan (optioneel), de referentie en een link naar het bewijsstuk. Het paneel toont per valuta wat er is ingezameld, wat er is overgemaakt en wat er nog over te maken is.

DataFirefly Klimaatbijdrage – Gesteunde projecten en overboekingen naar de projecten met bewijsstukken
Gesteunde projecten en overboekingen naar de projecten met bewijsstukken

De plugin koopt geen CO₂-credits. Ze zamelt de bijdragen samen met de bestellingen in. Maak de bedragen over aan je project en registreer elke overboeking: dat is het bewijs dat je klanten kunnen controleren.

Schattingen van de uitstoot en methode

Voor elk product is de schatting:

productie = gewicht (kg) × factor van de categorie    (of factor per artikel, of waarde van het product)
levering  = gewicht (t) × afstand (km) × transportfactor (kg CO₂e / t·km)
schatting = productie + levering

De factor wordt in deze volgorde bepaald: uit de waarde die bij de variatie of het product is ingevuld (met de bron), uit de factor die bij het product is gekozen, uit de factor van de productcategorie (variaties gebruiken de categorieën van hun product), of uit de generieke factor als je dat toestaat. Voor een factor per liter moet het volume bij het product zijn ingevuld.

DataFirefly Klimaatbijdrage – Methode en emissiefactoren: formule, factor per productcategorie en datakwaliteit
Methode en emissiefactoren: formule, factor per productcategorie en datakwaliteit

In de tab Emissiefactoren heeft elke factor een waarde, een basis (per kg, per stuk, per liter, per tonkilometer), een bron, een referentie, een link en een jaar. De standaardwaarden zijn indicatieve ordes van grootte. Vergelijk de factoren die je gebruikt met een gepubliceerde bron — bijvoorbeeld de ADEME Base Empreinte of de levenscyclusanalyses van je leveranciers —, vul de referentie in en vink Ik heb deze waarde gecontroleerd aan de hand van de bovenstaande bron aan. Met een Climatiq-sleutel (Instellingen > Gegevens & API) kun je de waarde van een factor importeren op basis van de activiteits-ID; je controleert die waarde nog steeds vóór gebruik.

De tab Te controleren producten toont de producten zonder schatting (geen gewicht, geen factor) of waarvan de schatting niet goed genoeg is om te worden getoond.

Levering: stel in Instellingen > Levering de gemiddelde afstand, de vervoerswijze en optioneel een afstand per verzendzone in.

Wat klanten zien op productpagina’s

De geschatte uitstoot per stuk verschijnt in een neutraal blok (kaart, regel of alleen tekst), met “Hoe wordt dit geschat?”, dat de factor, de bron, de aanname voor de levering en de datakwaliteit toont. Een optionele vergelijking met een autorit gebruikt de factor van ADEME Impact CO2 (standaard 0,142 kg CO₂e per km).

DataFirefly Klimaatbijdrage – Productpagina: geschatte uitstoot met de methode en de datakwaliteit
Productpagina: geschatte uitstoot met de methode en de datakwaliteit

De schatting wordt alleen getoond als de datakwaliteit de drempel uit Instellingen > Weergave bereikt — standaard een gecontroleerde factor of een waarde die voor het product is ingevuld. Je kunt het blok bij een product verbergen (tab Klimaat van het product) of het zelf plaatsen met het blok Geschatte uitstoot van product of de shortcode [dfcarbon_badge].

Klantteksten en formuleringscontrole

In Instellingen > Klantteksten kun je de titel en de tekst van het selectievakje van de optie wijzigen, evenals de transparantievermelding, de naam van de bestelregel, het bedankbericht en de titel van het productblok. Laat een veld leeg om de standaardtekst te behouden, vertaald in de taal van elke klant. Met Polylang of WPML worden je teksten geregistreerd voor vertaling.

Elke tekst, en elke projectnaam en -beschrijving, wordt tijdens het typen gecontroleerd, in acht talen:

  • Niet toegestaan — claims dat een product dankzij compensatie een neutrale, verminderde of positieve impact heeft (“CO₂-neutraal”, “we compenseren je voetafdruk”, “net-zero levering”…), sinds 27 september 2026 verboden in de EU.
  • Te onderbouwen — algemene milieuclaims (“milieuvriendelijk”, “groene keuze”…) die erkende uitmuntende milieuprestaties vereisen.
  • Label — formuleringen die lijken op een zelfbedacht duurzaamheidslabel.
DataFirefly Klimaatbijdrage – Tekstcontrole: een verboden claim gemarkeerd tijdens het typen (EU-richtlijn 2024/825)
Tekstcontrole: een verboden claim gemarkeerd tijdens het typen (EU-richtlijn 2024/825)

De controle helpt je om nauwkeurig te formuleren; het is geen juridisch advies. Laat je teksten controleren door een jurist, vooral in Frankrijk, waar de omzetting van Richtlijn (EU) 2024/825 in november 2026 nog in behandeling was.

Dashboard en register

Het dashboard toont de ingezamelde bedragen (bevestigde bijdragen, na aftrek van terugbetalingen) en de bedragen die op betaling wachten, wat er nog over te maken is, het aantal en het gemiddelde van de bijdragen, het deelnamepercentage over 30 dagen, de gecertificeerde tonnen volgens je bewijsstukken van overboekingen, een maandgrafiek met de bijbehorende gegevenstabel, de dekking van de productgegevens, de controle van formuleringen en een checklist voor de configuratie.

In Klimaat > Bijdragen toont het register elke bijdrage met de bestelling, het bedrag, de terugbetalingen, de geschatte uitstoot, de datakwaliteit, het project en de status: Wacht op betaling, Bevestigd, Geannuleerd, Terugbetaald of Verwijderd uit de bestelling. Het register volgt de bestelling automatisch, inclusief gedeeltelijke terugbetalingen van de bijdrageregel. Filter op status, project, datums of bestelnummer en exporteer naar CSV.

DataFirefly Klimaatbijdrage – Register van bijdragen met status van betaling, annulering en terugbetaling, CSV-export
Register van bijdragen met status van betaling, annulering en terugbetaling, CSV-export

Transparantiepagina, blokken en shortcodes

De assistent maakt een pagina aan met twee blokken: Rapport klimaatbijdragen (ingezamelde en overgemaakte bedragen, projecten, overboekingen met bewijsstukken) en Berekeningsmethode van de uitstoot (formule, bijdrage, gebruikte factoren en hun bronnen). Controleer de pagina, publiceer haar en selecteer haar in Instellingen > Weergave: het afrekenen, het productblok, het bedankbericht en Mijn account linken ernaar.

DataFirefly Klimaatbijdrage – Transparantiepagina: ingezamelde en overgemaakte bedragen, projecten, overboekingen en methode
Transparantiepagina: ingezamelde en overgemaakte bedragen, projecten, overboekingen en methode
  • [dfcarbon_impact figures="yes" projects="yes" transfers="yes"] — transparantierapport.
  • [dfcarbon_methodology] — berekeningsmethode.
  • [dfcarbon_badge id="123" style="card"] — geschatte uitstoot van een product (card, inline of minimal).
  • [dfcarbon_projects], [dfcarbon_cart_summary] en [dfcarbon_stats] (alleen cijfers, behouden uit 1.x).
DataFirefly Klimaatbijdrage – Bijdrageoptie bij het afrekenen op een telefoon
Bijdrageoptie bij het afrekenen op een telefoon

Ontwikkelaars

  • REST API: GET /wp-json/dfcarbon/v1/impact (openbare cijfers, geen persoonsgegevens), GET /dfcarbon/v1/products/<id>/footprint (alleen schattingen die mogen worden getoond), GET /dfcarbon/v1/contributions en POST /dfcarbon/v1/check-text (winkelmanagers).
  • WP-CLI: wp dfcarbon status, wp dfcarbon product <id>, wp dfcarbon sync <order>, wp dfcarbon reconcile, wp dfcarbon check-text "<text>".
  • Filters: dfcarbon_product_footprint, dfcarbon_contribution_amount, dfcarbon_convert_amount (meerdere valuta), dfcarbon_capability, dfcarbon_template.
  • Sjablonen: kopieer een bestand uit templates/ naar yourtheme/df-carbon-offset/.
  • Een Sitediagnose-test, een exportfunctie voor persoonsgegevens en een voorgestelde tekst voor het privacybeleid zijn inbegrepen.

Deïnstalleren

Als je de plugin verwijdert, blijven alle gegevens behouden, tenzij je Alle gegevens verwijderen wanneer de plugin wordt verwijderd aanvinkt in Instellingen > Gegevens & API. In dat geval worden het register, de overboekingen, factoren, projecten, instellingen en metagegevens van de plugin op elke site van het netwerk verwijderd. Exporteer eerst het register: het verantwoordt de ingezamelde bedragen. Bijdrageregels blijven altijd in de bestellingen staan.

Veelgestelde vragen

Mag ik zeggen dat mijn bestellingen CO₂-neutraal zijn?

Nee. In de EU zijn claims op basis van compensatie dat een product een neutrale, verminderde of positieve impact heeft sinds 27 september 2026 verboden. Presenteer in plaats daarvan je steun aan de projecten, met controleerbare feiten.

Waarom worden de schattingen niet op mijn productpagina’s getoond?

Hun datakwaliteit ligt onder de drempel uit Instellingen > Weergave. Controleer de factoren die je gebruikt aan de hand van een bron en markeer ze als gecontroleerd, of vul een waarde in voor het product. Methode & factoren > Te controleren producten toont de betreffende producten.

De optie verschijnt niet bij het afrekenen.

Controleer of de bijdrage is ingeschakeld en op de afrekenpagina wordt aangeboden (Instellingen > Bijdrage). In de modus “Op basis van de geschatte uitstoot” moet de winkelwagen ten minste één fysiek product met een schatting bevatten; virtuele producten hebben geen schatting.

Werkt de plugin met plugins voor meerdere valuta?

Het bedrag wordt berekend in de valuta van de winkel en omgerekend met WPML multi-currency of het filter dfcarbon_convert_amount. Het register en de rapporten houden elke valuta gescheiden.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support