Zum Inhalt springen

Plugin-Dokumentation · JTL-Shop 5

EU-Energielabel am Artikel — Installation

Setup-Guide für die Installation des Plugins in JTL-Shop 5. Dauer: ca. 5 Minuten (zzgl. Wawi-Attributpflege je Artikel).

Voraussetzungen

  • JTL-Shop: Version 5.2.0 oder neuer
  • PHP: 8.1 oder neuer
  • Wawi-Funktionsattribute: Energieklasse und Datenblatt-URL müssen je labelpflichtigem Artikel gepflegt sein
  • Keine eigenen Datenbanktabellen — Kern-Tabellen werden nur gelesen

Wichtiger Rechtshinweis (bitte vor dem Einsatz lesen)

Der gezeichnete Pfeil ist eine vereinfachte, generische Form des Labels (Klassenbuchstabe + „A–G“-Spanne). Für den „nested display“ bei Internetwerbung schreiben die delegierten Verordnungen je Produktgruppe (z. B. Reifen, Heizgeräte-Verbundanlagen) zusätzliche, produktgruppenspezifische Pflichtelemente vor, die dieser generische Pfeil NICHT abbildet. Diese Prüfung bleibt Aufgabe des Händlers.

Installation über den JTL-Extension Store

  1. Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
  2. Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
  3. Klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.

Alternative: manuelle Installation (ZIP)

  1. Öffnen Sie im JTL-Shop-Backend Plugins → Pluginverwaltung und wählen Sie den Tab Upload.
  2. Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (webpowers_energy_label) darf nicht verändert werden.
  3. Wechseln Sie zum Tab Vorhanden, wählen Sie EU-Energielabel am Artikel aus und klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin unter Installiert.

Energiedaten in der Wawi pflegen

In der Wawi je labelpflichtigem Artikel die Funktionsattribute pflegen (Artikel → Attribute/Funktionsattribute):

  • energieklasse → A bis G (Skala 2021). Alt-Skala-Werte wie A+++ werden bewusst nicht angezeigt.
  • datenblatt_url → absolute https-URL zum Produktdatenblatt (PDF)
  • label_url (optional) → URL zum vollständigen Energielabel (Bild oder PDF); wenn gepflegt, wird der Pfeil klickbar

Anschließend Wawi-Abgleich ausführen und den Shop-Cache leeren. Ohne gepflegte Attribute zeigt das Plugin nichts an — das ist Absicht.

Aktivierung

Öffnen Sie Plugins → EU-Energielabel → Einstellungen und prüfen Sie, dass „Plugin aktivieren“ auf Aktiviert steht. Im Tab „Status und Datenqualität“ sehen Sie, welche Artikel eine gültige Klasse haben und wo Attribute fehlen oder ungültig sind. Details zu allen Einstellungen finden Sie in der Konfigurationsanleitung unter webpowers.org/docs/jtl-energy-label/konfiguration.

Deinstallation

Das Plugin kann jederzeit über den Plugin-Manager deinstalliert werden. Es legt keine eigenen Datenbanktabellen an — die Deinstallation ist rückstandsfrei.

Support

webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org