Kennisgeving wettelijke garantie in Shopware 6: widget

In Shopware 6 plaats je de placeholder via Shopping Experiences in de lay-out van de productpagina. Het script laad je via het thema of een plugin voor eigen scripts, want sinds Shopware 6.5 verwijdert de editor scripts uit tekstelementen.

Nieuw sinds Shopware 6.7.14 (en 6.6.10.24): Shopware heeft het GARAN-label ingebouwd. De garantieduur vul je bij het product in; merk en modelidentificatie komen van de fabrikant en het productnummer van de fabrikant. De widget voegt de kennisgeving over de wettelijke garantie toe op de productpagina. Laat data-garan-* in de widget weg, zodat het GARAN-label niet twee keer verschijnt. Details lees je hieronder bij de varianten.

De code voor Shopware 6

<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>

Meer opties, zoals weergave en taal, stel je in met de codebouwer.

Stap voor stap in Shopware 6

Open de Shopping Experience
Ga in de Administration naar Content → Shopping Experiences en open de lay-out van je productpagina's, of maak een nieuwe aan van het type ‘Product page’.
Voeg de placeholder in
Voeg onder de koopbox een blok met een tekstelement toe, schakel over naar de broncodeweergave en voeg <div data-garantielabel></div> in.
Laad het script
Voeg de regel met widget.js toe via het thema (bijvoorbeeld in base.html.twig) of via een plugin voor eigen scripts, sla de lay-out op en wijs hem toe aan de producten.
Alternatief in het thema
Ontwikkelaars breiden in hun eigen thema het sjabloon van de koopbox (buy-widget.html.twig) uit met de placeholder en laden het script in de head van het sjabloon.

De menunamen geven we in het Engels, zoals in de Engelse beheeromgeving.

Goed om te weten over Shopware 6

Vanaf versie 6.5 filtert Shopware scripts in het tekstelement (HTML-sanitizer). Dat kun je alleen in zelf gehoste webshops uitschakelen; in Shopware Cloud blijven het thema of een plugin de weg.
Gebruik je een eigen Content Security Policy, dan moet www.garantielabel.app zijn toegestaan voor scripts, afbeeldingen en verbindingen.

Waar de kennisgeving hoort in Shopware 6

In Shopware is de productpagina een Shopping Experience van het type “Product page”. Standaard bevat die de Buybox met de galerij met productafbeeldingen en de productbeschrijving. Ook elementen als “Product name & manufacturer logo” en Cross Selling zijn beschikbaar. Een layout wijs je toe op het tabblad “Layout” van het product. Wil je hem standaard maken voor nieuwe productpagina’s, gebruik dan “Layout assignment → Default layouts” in de zijbalk.

In het thema komt de Buybox uit de template buy-widget.html.twig, in Shopware 6.7 onder storefront/component/buy-widget/. Eigen templates maak je in een plugin of thema onder Resources/views met dezelfde mappenstructuur, en je breidt het origineel uit met sw_extends.

Voor de footer kies je in de instellingen van het verkoopkanaal het “Entry point footer navigation”. In het standaardthema levert het niveau daaronder de koppen en het niveau daar weer onder de links. Ontwikkelaars breiden in plaats daarvan de template layout/footer/footer.html.twig uit en voegen de widget daar toe met data-darstellung="link".

Varianten, productnummer van de fabrikant en GARAN-label

Varianten maak je op het tabblad “Variants” van het product met de variantengenerator. Eerst heb je eigenschappen nodig onder “Products → Properties”. Varianten erven gegevens zoals naam en beschrijving van het hoofdproduct. Met het kettingpictogram hef je de overerving voor een variant op.

Sinds Shopware 6.7.14 en 6.6.10.24 toont Shopware het GARAN-label zelf. Het product heeft een kaart “Guarantee (GARAN Label)” met “Producer guarantee duration in months” (30 tot 600, in stappen van 6) en de schakelaar “Show label in Storefront”. Het merk komt uit het veld “Manufacturer”, de modelidentificatie uit het “Manufacturer product number” op het tabblad “General”. Ontbreekt een van beide, dan toont Shopware geen label. Volgens Shopware kun je de garantievelden op het hoofdproduct instellen en per variant overschrijven. Hebben je varianten eigen modelidentificaties, vul dan het productnummer van de fabrikant per variant in.

Het GARAN-label verschijnt dan onder de Buybox, in de winkelwagen, op de orderbevestigingspagina en in de e-mail met de orderbevestiging. Shopware linkt de kennisgeving over de wettelijke garantie op de orderbevestigingspagina, naast de tekst over de algemene voorwaarden. Een weergave op de productpagina beschrijft Shopware niet. Daar en in de footer voegt de widget de kennisgeving toe. Gebruikt je webshop het ingebouwde GARAN-label, laat dan data-garan-voll en data-garan-klein weg in de widget, anders verschijnt het label twee keer.

Veelvoorkomende valkuilen in Shopware

Cache: leeg na wijzigingen aan templates de cache, bijvoorbeeld met bin/console cache:clear. Het thema moet op het tabblad “Theme” aan het juiste verkoopkanaal zijn toegewezen.
Aangepaste ordermail: de update heeft de template van de orderbevestiging alleen uitgebreid als die nooit was bewerkt. Volgens Shopware krijgen aangepaste templates het GARAN-label en de link naar de kennisgeving niet automatisch.
Overschreven voorwaardentekst: de link naar de kennisgeving over de wettelijke garantie staat na de update aan (“Show legal guarantee notice on checkout page”). Heb je de voorwaardentekst van de orderbevestigingspagina in je thema overschreven, dan moet je die overschrijving volgens Shopware aanpassen.
Meerdere verkoopkanalen: de instelling voor de kennisgeving over de wettelijke garantie kan per verkoopkanaal worden overschreven. Controleer elk kanaal afzonderlijk.

Meer bronnen

Kennisgeving over de wettelijke garantie in de orderbevestiging

Volgens de richtsnoeren van de Commissie hoort de kennisgeving ook in de bevestigingsmail. In Shopware bewerk je e-mailsjablonen onder Settings → Email templates. De officiële afbeelding kun je als afbeelding toevoegen aan het sjabloon van de orderbevestiging. Een losse link telt waarschijnlijk niet als duurzame gegevensdrager (Hof van Justitie van de EU, zaak C-49/11, Content Services); het veiligst zet je de kennisgeving direct in de e-mail, als afbeelding, tekst of bijlage. De officiële bestanden vind je op onze downloadpagina.

Producentengarantie? Voeg dan het GARAN-label toe

Geeft de producent kosteloos een commerciële levensduurgarantie van meer dan twee jaar voor het hele product, dan hoort ook het GARAN-label op de productpagina. Met de GARAN-labelgenerator maak je het in een paar seconden uit het aantal jaren, het merk en het model, je eerste 3 labels gratis en zonder registratie. Onder elk klaar label krijg je een insluitcode met vaste afbeeldings-URL's: je uploadt niets en plakt hem in Shopware 6 zoals hierboven beschreven.

Liever je eigen bestanden? Upload dan de volledige en de geneste versie naar de mediabibliotheek van Shopware 6 en vul de adressen in de widgetcode in:

<div data-garantielabel
  data-garan-voll="https://…/GARAN-MX-500.svg"
  data-garan-klein="https://…/GARAN-MX-500-genest.svg"></div>

De widget toont dan de geneste versie onder de kennisgeving over de wettelijke garantie, en één klik opent het volledige GARAN-label.

Veelgestelde vragen

Werkt dit ook in Shopware 5?

Ja, via een element in de Shopping World of het sjabloonbestand van de detailpagina. Shopware 5 wordt echter sinds juli 2024 niet meer ondersteund.

Moet ik dit voor elk product doen?

Nee. In de lay-out van de productpagina geldt de code voor alle producten waaraan de lay-out is toegewezen.

Stoort het de koopbox?

Nee. De widget tekent alleen binnen zijn placeholder en verandert daarbuiten niets.

Heb ik de widget nodig als Shopware het GARAN-label al toont?

Voor het GARAN-label niet. Vanaf Shopware 6.7.14 of 6.6.10.24 regelt Shopware dat zelf. Shopware linkt de kennisgeving over de wettelijke garantie op de orderbevestigingspagina. Voor de productpagina en de footer blijft de widget nuttig, dan zonder data-garan-….

Welk veld gebruikt Shopware als modelidentificatie?

Het productnummer van de fabrikant (“Manufacturer product number”) op het tabblad “General”. Het merk komt uit het veld “Manufacturer”.

Waarom toont Shopware geen GARAN-label?

Shopware toont het alleen als “Show label in Storefront” aanstaat en de garantieduur, de fabrikant en het productnummer van de fabrikant zijn ingevuld.

Kennisgeving over de wettelijke garantie toevoegen in Shopware 6