Zum Inhalt
Neu: 3 GARAN-Labels kostenlos, ohne AnmeldungJetzt erstellen
EU-Gewährleistungs-
und GARAN Label
AnleitungStand 9. Oktober 20265 Min. Lesezeit

EU-Gewährleistungslabel in OXID eShop einbinden

Das amtliche EU-Gewährleistungslabel in wenigen Minuten in Ihrem OXID eShop, mit dem kostenlosen Widget.

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

  1. Modul oder Child-Theme
    Die Erweiterung gehört in ein kleines Modul oder ein Child-Theme (in der theme.php mit '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.
  2. Block erweitern
    Die Vorlage page/details/inc/productmain.html.twig erweitern und im Block details_productmain_tobasket nach {{ parent() }} den Widget-Code einsetzen. Mit parent() bleibt der Warenkorb-Knopf unverändert.
  3. 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 in data-garan-voll und data-garan-klein aus.
  4. Cache leeren
    Mit vendor/bin/oe-console oe:cache:clear den 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

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

Weitere Quellen

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

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.

GARAN‑Label erstellen, Gewährleistungslabel einbinden.

Der Generator erstellt GARAN-Labels in Sekunden, die ersten 3 sind kostenlos. Für Shopify bindet die App beide Labels automatisch ein.