DfGpsr SW: complete gids

DfGpsr SW toont op uw Shopware-productpagina’s de veiligheidsinformatie die verplicht is gesteld door verordening (EU) 2023/988, de algemene productveiligheidsverordening (GPSR), van toepassing sinds 13 december 2024. Shopware biedt op dit punt niets solides van huis uit. DfGpsr SW vult dat gat met aangepaste velden per product, globale terugvalwaarden die per verkoopkanaal instelbaar zijn, en een automatische weergave onder de productbeschrijving. De plugin is bewust gebouwd zonder eigen administratiecomponent en zonder JavaScript in de storefront: één en dezelfde ZIP installeert identiek op Shopware 6.5, 6.6 en 6.7, zonder enige compilatie. Deze gids behandelt de installatie, de globale configuratie, de invoer per product, de vertaling, het aanpassen van het template en de probleemoplossing.

Wat de GPSR voorschrijft

Voor onlineverkoop schrijft verordening (EU) 2023/988 voor dat elke aanbieding vóór de aankoop duidelijk het volgende toont:

• de fabrikant: naam, postadres en e-mailadres;
• de in de EU gevestigde verantwoordelijke persoon (artikel 16) wanneer de fabrikant buiten de Unie is gevestigd: naam, postadres en e-mailadres;
• de waarschuwingen en veiligheidsinformatie in de taal van het beoogde land.

DfGpsr SW dekt deze drie vereisten, plus een lijst met veiligheidsdocumenten (handleidingen, veiligheidsinformatiebladen, certificaten) en een schakelaar om de informatie te verbergen voor artikelen die buiten het toepassingsgebied van de verordening vallen.

Installatie

1. Download het archief DfGpsr-v1.0.0.zip vanuit uw DataFirefly-account.
2. Kopieer de uitgepakte map DfGpsr naar custom/plugins/ van uw Shopware, of installeer de ZIP via Administration → Extensies → Mijn extensies → Extensie uploaden.
3. Start de installatie en de activering:

   bin/console plugin:refresh
   bin/console plugin:install --activate DfGpsr
   bin/console cache:clear

4. Bij de installatie maakt de plugin zijn set aangepaste velden df_gpsr aan op de productentiteit. Bij het verwijderen zonder de gegevens te behouden, worden deze veldenset en al haar waarden gewist.

Globale configuratie (terugvalwaarden)

Open Extensies → Mijn extensies → DataFirefly GPSR Compliance → ⋯ → Configureren. De configuratie is in kaarten opgedeeld:

• Algemeen: de weergave van het blok activeren, de sectietitel al dan niet tonen, en een optie om het blok ook zonder gegevens geforceerd te tonen (bedoeld voor theming en debugging).
• Standaardfabrikant: naam, postadres en e-mail die worden gebruikt wanneer een product geen eigen fabrikant opgeeft.
• Standaard verantwoordelijke persoon in de EU: naam, postadres en e-mail.
• Standaard veiligheidsteksten: algemene waarschuwingen en veiligheidsinformatie.

Al deze waarden zijn per verkoopkanaal instelbaar dankzij de native kanaalkiezer van Shopware bovenaan de configuratie. Selecteer een kanaal om er specifieke waarden aan toe te kennen, of laat “Alle verkoopkanalen” staan voor gemeenschappelijke waarden.

Een product invullen

Open een product onder Catalogi → Producten en ga naar het tabblad Specificaties → Aangepaste velden. De groep GPSR, productveiligheid bundelt de volgende velden:

• GPSR-informatie voor dit product verbergen: schakelaar die u activeert voor artikelen buiten het toepassingsgebied van de verordening.
• Fabrikant: naam, postadres, e-mailadres.
• Verantwoordelijke persoon in de EU: naam, postadres, e-mailadres.
• Waarschuwingen en Veiligheidsinformatie: editors voor opgemaakte tekst.
• Veiligheidsdocumenten: één per regel, in het formaat Label|URL of gewoon een URL.

De resolutieregel is eenvoudig: voor elk veld gebruikt de plugin de waarde van het product als die is ingevuld, en valt anders terug op de standaardwaarde van het verkoopkanaal. Het veld “Documenten” heeft geen globale terugvalwaarde, het is eigen aan elk product.

Formaat van de veiligheidsdocumenten

Voer één document per regel in. Er worden twee formaten geaccepteerd:

Gebruiksaanwijzing|https://voorbeeld.com/handleiding.pdf
Veiligheidsinformatieblad|https://voorbeeld.com/vib.pdf
https://voorbeeld.com/certificaat.pdf

Bij het formaat Label|URL wordt het label de klikbare tekst; een losse URL wordt als zodanig getoond. Alle links openen in een nieuw tabblad.

Vertaling

De velden zijn standaard aangepaste velden van Shopware: u vertaalt ze product per product via de taalkiezer van de administration, bovenaan de productkaart. Vul bijvoorbeeld de waarschuwingen in het Nederlands in voor de taal NL en schakel daarna naar DE om de Duitse versie in te voeren.

De labels van het storefrontblok (titel “Productveiligheid”, “Fabrikant”, “Verantwoordelijke persoon in de EU” en dergelijke) worden native in vijf talen geleverd: Frans, Engels, Duits, Spaans en Italiaans. Ze verschijnen automatisch volgens de taal van het verkoopkanaal, zonder configuratie.

Weergave in de storefront

Het GPSR-blok wordt automatisch op de productdetailpagina ingevoegd, direct na de beschrijving, in het Twig-blok page_product_detail_description_content_text. Het toont de fabrikant en de verantwoordelijke persoon naast elkaar, daarna de waarschuwingen, de veiligheidsinformatie en de lijst met documenten. Het blok verbergt zichzelf automatisch wanneer er geen gegevens beschikbaar zijn, noch op het product, noch in de globale configuratie.

Het template aanpassen

Het weergavecomponent staat apart in views/storefront/component/df-gpsr/gpsr-info.html.twig en wordt ingevoegd via views/storefront/page/product-detail/description.html.twig. Om het blok te verplaatsen of de weergave te wijzigen, overschrijft u een van deze twee bestanden in uw thema. De basisstijl is inline en bewust neutraal, eenvoudig te vervangen door uw eigen klassen.

FAQ en probleemoplossing

Geldt de GPSR voor mijn shop? Als u niet-voedingsproducten voor consumenten verkoopt aan klanten in de EU, zeer waarschijnlijk wel. De verordening geldt sinds 13 december 2024 voor de meeste producten, ook voor producten die online worden verkocht en uit derde landen worden ingevoerd.

Het blok verschijnt niet. Controleer of de optie “weergave activeren” is aangevinkt in de configuratie, of het product of de globale configuratie ten minste één gegeven bevat, en of de schakelaar “Verbergen” niet op het product actief is. Leeg de cache na elke wijziging van de configuratie.

Het blok verschijnt maar is leeg. Waarschijnlijk staat de optie “ook zonder gegevens tonen” nog aan: schakel die uit om terug te keren naar het normale gedrag (automatisch verbergen).

Mijn aangepaste velden worden in de admin van 6.7 als een gewoon tekstveld weergegeven. De mapping van de componenten voor aangepaste velden is met de Meteor-administration veranderd. Als een adresveld als een eenvoudige input in plaats van een tekstvlak wordt weergegeven, is dat slechts een weergavedetail in de admin zonder gevolgen voor de storefront; meld het bij de support voor een aanpassing.

De standaardwaarden worden niet toegepast. Controleer of u de configuratie voor het juiste verkoopkanaal hebt ingevuld. Een waarde die op “Alle verkoopkanalen” is ingesteld, wordt overschreven door een kanaalspecifieke waarde als die bestaat.

Wat gebeurt er bij het verwijderen? Met de optie om de gegevens te wissen worden de veldenset df_gpsr en alle op de producten ingevoerde waarden verwijderd. Zonder die optie blijven de gegevens bewaard voor een latere herinstallatie.