Zum Inhalt

Troubleshooting – EU Gewährleistungs-Label

Label erscheint nicht im Storefront

  1. Plugin aktiv? Erweiterungen → Meine Erweiterungen → EU Gewährleistungs-Label.
  2. Konfig: Gewährleistungs-Hinweis aktiv für den jeweiligen Sales-Channel?
  3. Cache leeren (bin/console cache:clear) + Theme neu kompilieren (bin/build-storefront.sh).
  4. Theme-Override: Bei stark angepassten Themes (z.B. ThemeWare, TWT) muss der Block-Hook ggf. anders integriert werden – Support kontaktieren.

Garantie-Hinweis erscheint nicht obwohl Custom Field gepflegt

Typisches Symptom: Custom Field „Garantie vorhanden" ist am Produkt aktiviert, im Storefront zeigt sich aber nur der Gewährleistungs-Hinweis ohne Garantie-Block.

Häufigste Ursachen:

  1. translated.customFields vs. roher Customfield-Layer. Das Plugin liest seit 1.0.1 immer product.translated.customFields – wenn Du eine alte Version (1.0.0) hast, update bitte. Die alte Version las direkt product.customFields, was bei nicht in Standardsprache gepflegtem Custom Field leer wirkte.
  2. Plugin-Konfig: „Garantie-Hinweis aktiv" = aus
  3. Garantiedauer = 0 – Dauer muss > 0 sein, sonst wird nichts angezeigt
  4. Garantie-Marke leer – Default-Marke in der Plugin-Konfig setzen, oder pro Produkt pflegen
Update auf 1.0.1+

Das Translation-Issue wurde mit 1.0.1 (Mai 2026) behoben. Wer auf 1.0.0 ist, sollte updaten.

Falscher Text wird angezeigt

Symptom: Der Hinweistext ist nicht der von Dir konfigurierte.

  1. Snippet-Set prüfen: Welches Set ist für den Sales-Channel aktiv? Suche unter Einstellungen → Shop → Textbausteine nach kommora.warranty.* und prüfe die Werte im aktiven Set.
  2. Browser-Cache leeren – die Texte werden nicht häufig geändert, daher cached der Browser hartnäckig.
  3. HTTP-Cache (z.B. Varnish, Cloudflare) leeren.

Bestellbestätigung zeigt das Label nicht

  1. Plugin-Konfig: „In Bestellbestätigung anzeigen" aktiv?
  2. Mail-Template prüfen: ist das Standard-Template aktiv? Falls Du ein Custom-Template hast, musst Du den Plugin-Block manuell einfügen: 
    {{ kommora_warranty_html(order.lineItems[0].product.id) }}
  3. Mail-Versand funktioniert generell? (Test mit Standard-Bestätigungsmail.)

Custom Field erscheint nicht im Admin-Produkt-Tab

Symptom: Im Admin-Produkt-Tab „Custom Fields" fehlt die Box „EU-Gewährleistung".

  1. Plugin neu aktivieren: deaktivieren, aktivieren. Beim Activate wird das Set neu angelegt.
  2. DB prüfen: 
    SELECT * FROM custom_field_set WHERE name = 'kommora_eu_warranty';
SELECT * FROM custom_field_set_relation WHERE set_id IN
    (SELECT id FROM custom_field_set WHERE name = 'kommora_eu_warranty');
  3. Wenn Custom-Field-Set fehlt: per CLI das Plugin reinstall: 
    php bin/console plugin:uninstall KommoraEuWarrantyLabel
php bin/console plugin:install --activate KommoraEuWarrantyLabel

Label überlagert anderen Theme-Content

Symptom: Der Banner sieht im Theme schief aus oder überlagert andere UI-Elemente.

  1. Position in der Konfig prüfen – versuche „über dem Preis" oder „unter dem Buy-Button".
  2. Custom CSS-Klasse in der Konfig setzen → in Deinem Theme die .kommora-warranty-banner.<deine-klasse>-CSS anpassen.
  3. Kompakt-Modus aktivieren – ein Badge statt Banner.

Performance-Auswirkung

Das Plugin verursacht praktisch keinen messbaren Performance-Impact. Falls Du dennoch Auffälligkeiten bemerkst:

  • Listing-Anzeige aus – wenn nicht zwingend nötig, schalte die Anzeige in Listing-Cards aus (default ist es aus).
  • Modal aus – wenn keine Modals erscheinen müssen, deaktiviere die Option.

Hilfe holen

E-Mail an support@kommora.de mit:

  • Shopware- und Plugin-Version
  • Sales-Channel-Konfiguration (Domain + Sprache)
  • Theme-Name
  • Screenshot des fehlerhaften Verhaltens
  • Konfigurations-Export (über „Konfiguration als JSON" Button in der Plugin-Konfig)