In PrestaShop voeg je de kennisgeving over de wettelijke garantie toe via het sjabloon van de productpagina in een child theme, of via een module die HTML uitvoert op de hook voor aanvullende productinformatie.
De code voor PrestaShop
<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 PrestaShop
- Gebruik een child theme
Wijzigingen aan het thema horen in een child theme, zodat updates ze niet overschrijven. - Kies de plek
Zoek intemplates/catalog/product.tplhet gedeelte onder de knop voor de winkelwagen. - Plak de code
Plak de widgetcode daar. Of gebruik een HTML-blokmodule uit de Addons-marketplace op de hookdisplayProductAdditionalInfo. - Leeg de cache
Leeg de cache onder Advanced Parameters → Performance en controleer.
De menunamen geven we in het Engels, zoals in de Engelse beheeromgeving.
Goed om te weten over PrestaShop
- Smarty interpreteert accolades. De widgetcode bevat er geen, dus je kunt hem direct plakken.
- Staat ‘Smart cache for JavaScript’ aan in de prestatie-instellingen, dan blijft het externe script daarbuiten.
Waar de kennisgeving in PrestaShop hoort
PrestaShop plaatst inhoud via hooks. Volgens de ontwikkelaarsdocumentatie staan deze drie op de volgende plekken in de thema’s Classic en Hummingbird:
displayProductAdditionalInfo(“Product page additional info”) staat incatalog/_partials/product-additional-info.tpl. In het Classic-thema laadtproduct.tpldit bestand direct na het gedeelte met de winkelwagenknop. Dat is de plek voor de kennisgeving op de productpagina.displayReassurancestaat incatalog/product.tpl, maar ook incheckout/cart.tplencheckout/checkout.tpl. Een module op deze hook verschijnt dus op de productpagina, in de winkelwagen en bij het afrekenen.displayFooterstaat in_partials/footer.tplen verschijnt daardoor op elke pagina.
Je koppelt een module aan een hook onder “Design → Positions” (labels van de Engelstalige beheeromgeving), met de knop rechtsboven (“Transplant a module”). Voor de footer is er ook de module “Link list” (“Design → Link Widget”). Die linkt pagina’s uit “Design → Pages” in linkblokken; in het Classic-thema staan de blokken in de footer. Een eigen pagina met de widget verschijnt zo als link in de footer.
Combinaties, merk en modelidentificatie
In PrestaShop heten varianten combinaties. Bij het aanmaken van het product kies je het type “Product with combinations” en verschijnt het tabblad “Combinations”. Elke combinatie heeft eigen referenties: referentie plus ISBN, EAN en UPC. Volgens de webservicedocumentatie heeft elke combinatie ook een eigen MPN-veld.
Het merk hoort daarentegen bij het product. Volgens PrestaShop heeft een product precies één merk, beheerd onder “Brands & Suppliers”. Alle combinaties delen dus het merk. De MPN in het tabblad “Details” is de unieke referentie van de producent. Of die overeenkomt met de modelidentificatie op het GARAN-label, haal je uit de gegevens van de producent.
Het GARAN-label noemt het merk en de modelidentificatie, dus er is één label per modelidentificatie. De widget toont één GARAN-label per placeholder en wisselt niet mee met de gekozen combinatie. Hebben combinaties verschillende modelidentificaties, maak deze modellen dan aan als aparte producten, elk met een eigen label.
Veelvoorkomende valkuilen in PrestaShop
- Templatecache: Staat onder “Advanced Parameters → Performance” ingesteld dat templatebestanden nooit opnieuw worden gecompileerd, dan toont de winkel themawijzigingen pas nadat je de cache hebt geleegd.
- Childthema: In
config/theme.ymlstaat bijparentde mapnaam van het parentthema, niet de weergavenaam. Je eigennamemoet overeenkomen met je eigen mapnaam. - Andere thema’s: De hookposities hierboven gelden voor Classic en Hummingbird. Een ander thema kan hooks ergens anders of helemaal niet tonen. Controleer onder “Design → Positions” welke hooks je thema toont.
- Module zonder methode: Volgens de ontwikkelaarsdocumentatie toont een module op een hook waarvoor ze geen passende methode heeft niets.
Meer bronnen
- PrestaShop-ontwikkelaarsdocumentatie: List of hooks (in het Engels)
- PrestaShop Classic-thema: catalog/product.tpl (GitHub)
- PrestaShop-ontwikkelaarsdocumentatie: Displaying content on the front office (in het Engels)
- PrestaShop-documentatie: Link Widget (in het Engels)
- PrestaShop-documentatie: Managing products (in het Engels)
- PrestaShop-ontwikkelaarsdocumentatie: webservicebron Combinations (in het Engels)
- PrestaShop-documentatie: Performance (in het Engels)
- PrestaShop-ontwikkelaarsdocumentatie: Creating a child theme (in het Engels)
Kennisgeving over de wettelijke garantie in de orderbevestiging
Volgens de richtsnoeren van de Commissie hoort de kennisgeving ook in de bevestigingsmail. E-mailsjablonen bewerk je onder International → Translations of Design → Email Theme. 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 PrestaShop zoals hierboven beschreven.
Liever je eigen bestanden? Upload dan de volledige en de geneste versie naar de mediabibliotheek van PrestaShop 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
Is er een kant-en-klare module?
Een aparte module heb je niet nodig. Het sjabloon in het child theme is genoeg; als alternatief een HTML-blokmodule uit de Addons-marketplace.
Werkt het in PrestaShop 1.7, 8 en 9?
Ja, in alle drie de versies op dezelfde manier.
Moet ik de cache legen?
Ja, na het wijzigen van het sjabloon.
Welke hook toont de kennisgeving ook in de winkelwagen?
displayReassurance. In Classic en Hummingbird staat die op de productpagina, in de winkelwagen en bij het afrekenen.
Heeft elke combinatie een eigen modelidentificatie?
Elke combinatie heeft eigen referenties (referentie, ISBN, EAN, UPC en, volgens de webservicedocumentatie, MPN). Het merk geldt echter voor het hele product.
Hoe krijg ik de kennisgeving in de footer?
Met een module op de hook displayFooter, of als link: maak onder “Design → Pages” een pagina met de widget aan en link die in de footer met de module “Link list”.