EU Commerce Compliance Labels

Voraussetzungen

EU Commerce Compliance Labels benötigt JTL-Shop ab 5.6.0 (getestet bis 5.7.2) und PHP ab 8.1 (empfohlen 8.3); für das GARAN-Label ist die PHP-Erweiterung GD mit FreeType erforderlich — fehlt sie, wird kein GARAN-Label ausgegeben (der Bereitschaftsstatus im Backend nennt die Abhilfe). Für die Steuerung von GARAN-Label und Rücknahmesymbolen wird JTL-Wawi mit der Pflege von Funktionsattributen verwendet.

Die Frontendausgabe nutzt verifizierte Einfügepunkte des NOVA-Templates (auch NOVA-Kindtemplates; SALEPIX/TECHNIK und Snackys verifiziert); ohne erkannten Zielknoten wird sicher nichts eingefügt. Es werden keine Core- oder Template-Dateien verändert und keine externen Dienste im Frontend aufgerufen. Alle amtlichen Assets werden byteidentisch mitgeliefert und vor jeder Verwendung per SHA-256 geprüft.

Installation

Aus dem JTL Extension Store

Nach dem Kauf erscheint die Erweiterung im Backend Ihres Shops unter Plugin-Verwaltung → Meine Käufe. Domain anbinden, installieren, aktivieren — fertig. Die Lizenz wird dabei automatisch vom Shop verwaltet; ein separater Lizenzschlüssel ist nicht erforderlich.

Manuell (Direktlizenz)

Das ZIP über den Download-Link aus Ihrer Lizenz-E-Mail (Kauf- oder Testlizenz) laden und in der Plugin-Verwaltung → Upload hochladen, anschließend im Tab Vorhanden installieren und aktivieren. Den Lizenzschlüssel (beginnt mit ecc) tragen Sie danach im Plugin-Tab Lizenz ein — die Eingabe ist maskiert, die Aktivierung erfolgt automatisch beim nächsten Öffnen der Übersicht.

Erste Schritte

Vier Schritte von der frischen Installation zur aktiven Kennzeichnung. Alle Schalter stehen ab Werk auf „Nein" — ohne Ihre ausdrückliche Aktivierung wird nichts ausgegeben.

1. Übersicht öffnen

   Der Tab Übersicht zeigt Lizenzstatus, Laufzeit und den Status aller Module. Ohne Lizenzschlüssel gibt das Plugin keine Kennzeichnungen aus: Bestellen Sie im Shop die kostenlose 14-Tage-Testlizenz (0 €), Sie erhalten den Schlüssel per E-Mail und tragen ihn im Tab Lizenz ein.

2. Funktionsattribute anlegen

   Der Tab Einrichtung führt Schritt für Schritt durch die Anlage der benötigten Funktionsattribute in JTL-Wawi — z. B. ecc_guarantee_enabled, ecc_guarantee_brand, ecc_guarantee_model, ecc_weee_takeback und ecc_battery_disposal.

3. Module aktivieren

   In den Einstellungs-Tabs Gewährleistung, Garantie, Altgeräterücknahme und Batterieentsorgung die gewünschten Ausgaben und Positionen wählen.

4. Herstellerkontakte pflegen

   Im Tab Hersteller & GPSR die Kontaktdaten je Hersteller erfassen (inklusive Länderauswahl und optionaler Telefonnummer) und die Ausgabe je Hersteller freischalten. Tipp: Nach dem Speichern bleiben Sie im Reiter; der bearbeitete Hersteller wird zugeklappt. Die Frontendausgabe erfolgt nur bei vollständigem Datensatz — und nur, wenn am Artikel nicht bereits eigene GPSR-Angaben erkannt wurden.

Gewährleistungsmitteilung

Die amtliche deutsche SVG-Fassung (verlustfrei skalierbar, PNG als Rückfallebene) wird an den gewählten Anzeigeorten ausgegeben: Produktdetailseite (vier Positionen — vor/nach der Beschreibung, nach Attributen, am Inhaltsende), Warenkorb und Checkout. Der Pflicht-Link mit demselben Ziel wie der QR-Code ist Teil jeder Ausgabe. Die Einfügung erfolgt über HOOK_SMARTY_OUTPUTFILTER an verifizierten NOVA-Zielknoten.

GARAN-Label

Das amtliche Label für gewerbliche Haltbarkeitsgarantien wird dynamisch mit den drei editierbaren Feldern Dauer, Marke und Modellkennung aus JTL-Wawi-Funktionsattributen befüllt. Für Marke und Modell sind Fallback-Reihenfolgen konfigurierbar (JTL-Hersteller, Herstellerartikelnummer, Artikelnummer).

Ausgabemodi: unter dem Warenkorb-Button, unter den Artikel-Basisdaten, in der Produktbeschreibung (Position wählbar) oder als eigener Abschnitt „Garantie". Wahlweise vollfarbiges Label oder amtliches Kompaktlabel, das per Klick das vollständige Label öffnet. Im Checkout erscheint je garantiepflichtiger Position ein Kompaktlabel oberhalb der Bestellschaltfläche.

GPSR-Herstellerverzeichnis

Im Tab Hersteller & GPSR pflegen Sie zentrale Kontaktdaten für alle aktiven JTL-Hersteller: Firma, Straße/Hausnummer, PLZ/Ort, Land (Auswahl aus der Länderliste des Shops), E-Mail, Website und optional Telefon. Die Frontendausgabe am Ende der Produktseite erfolgt nur bei vollständigem Datensatz, aktivierter Herstellerzeile und global aktiviertem Verzeichnis — und nur, wenn das Plugin am Artikel nicht bereits vorhandene „Angaben zur Produktsicherheit" erkennt. So entstehen keine Doppelausgaben.

Altgeräterücknahme & Batterieentsorgung

Beide Module zeigen die offiziellen Sammelstellenlogos (mehrere hashgeprüfte Varianten, eigene Datei hat Vorrang) auf der Produktdetailseite gekennzeichneter Artikel. Die Kennzeichnung erfolgt wahlweise über die mitgelieferten Funktionsattribute ecc_weee_takeback bzw. ecc_battery_disposal oder über ein bereits vorhandenes Attribut mit konfigurierbarem Erwartungswert. Optional verlinken Symbol und Textlink auf Ihre Infoseite zur Rücknahme; enthält der Attributwert eine URL, hat diese Vorrang.

Anhang in der Bestellbestätigungs-Mail

Optional hängt das Plugin die Gewährleistungsmitteilung (PNG als CID-Inline-Anhang samt Link) an die Bestellbestätigung an; bei aktivierter GARAN-Ausgabe zusätzlich das befüllte GARAN-Label je garantiepflichtiger Bestellposition — gerastert, mit Klartextangaben. Einhängepunkt ist der verifizierte Hook HOOK_MAILTOOLS_SENDEMAIL_ENDE; ohne bestätigte Strukturen verändert die Integration keine Mail.

Testphase & Lizenzierung

Die Testphase ist eine im Shop bestellte Testlizenz (0 €, keine Zahlungsdaten): 14 Tage voller Funktionsumfang, eine Testlizenz je Shop-Domain, Laufzeit und Ablauf werden vom Lizenzserver bestätigt. Ohne eingetragenen Schlüssel gibt das Plugin nichts aus; nach Ablauf der Testlizenz ohne Kauflizenz wird die Ausgabe der Kennzeichnungen deaktiviert (deutlicher Hinweis im Backend, Erinnerung drei Tage und einen Tag vor Ablauf); sämtliche Einstellungen bleiben erhalten und sind mit Lizenz sofort wieder aktiv.

Zwei gleichwertige Wege in den Vollmodus: Kauf im JTL Extension Store (Lizenz wird vom Shop verwaltet) oder Direktlizenz von plugin-manager.de (Schlüsseleingabe maskiert im Tab Lizenz). Die Übersicht zeigt maskierten Schlüssel, Lizenzart, Laufzeit und das letzte Prüfergebnis mit Zeitstempel. Einmal erworbene Kauflizenzen laufen dauerhaft; nach Ablauf des Lizenzzeitraums endet ausschließlich der Update-Bezug — Details in der Lizenzvereinbarung.

Problemlösung

Der Plugin-Tab zeigt einen Fehler

Prüfen Sie zunächst Shop- und PHP-Version (siehe Voraussetzungen). Bleibt der Fehler, senden Sie uns die Meldung aus dem JTL-Log an info@plugin-manager.de.

Keine Ausgabe im Frontend

Kontrollieren Sie in dieser Reihenfolge: Lizenzschlüssel im Tab Lizenz eingetragen und aktiv (Übersicht zeigt Laufzeit)? Modul im jeweiligen Einstellungs-Tab aktiviert? Funktionsattribut am Artikel gepflegt? Bei GPSR: Herstellerdatensatz vollständig und freigeschaltet? Lizenz bzw. Testphase aktiv (Tab Übersicht)?

Änderungen (Auszug)

War diese Seite hilfreich? Feedback per E-Mail senden — wir lesen jede Rückmeldung.