Im OXID eShop 7 setzen Sie das Gewährleistungslabel per Template-Erweiterung unter den Warenkorb-Knopf: im Twig-Block details_productmain_tobasket des APEX-Themes, über ein kleines Modul oder ein Child-Theme. Eine CMS-Seite im Admin reicht dafür nicht, weil der Editor Skripte entfernt und es auf der Artikelseite keinen freien CMS-Platz gibt.
Der Code für OXID eShop
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>Weitere Optionen wie Darstellung und Sprache stellen Sie im Code-Baukasten ein.
Schritt für Schritt in OXID eShop
- Modul oder Child-Theme
Die Erweiterung gehört in ein kleines Modul oder ein Child-Theme (in dertheme.phpmit'parentTheme' => 'apex'), damit Updates des APEX-Themes sie nicht überschreiben. Aktiviert wird es unter Erweiterungen → Module bzw. Erweiterungen → Themes. Dafür brauchen Sie Dateizugriff, meist übernimmt das Ihre Agentur. - Block erweitern
Die Vorlagepage/details/inc/productmain.html.twigerweitern und im Blockdetails_productmain_tobasketnach{{ parent() }}den Widget-Code einsetzen. Mitparent()bleibt der Warenkorb-Knopf unverändert. - GARAN-Label je Artikel
Für eigene GARAN-Labels unter Artikel verwalten → Attribute zwei Attribute anlegen, etwa „GARAN voll“ und „GARAN klein“, und am Artikel unter Auswahl → Attribute zuordnen die Adressen der beiden Dateien eintragen. Im Template geben Sie die Werte indata-garan-vollunddata-garan-kleinaus. - Cache leeren
Mitvendor/bin/oe-console oe:cache:clearden Template-Cache leeren und die Artikelseite prüfen, auch mit Varianten.
In einem Modul liegt die Datei unter views/twig/extensions/themes/apex/page/details/inc/productmain.html.twig und sieht so aus:
{% extends 'page/details/inc/productmain.html.twig' %}
{% block details_productmain_tobasket %}
{{ parent() }}
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}Besonderheiten in OXID eShop
- Der Editor für CMS-Seiten entfernt
<script>. Ab OXID 7.5 gibt es zusätzlich einen HTML-Sanitizer, der Skripte entfernt, wenn er eingeschaltet ist. Der Code gehört deshalb ins Template. - Zugeordnete Attribute erscheinen standardmäßig auch in der Liste der Produkteigenschaften auf der Detailseite. Blenden Sie die beiden GARAN-Attribute dort bei Bedarf im Template aus.
- OXID 6 mit den Smarty-Themes Flow und Wave: Der Block heißt genauso. Module hängen ihn über
blocksin dermetadata.phpein, die Vorlage istpage/details/inc/productmain.tpl.
Wo der Hinweis im OXID eShop genau hingehört
Auf der Artikelseite sitzt der Hinweis im Block details_productmain_tobasket, wie oben beschrieben. Wählen Kunden eine andere Variante, lädt APEX den Bereich details_container neu und ersetzt ihn durch frisch gerendertes HTML. Darin enthaltene Skripte führt das Theme dabei erneut aus. Ihre Blockerweiterung steht so auch nach dem Variantenwechsel wieder auf der Seite.
Für einen Hinweis auf allen Seiten erweitern Sie die Vorlage layout/footer.html.twig. Im APEX-Theme enthält sie unter anderem den Block dd_footer_copyright. Er gibt den Inhalt der CMS-Seite mit dem Ident oxstdfooter aus. In einem Modul liegt Ihre Datei unter views/twig/extensions/themes/apex/layout/footer.html.twig:
{% extends 'layout/footer.html.twig' %}
{% block dd_footer_copyright %}
{{ parent() }}
<div data-garantielabel></div>
<script src="https://www.garantielabel.app/widget.js" async></script>
{% endblock %}Den Footer-Text selbst pflegen Sie weiter in der CMS-Seite. Der Platzhalter gehört aber ins Template, aus demselben Grund wie oben: Der Editor entfernt Skripte. Das Template gilt für alle Shopsprachen. Die Sprache des Hinweises wählt das Widget nach der Sprachangabe der Seite, die APEX aus der aktiven Shopsprache setzt.
Varianten und Modellkennung für das GARAN-Label
In OXID legen Sie zuerst einen Vaterartikel an. Er nimmt laut Handbuch alle Basisinformationen auf, die an die Varianten vererbt werden. Die Varianten pflegen Sie in der Registerkarte Varianten. Abweichend vom Vaterartikel tragen Sie dort unter anderem Artikelnummer, Preis und Lagerbestand ein. Die Langbeschreibung des Vaterartikels erscheint bei allen Varianten, solange eine Variante keine eigene hat.
Hersteller und Hersteller-Artikelnummer (MPN) stehen in der Registerkarte Stamm. Den Hersteller wählen Sie aus einer Liste, die Sie in den Stammdaten pflegen. Die Bearbeitungsansicht einer Variante ist laut Handbuch nahezu identisch mit der eines normalen Artikels.
Ein GARAN-Label gilt für eine Modellkennung. Haben alle Varianten dieselbe, reicht das Label am Vaterartikel. Sind Varianten eigene Modelle, braucht jedes Modell sein eigenes Label. Prüfen Sie nach dem Einrichten im Live-Shop, ob Ihr Template beim Variantenwechsel das Label der gewählten Variante zeigt oder das des Vaterartikels.
Typische Stolperfallen im OXID eShop
- Template-Cache: Änderungen an Templates, Konfigurationen oder Modulen erscheinen laut OXID oft erst nach dem Leeren des Caches. Neben dem Konsolenbefehl von oben leert das OXID-Modul Admin Tools den Template-Cache unter Service → Tools. Er enthält die kompilierten Twig-Vorlagen.
- Varnish: Mit dem Varnish-Reverse-Proxy hält ein eigener Server die Seiten zwischengespeichert. OXID teilt die Seiten dafür in Abschnitte, sogenannte Widgets. Prüfen Sie Ihre Änderung erst, wenn auch dieser Zwischenspeicher die neue Fassung ausliefert. Meist leert ihn Ihre Agentur oder Ihr Hoster.
- Subshops: Für einen Subshop aktivieren Sie ein Modul laut Developer-Doku mit der Option
--shop-id, alsovendor/bin/oe-console oe:module:activate <modul-id> --shop-id=<shop-id>. Prüfen Sie danach jeden Subshop einzeln. - CMS-Inhalte je Sprache: CMS-Seiten pflegen Sie laut Handbuch für jede Sprache getrennt, über die Auswahl „In Sprache“. Eine Template-Erweiterung brauchen Sie dagegen nur einmal.
Weitere Quellen
- OXID-Handbuch: Artikel, Registerkarte Varianten
- OXID-Handbuch: Artikel, Registerkarte Stamm
- OXID Admin Tools: Caches leeren
- OXID-Handbuch: Varnish-Reverse-Proxy (englisch)
- OXID Developer-Doku: Modul aktivieren, auch für Subshops (englisch)
- APEX-Theme auf GitHub: Vorlage des Footers
- APEX-Theme auf GitHub: Skript für die Variantenauswahl
Gewährleistungslabel in der Bestellbestätigung
Laut Leitlinien der Kommission soll der Hinweis auch in der Bestätigungs-E-Mail stehen. Die Bestellbestätigung nutzt die CMS-Seite mit dem Ident oxuserorderemail, die Sie unter Kundeninformationen → CMS-Seiten bearbeiten. JavaScript läuft in E-Mails nicht, ergänzen Sie dort die amtliche Grafik als Bild. Ein bloßer Link reicht als dauerhafter Datenträger voraussichtlich nicht (EuGH, Rs. C-49/11); am sichersten steht der Hinweis als Bild, Text oder Anhang direkt in der Mail. Die amtlichen Dateien finden Sie im Download.
Quellen
- OXID Developer-Doku: Block eines aktiven Themes erweitern
- OXID Developer-Doku: Child-Theme anlegen
- OXID Developer-Doku: HTML-Sanitizer (7.5)
- OXID-Handbuch: Artikel, Registerkarte Auswahl
- OXID-Handbuch: CMS-Seiten
- APEX-Theme auf GitHub (Vorlage der Artikelseite)
Herstellergarantie? Dann gehört das GARAN-Label dazu
Gibt der Hersteller eine kostenlose Haltbarkeitsgarantie von mehr als zwei Jahren auf die ganze Ware, gehört zusätzlich das GARAN-Label auf die Produktseite. Mit dem GARAN-Label-Generator erstellen Sie es in Sekunden aus Jahren, Marke und Modell, die ersten drei kostenlos und ohne Anmeldung. Unter jedem fertigen Label steht ein Einbett-Code mit dauerhaften Bild-Adressen: Sie laden nichts hoch und setzen ihn wie oben in OXID eShop ein.
Lieber eigene Dateien? Dann laden Sie die vollständige und die geschachtelte Fassung in die Medienverwaltung von OXID eShop und tragen die Adressen im Widget-Code ein:
<div data-garantielabel
data-garan-voll="https://…/GARAN-MX-500.svg"
data-garan-klein="https://…/GARAN-MX-500-geschachtelt.svg"></div>Das Widget zeigt dann die geschachtelte Fassung unter dem Gewährleistungslabel, ein Klick öffnet das vollständige GARAN-Label.
Häufige Fragen
Kann ich den Code einfach in eine CMS-Seite einfügen?
Nicht zuverlässig. Der Editor entfernt das Skript, und auf der Artikelseite gibt es keinen Standardplatz, an dem eine CMS-Seite automatisch erscheint. Eine kleine Template-Erweiterung ist der sichere Weg.
Muss ich das APEX-Theme selbst ändern?
Nein. Ein Modul oder Child-Theme mit {{ parent() }} reicht. Das Original-Theme bleibt updatefähig, und der Kaufknopf bleibt, wie er ist.
Wo trage ich das GARAN-Label je Artikel ein?
Zum Beispiel als Attributwert am Artikel unter Auswahl → Attribute zuordnen. Das Template liest die Adressen dann aus und gibt sie an das Widget weiter.
Wie zeige ich den Hinweis im OXID eShop auf allen Seiten?
Erweitern Sie im Modul oder Child-Theme die Vorlage layout/footer.html.twig, im APEX-Theme etwa den Block dd_footer_copyright. Den Widget-Code setzen Sie dort nach {{ parent() }} ein.
Bleibt der Hinweis beim Variantenwechsel stehen?
Ja, wenn er im Block details_productmain_tobasket steht. APEX lädt beim Variantenwechsel den ganzen Detailbereich neu, samt Ihrer Blockerweiterung, und führt enthaltene Skripte erneut aus.
Muss ich das Modul in jedem Subshop aktivieren?
Für einen Subshop aktivieren Sie es laut Developer-Doku mit der Option --shop-id. Prüfen Sie danach jeden Subshop im Live-Shop.