xt_warranty_label - EU-Garantie-Label

xt_warranty_label - EU-Garantie-Label

Zweck
Dieses Plugin erzeugt pro Artikel ein individualisiertes EU-Garantie-Label als PNG auf Basis einer Vorlage. Verwendet werden die Garantiedauer, die Marke und die Modellnummer. Es stehen zwei Varianten zur Verfügung: Groß und Kurz.

Hinweis: Integriert ab Version 6.8. Kein zusätzliches Abo notwendig, Labels werden vom Shop erzeugt.

Funktionsweise im Überblick

Das Label wird automatisch beim Speichern eines Artikels erzeugt oder aktualisiert. Dabei liest das Plugin die relevanten Produkt- und Herstellerdaten aus, setzt diese in die passende Bildvorlage ein und speichert die erzeugten Dateien in den vorgesehenen Medienordnern ab.

xt_garantielabel.png
wl_645ee45aeab4e82cc9f207b8a8c72b51.png

 

 

  • Eingaben pro Artikel: Garantiedauer und Label-Verfügbarkeit

  • Eingaben pro Hersteller: optionale abweichende Markenbezeichnung

  • Globale Konfiguration: Fallback-Marke, Quelle der Modellnummer, Cron-Verarbeitung

  • Ausgabe: zwei PNG-Dateien je Artikelvariante, sofern die Voraussetzungen erfüllt sind

Wichtig
Ein Label wird nur erzeugt, wenn die Option EU Garantie-Label generieren auf Ja steht und die Garantiedauer größer als 0 ist.

Pflege pro Artikel

Im Artikel-Editor gibt es den Reiter „EU Garantie-Label“. Dort werden die für die Generierung relevanten Werte gepflegt.

Feld

Bedeutung

Feld

Bedeutung

Garantiedauer (Jahre)

Anzahl der Garantiejahre, die auf dem Label erscheint, zum Beispiel 2.

EU Garantie-Label generieren

Schalter Ja/Nein. Nur bei Ja und einem Jahreswert > 0 wird ein Label erzeugt.

Beim Speichern des Artikels wird das Label automatisch erzeugt oder aktualisiert. Wenn sich einer der folgenden Werte ändert, wird beim nächsten Speichern eine neue Version erzeugt:

  • Garantiedauer

  • Marke beziehungsweise Herstellerbezeichnung

  • Modellnummer

Pflege pro Hersteller

Beim Hersteller steht optional ein Feld zur Verfügung, mit dem die auf dem Label angezeigte Marke überschrieben werden kann - falls diese Abweichend von der Herstellerbezeichnung sein soll.

Feld

Bedeutung

Feld

Bedeutung

Abweichende Bezeichnung EU Garantie-Label

Überschreibt den Markennamen auf dem Label für alle Artikel dieses Herstellers.

Leer gelassen

Dann wird automatisch der normale Herstellername verwendet.

Falls einem Artikel kein Hersteller zugeordnet ist, greift der Marken-Fallback aus der Plugin-Konfiguration.

Markenlogik
1. Abweichende Herstellerbezeichnung, wenn gepflegt
2. Normaler Herstellername, wenn vorhanden
3. Marke-Fallback aus der Plugin-Konfiguration, wenn kein Hersteller gesetzt ist

Plugin-Konfiguration

Die zentralen Einstellungen befinden sich im Backend unter Module/Plugins → EU-Garantie-Label.

Einstellung

Bedeutung

Standard

Einstellung

Bedeutung

Standard

Marke-Fallback (wenn kein Hersteller gesetzt)

Markentext, wenn ein Artikel keinen Hersteller hat.

leer

Spalte für Modellnummer

Legt fest, aus welcher Produktspalte die Modellnummer gelesen wird, zum Beispiel products_model, products_ean oder products_mpn.

products_model

Artikel pro Cron-Lauf

Bestimmt, wie viele Artikel ein Cron-Durchlauf verarbeitet. 0 bedeutet alle auf einmal. Für große Kataloge sollte der Wert bewusst klein gewählt werden.

500

Cron für Massen-Erzeugung

Für Bestandsartikel oder große Kataloge gibt es einen Cronjob zur Nachgenerierung fehlender Labels. Dieser wird bei der Installation angelegt und ist standardmäßig INAKTIV.

Zu finden ist er im Backend unter Cronjobs mit der Bezeichnung Warranty Label Generator.

  • Kann manuell aktiviert und getaktet werden

  • Erzeugt fehlende Labels für vorhandene Artikel

  • Überspringt bereits vorhandene Labels

  • Setzt den Lauf beim nächsten Durchgang nahtlos fort

Hinweis für große Kataloge
Den Wert für Artikel pro Cron-Lauf nicht zu hoch wählen um Timeouts oder abbrüche wegen Serverseitigen Limits zu verhindern.

Vorlagen, Dateien und Schriftarten

Die Grundlagen für die Label-Generierung liegt im Plugin-Verzeichnis und werden üblicherweise einmalig durch Administratoren eingerichtet oder kalibriert, bzw sind bei Plugininstallation bereits auf die ausgelieferten Standardvorlagen voreingestellt.

Ort

Inhalt

Ort

Inhalt

plugins/xt_warranty_label/label/label_large.png

Vorlage für das große Label. Die Textfelder sind leer, der QR-Code ist bereits eingebrannt.

plugins/xt_warranty_label/label/label_small.png

Vorlage für das kurze Label. Hier ist nur das Jahresfeld leer.

plugins/xt_warranty_label/label/label_config.php

Definiert Position, Größe und Ausrichtung der Textfelder je Labelvariante.

plugins/xt_warranty_label/font/Inter-*.ttf

Pflichtschrift Inter in den Varianten Regular, SemiBold und ExtraBold.

Anzeige im Template

Der Dateiname des erzeugten Labels wird pro Artikel in der Datenbank gespeichert und steht im Produkt-Template sowie allen Exporten zur Verfügung. Damit kann das Label direkt im Theme eingebunden werden.

Beispiel für das große Label:

{if $xt_plg_warranty_label_file_large} {img img=$xt_plg_warranty_label_file_large type=w_media_warrantylabel_large width=350} {/if}

Beispiel für das kurze Label:

{if $xt_plg_warranty_label_file_small} {img img=$xt_plg_warranty_label_file_small type=w_media_warrantylabel_small width=120} {/if}
  • Der width-Wert ist frei wählbar.

Empfohlener Ablauf

  1. Plugin-Konfiguration prüfen, insbesondere Modellnummer-Spalte und Marke-Fallback.

  2. Im Artikel die Garantiedauer setzen und die Generierung aktivieren.

  3. Artikel speichern, damit die Labels erzeugt und Datenbankfelder aktualisiert werden.

  4. Für bestehende Kataloge den Cronjob aktivieren und in sinnvollen Intervallen laufen lassen.

  5. Labels im Template über die bereitgestellten Variablen einbinden.

FAQ

Wenn sich Garantiedauer, Marke oder Modellnummer ändern und der Artikel anschließend gespeichert wird.

Nein. Der Cron ist für die Nachgenerierung fehlender Labels gedacht und überspringt bereits vorhandene Dateien.

Dann greift der in der Plugin-Konfiguration definierte Marke-Fallback. Ist auch dieser leer, steht kein alternativer Markentext zur Verfügung.

Support
Shop Support: Support zum Shop und anderen
Produkten von xt:Commerce.

Fehler melden
Report a Bug: Fehler gefunden?
Informieren Sie uns.

xt:Commerce Marketplace
Plugins & Templates: Über 500 Möglichkeiten in unserem
Store zur Shop-Optimierung.

xt:Commerce Service Team
Services: Wir übernehmen individuelle
Anpassungen für Ihren Shop.

Impressum