Gewährleistungslabel in OXID eShop einbinden

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

• 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 blocks in der metadata.php ein, die Vorlage ist page/details/inc/productmain.tpl.

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. Das erste Label ist kostenlos.

Laden Sie die vollständige und die geschachtelte Fassung in die Medienverwaltung von OXID eShop und tragen Sie 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