DataFirefly Digital Product Passport: documentatie
Digital Product Passport 2.0 voor WooCommerce installeren en gebruiken: configuratiewizard, sectorsjablonen, paspoorteditor en live voorbeeld, variaties, QR-codes en etiketten, GS1 Digital Link, toegangsniveaus en -sleutels, import/export, REST API, regelgeving en probleemoplossing.
Overzicht
DataFirefly Digital Product Passport geeft elk WooCommerce-product, en elke variatie die dat nodig heeft, een digitaal productpaspoort: identificatiecodes, fabrikant, milieugegevens, duurzaamheid en reparatie, materialen, onderdelen, instructies, zorgwekkende stoffen, documenten en stappen voor traceerbaarheid. Elk paspoort heeft een permanent openbaar adres en een QR-code om af te drukken op het product, de verpakking of de documenten.
Versie 2.0 voegt toe: een overzicht van je hele catalogus, een configuratiewizard met sectorsjablonen, een editor met volledigheidsscore en live voorbeeld, paspoorten voor variaties, een openbare pagina die is ontworpen voor telefoons in 8 talen, QR-codes in afdrukformaten en etiketvellen, GS1 Digital Link, toegangsniveaus met toegangssleutels, een versiegeschiedenis, CSV/JSON-import en -export, blokken en een gedocumenteerde REST API.

Wat de EU-regels vereisen
De Verordening (EU) 2024/1781 betreffende ecologisch ontwerp voor duurzame producten (ESPR) maakt een paspoort op zichzelf niet verplicht: elke productgroep heeft een gedelegeerde handeling nodig, die ten minste 18 maanden na de inwerkingtreding ervan van toepassing wordt. In november 2026 was nog geen gedelegeerde handeling op grond van de ESPR vastgesteld die een paspoort verplicht stelt. De Commissie plant eerst ijzer en staal, daarna textiel, banden en aluminium (2027), meubelen (2028) en matrassen (2029). Het batterijpaspoort van Verordening (EU) 2023/1542 geldt vanaf 18 februari 2027 voor LMT-batterijen, industriële batterijen van meer dan 2 kWh en batterijen voor elektrische voertuigen.
De plugin helpt je de gegevens te structureren en te publiceren. Hij maakt je producten niet zelf conform: hij is niet gekoppeld aan het EU-register voor productpaspoorten, levert niet de door de ESPR vereiste reservekopie bij een onafhankelijke aanbieder van paspoortdiensten en is niet beoordeeld aan de hand van de geharmoniseerde normen voor paspoorten. Het scherm Paspoorten > Regelgeving toont elke eis met de status (Gedekt, Gedeeltelijk gedekt, Niet gedekt, Jouw verantwoordelijkheid) en de officiële bron.

Installatie en update
- Kies in Plugins > Plugin toevoegen > Plugin uploaden het bestand
dfdpp-2.0.0.zipen activeer daarna DataFirefly Digital Product Passport. - Open Paspoorten in het beheermenu.
Vereisten: WordPress 6.4 of hoger, WooCommerce 8.2 of hoger, PHP 7.4 tot en met 8.5. Openbare adressen werken zonder dat je de permalinks opnieuw hoeft op te slaan.
Bijwerken vanaf versie 1.0
Upload de nieuwe zip en kies Huidige vervangen door de geüploade. Paspoorten, hun identificatiecodes, hun openbare adressen en je instellingen blijven bewaard; QR-codes die al zijn afgedrukt blijven werken. Landcodes worden genormaliseerd, de volledigheid van elk paspoort wordt berekend en van elk gepubliceerd paspoort wordt een eerste versie vastgelegd. De weergavekeuzes van versie 1.0 worden toegangsniveaus (verborgen gegevens worden “Alleen intern”). Een melding stelt de nieuwe functies voor.
Configuratiewizard
Bij een nieuwe installatie biedt het overzicht een configuratie in drie stappen:
- Je bedrijf: naam, adres en land van de fabrikant, identificatiecode van de marktdeelnemer (bijvoorbeeld je EORI-nummer of GS1-GLN) en een contactpersoon voor productinformatie. Deze gegevens worden vooraf ingevuld in elk nieuw paspoort.
- Sector en weergave: een sectorsjabloon (textiel, batterijen, elektronica, meubelen of andere producten), de merkkleur van de openbare pagina en wat er op productpagina’s verschijnt.
- Eerste paspoorten: maak conceptpaspoorten aan voor alle producten zonder paspoort, of voor bepaalde categorieën. Er wordt niets gepubliceerd.

Overzicht van je paspoorten
Paspoorten > Overzicht toont het aantal paspoorten, de gemiddelde volledigheid, de producten zonder paspoort en de volgende EU-termijn. De tabel kan worden gefilterd op status, sector en onvolledige paspoorten, en je kunt zoeken op product, GTIN, model of artikelnummer. Voor elk paspoort zie je de volledigheid, de eerste ontbrekende onderdelen, de status, de versie en de laatste update.
Bulkacties gelden voor de geselecteerde paspoorten: publiceren, terug naar concept, archiveren, etiketten afdrukken, exporteren als CSV of JSON. Onder de tabel maak je conceptpaspoorten aan voor producten die er nog geen hebben, met het sectorsjabloon van je keuze.
Een paspoort bewerken
Open een product: het tabblad Productpaspoort van het vak Productgegevens bevat de editor. Vink voor een product zonder paspoort Een paspoort voor dit product aanmaken wanneer ik het opsla aan (dit wordt automatisch aangevinkt zodra je iets in een veld typt).

De kop toont de volledigheidsring, de status (Concept, Gepubliceerd, Gearchiveerd), de knop Live voorbeeld en de link naar de openbare pagina. De secties staan links, met het aantal ontbrekende onderdelen; gebruik de pijltjestoetsen om ertussen te wisselen.
- Identificatie: productsector (die bepaalt de verwachte onderdelen), GTIN met controle van het controlecijfer, model, waarop het paspoort betrekking heeft (een model, een batch of één exemplaar), batch, serienummer, land van productie.
- Fabrikant en marktdeelnemer: fabrikant, identificatiecode van de marktdeelnemer, verantwoordelijke marktdeelnemer in de EU (importeur of gemachtigde), contactpersoon, productiedatum, productielocatie en identificatiecode van de installatie.
- Milieu: koolstofvoetafdruk met eenheid en berekeningsmethode, gerecycleerde inhoud, recyclebaar aandeel, verwachte levensduur, gewicht.
- Duurzaamheid en reparatie: repareerbaarheidsscore, repareerbaarheidsklasse, commerciële garantie, reserveonderdelen en software-updates.
- Sectorgegevens: velden die voor de sector worden voorgesteld, bijvoorbeeld de landen van spinnen, weven, veredelen en confectioneren voor textiel, of categorie, chemie, capaciteit, spanning, energie, levensduur in cycli en aandelen gerecycled kobalt, lithium, nikkel en lood voor batterijen.
- Materialen, Onderdelen, Instructies (gebruik, onderhoud, reparatie, veiligheid, recycling, einde levensduur), Conformiteit en documenten en Traceerbaarheid.
Velden die voor de sector worden verwacht, hebben een stip. Waarden worden tijdens het typen gecontroleerd (GTIN, waardebereiken, datums, webadressen); ongeldige waarden die toch worden verzonden, worden bij het opslaan geweigerd, in een melding opgesomd en bij het veld gemarkeerd, en het paspoort wordt pas gepubliceerd als ze zijn gecorrigeerd.
Materialen en onderdelen
Voeg per materiaal een rij toe: code (kunststoffen, textielvezels, metalen, batterijchemieën…) of vrije naam, aandeel in het product, gewicht, gerecycled aandeel, hernieuwbaar of biogebaseerd, herkomst, CAS-nummer en, indien nodig, het onderdeel waartoe het behoort. Het totaal van de aandelen wordt weergegeven en mag niet hoger zijn dan 100%.

Onderdelen hebben een naam, type, gewicht, herkomst, leverancier en land van de leverancier, en de kenmerken “Vervangbaar”, “Recyclebaar” en “Bevat kritieke grondstoffen”. Documenten (conformiteitsverklaring, handleidingen, certificaten…) kun je kiezen uit de mediabibliotheek.
Live voorbeeld
Live voorbeeld toont de openbare pagina met je niet-opgeslagen wijzigingen, op een telefoon of een computer. Het wordt bijgewerkt terwijl je typt.

Variaties
Vink in het tabblad Variaties de optie Eigen productpaspoort voor deze variatie aan: de variatie krijgt een eigen GTIN, model, batch, serienummer, koolstofvoetafdruk, gewicht en QR-code. De overige gegevens worden overgenomen van het productpaspoort. Het productpaspoort toont de paspoorten van de variaties.
QR-codes en etiketten
De sectie QR-code en etiketten van de editor toont het gecodeerde adres, de QR-versie en de foutcorrectie, en biedt:
- SVG (vector, voor drukwerk), PNG 1024 px en PNG 20, 30 of 50 mm, 300 dpi;
- een afdrukbaar etiket met de QR-code, de productnaam, de GTIN, de batch of het serienummer en het adres;
- de identificatiecode van het paspoort, de openbare pagina, het GS1 Digital Link-adres en de JSON-gegevens.

Om meerdere etiketten af te drukken, selecteer je paspoorten in het overzicht en kies je Etiketten afdrukken. Druk af op 100% en laat de witte marge rond de code vrij.

De openbare paspoortpagina
Het openbare adres ziet eruit als yourdomain.com/dpp/{identifier}/. De pagina is ontworpen voor telefoons en volgt de taal van de telefoon van de bezoeker (8 talen, met een taalmenu). Ze toont het product, de sector en de identificatiecodes, de kerncijfers, de materiaalsamenstelling, de onderdelen, de sectorgegevens, de instructies, de conformiteitsinformatie en -documenten, de tijdlijn voor traceerbaarheid, de fabrikant, de QR-code (downloaden, delen, afdrukken) en de paspoortgegevens (identificatiecode, datums, versie en SHA-256-vingerafdruk).


De pagina is toegankelijk met toetsenbord en schermlezer, past zich aan de donkere modus aan en laat zich netjes afdrukken. Ze biedt haar gegevens ook in JSON aan (/dpp/{identifier}.json) en bevat schema.org JSON-LD. Op productpagina’s linkt een tabblad Productpaspoort (of een kaart onder de samenvatting) naar het paspoort.

Instellingen
In Paspoorten > Instellingen (beheerders en winkelmanagers):
- Openbare pagina: URL-voorvoegsel (direct van kracht), losse pagina of binnen het thema, talen, indexering door zoekmachines, weergave op productpagina’s, overerving door variaties, automatische publicatie, paspoorten van producten die niet meer worden verkocht (standaard online gehouden).
- Standaardgegevens van het bedrijf: vooraf ingevulde waarden van nieuwe paspoorten en de standaardsector.
- Gegevenstoegang en API: het toegangsniveau van elk soort gegevens, toegangssleutels en de REST API.
- QR-codes en etiketten: paspoortadres of GS1 Digital Link, foutcorrectie, kleur (alleen donkere kleuren), downloadformaat, etiketformaat.
- Weergave: merkkleur (de tekstkleur daarop wordt gekozen voor leesbaarheid) en logo.
- Gegevens en verwijderen: alles verwijderen wanneer de plugin wordt verwijderd (standaard uitgevinkt).
Toegangsniveaus en -sleutels
Kies voor elk soort gegevens — fabrikant, productielocatie, milieu, koolstofvoetafdruk, duurzaamheid, instructies, conformiteit, documenten, onderdelen, namen van leveranciers, materialen, traceerbaarheid, wie elke stap heeft uitgevoerd, sectorgegevens — Openbaar, Gemachtigde partijen (toegangssleutel) of Alleen intern. Namen van leveranciers zijn standaard intern. Identificatiecodes, de productnaam en het land van productie zijn altijd openbaar.

Maak een toegangssleutel aan voor een autoriteit, een reparateur, een recycler of een partner: de sleutel wordt één keer getoond en daarna als hash opgeslagen. De ontvanger stuurt hem mee in de header X-DPP-Access-Key bij het opvragen van het JSON-adres of de API. Je kunt een sleutel op elk moment intrekken.
GS1 Digital Link
Wanneer een paspoort een geldige GTIN heeft, krijgt het een GS1 Digital Link-adres op je domein, zoals yourdomain.com/01/09506000134352/10/LOT42 (met de batch of het serienummer, afhankelijk van waarop het paspoort betrekking heeft). De plugin beantwoordt deze adressen en verwijst door naar het paspoort; ?linkType=linkset geeft de lijst met links terug. In de QR-instellingen kun je ervoor kiezen dit adres in de QR-codes te coderen.
Import en export
Paspoorten > Importeren / exporteren:
- Exporteren: alle paspoorten, of die met één status, als CSV of JSON. JSON behoudt alle lijsten (materialen, onderdelen, stappen, documenten). Bewaar het als reservekopie.
- Importeren: een CSV-bestand (komma, puntkomma of tab) of een JSON-bestand. Rijen worden gekoppeld op
uuid, daarna opproduct_iden daarna opsku. De plugin toont eerst wat er wordt aangemaakt, bijgewerkt of overgeslagen, met waarschuwingen; er wordt niets weggeschreven voordat je bevestigt. Lege CSV-cellen wissen geen bestaande gegevens. Begin met het CSV-sjabloon.
Blokken, shortcodes en ontwikkelaars
- Blokken Productpaspoort (kaart met QR-code, alleen QR-code of link) en QR-code van het paspoort.
- Shortcodes
[dfdpp_passport product="123" layout="card|qr|link" qr="no" size="112"]en[dfdpp_qr product="123" size="160"]; zonderproductwordt het huidige product gebruikt. - REST API
dfdpp/v1:GET /passport/{uuid},/qr,/revisions,/by-product/{id},/by-gtin/{gtin};GET|POST /passports;POST|DELETE /passport/{id};POST /passport/{id}/publish|unpublish|archive. Schrijfaanroepen vereisen een gebruiker die het product mag bewerken (applicatiewachtwoorden werken). Beschrijving:/wp-json/dfdpp/v1/openapi. - WP-CLI:
wp dfdpp status,list,publish,unpublish,qr,export. - Sjabloon: kopieer
templates/passport.phpnaaryour-theme/dfdpp/passport.php. Filterdfdpp_passport_payload; actionsdfdpp_passport_created,dfdpp_passport_saved,dfdpp_public_head.
Probleemoplossing
De openbare pagina geeft een 404-fout
Het paspoort is een concept of gearchiveerd, of het product is nooit gepubliceerd. Het overzicht toont de reden. Paspoorten van producten die niet meer worden verkocht blijven online, tenzij je hebt gekozen om ze te verbergen.
Een waarde wordt niet opgeslagen
Na het opslaan somt een melding de geweigerde waarden op en worden de velden in de editor gemarkeerd. Corrigeer ze en sla opnieuw op.
Mijn paginacache toont beperkte gegevens
Beperkte gegevens worden alleen verzonden naar verzoeken met een toegangssleutel of van je eigen team. Als je een paginacache gebruikt, laat die dan variëren op de header X-DPP-Access-Key en op inlogcookies (de plugin stuurt de bijbehorende Vary-header mee).
Verwijderen
Bij het deactiveren van de plugin blijven alle gegevens bewaard. Ook bij het verwijderen blijven de paspoorten bewaard, zodat een herinstallatie ze met hun adressen terugbrengt. Om alles te verwijderen (tabellen, instellingen, toegangssleutels), vink je Alle paspoorten en instellingen verwijderen aan in Instellingen > Gegevens en verwijderen voordat je de plugin verwijdert.
Ondersteuning
Ondersteuning wordt per e-mail gegeven in het Frans en het Engels via support@datafirefly.com. Vermeld de versies van de plugin, WordPress en WooCommerce.