Kennisgeving wettelijke garantie in JTL-Shop: gratis widget

In JTL-Shop 5 voeg je de kennisgeving over de wettelijke garantie voor alle artikelen toe via het child-template van de artikeldetailpagina. Voor afzonderlijke artikelen werkt ook de OnPage Composer met een tekstportlet in de broncodeweergave.

Nieuw sinds JTL-Shop 5.8: JTL-Shop heeft beide labels ingebouwd. Je schakelt ze in onder „Darstellung“ → „Einstellungen“ → „Global“ (weergave → instellingen → globaal), sectie „Gewährleistungs- und Garantielabel“. JTL toont de kennisgeving over de wettelijke garantie in het besteloverzicht, op de pagina „Gesetzliche Gewährleistung“ (wettelijke garantie) in de footer en als pdf bij de orderbevestiging, maar volgens JTL niet op de detailpagina van het artikel. Daarvoor is de widget er. Het GARAN-label leest JTL uit de functieattributen van JTL-Wawi jtl_guarantee_manufacturer, jtl_guarantee_model_identifier en jtl_guarantee_years.

De code voor JTL-Shop

<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 JTL-Shop

Gebruik een child-template
Wijzigingen horen in een child-template (bij NOVA: NOVAChild), zodat updates ze niet overschrijven.
Breid het template uit
Breid in het child-template het template van de artikeldetailpagina uit en plaats de widgetcode onder de knop voor de winkelwagen. Hij geldt dan voor alle artikelen.
Eén artikel
Voor één artikel: sleep in de OnPage Composer een tekstportlet onder de knop voor de winkelwagen en plak de code in de broncodeweergave. De OnPage Composer bewerkt elke pagina afzonderlijk.
Controleer
Leeg de cache of publiceer het concept en controleer een artikel.

Menunamen tussen aanhalingstekens komen uit de Duitse beheeromgeving; tussen haakjes staat de Nederlandse vertaling.

Goed om te weten over JTL-Shop

Zonder OnPage Composer (JTL-Shop 4) plak je de code in het template van de artikeldetailpagina.
Staat minify aan in het template, dan mag widget.js daar niet in meegaan; het script laadt rechtstreeks van garantielabel.app.

Waar de kennisgeving hoort in JTL-Shop

Het NOVA-template bouwt de artikeldetailpagina op uit productdetails/details.tpl. Daar voegt het blok productdetails-details-include-basket het koopgedeelte in. De winkelwagenknop zelf zit in productdetails/basket.tpl, in het blok productdetails-basket-add-to-cart. In het childtemplate maak je het bestand met hetzelfde pad aan en breid je het blok uit met append of prepend. Zo blijft de oorspronkelijke inhoud behouden en verandert het koopgedeelte niet.

Vanaf JTL-Shop 5.8 heeft de shop beide labels ingebouwd. Je zet ze aan onder “Darstellung → Einstellungen → Global” (Weergave → Instellingen → Globaal), in het gedeelte “Gewährleistungs- und Garantielabel” (kennisgeving over de wettelijke garantie en garantielabel). JTL toont de kennisgeving over de wettelijke garantie dan in het besteloverzicht en op de pagina “Gesetzliche Gewährleistung” (wettelijke garantie). JTL voegt deze pagina automatisch toe aan het footergedeelte “Gesetzliche Informationen” (wettelijke informatie), de linkgroep met de templatenaam “Fuss”. JTL noemt de artikeldetailpagina niet voor de kennisgeving over de wettelijke garantie. Daar voegt de widget de kennisgeving toe.

Kindartikelen, functieattributen en GARAN-label

JTL-Wawi onderscheidt variatieartikelen en kindartikelen (vroeger variatiecombinaties). Variaties zonder kindartikelen zijn geen afzonderlijke artikelen, dus veel instellingen kun je niet per variatie maken. Kindartikelen zijn daarentegen eigen artikelen. Ze erven bijvoorbeeld attributen en kenmerken van het bovenliggende artikel, maar je kunt ze beheren als gewone artikelen.

Het ingebouwde garantielabel (GARAN-label) leest drie functieattributen uit JTL-Wawi: jtl_guarantee_manufacturer voor de producent, jtl_guarantee_model_identifier voor de modelidentificatie en jtl_guarantee_years voor de duur in jaren. Vanaf JTL-Wawi 2.1 bestaan ze al, maar ze moeten voor de webshop worden geactiveerd. Ontbreekt een van de drie waarden, dan toont de shop voor dat artikel geen garantielabel. Hebben kindartikelen eigen modelidentificaties, vul dan jtl_guarantee_model_identifier bij elk kindartikel in.

Waar het label verschijnt, kies je apart: artikellijst, artikeldetailpagina, winkelwagen, besteloverzicht en orderbevestiging. Op de artikeldetailpagina staat het onder het artikelnummer, de GTIN, de categorie en de fabrikant. Gebruik je het ingebouwde garantielabel, laat dan data-garan-voll en data-garan-klein weg in de widget, anders verschijnt het label twee keer.

Veelvoorkomende valkuilen in JTL-Shop

Standaard uit: volgens JTL staan beide labels eerst uit. Na de update naar 5.8 moet je ze zelf aanzetten.
Synchronisatie: nieuwe garantiegegevens verschijnen pas in de shop na een webshopsynchronisatie vanuit JTL-Wawi.
Garantieduur: volgens JTL betekent jtl_guarantee_years de totale duur vanaf de aankoop. Bij 3 jaar is dat 3 jaar in totaal, niet 5.
Childtemplate: de mapnaam moet overeenkomen met de naam in template.xml, met NOVA als parenttemplate. Het childtemplate bevat alleen de gewijzigde bestanden. Leeg na het activeren de templatecache.

Meer bronnen

Kennisgeving over de wettelijke garantie in de orderbevestiging

Volgens de richtsnoeren van de Commissie hoort de kennisgeving ook in de bevestigingsmail. De e-mailsjablonen beheer je in de backend van JTL-Shop bij de e-mailsjablonen. De officiële afbeelding kun je als afbeelding toevoegen aan 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 JTL-Shop zoals hierboven beschreven.

Liever je eigen bestanden? Upload dan de volledige en de geneste versie naar de mediabibliotheek van JTL-Shop 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 met gegevens uit JTL-Wawi?

Ja. Beheer je de adressen van de GARAN-labels als artikelattribuut en geef je ze in het template weer in data-garan-voll en data-garan-klein, dan toont elk artikel het juiste label.

Heb ik een plugin nodig?

Nee. Het child-template is genoeg. Een HTML-portlet bestaat alleen als plugin in de Extension Store, en die heb je niet nodig.

Overschrijven updates het?

Nee, als de wijziging in het child-template staat. Content uit de OnPage Composer blijft ook behouden.

Toont JTL-Shop 5.8 de labels zelf?

Ja, zodra je ze aanzet onder “Darstellung → Einstellungen → Global”. Standaard staan beide uit. De kennisgeving over de wettelijke garantie verschijnt dan in het besteloverzicht en op de pagina “Gesetzliche Gewährleistung”, het garantielabel op de plekken die je kiest.

Waarom ontbreekt het garantielabel bij een artikel?

Meestal ontbreekt een van de waarden jtl_guarantee_manufacturer, jtl_guarantee_model_identifier of jtl_guarantee_years, of de webshopsynchronisatie moet nog plaatsvinden. Controleer ook of de functieattributen voor de webshop zijn geactiveerd.

Aan welk blok voeg ik de widget toe?

Bijvoorbeeld met append aan het blok productdetails-details-include-basket in productdetails/details.tpl van het childtemplate. Dan staat hij direct na het koopgedeelte.

Kennisgeving over de wettelijke garantie toevoegen in JTL-Shop