Installation – EU Gewährleistungs-Label¶

Voraussetzungen¶

Punkt	Anforderung
Shopware-Version	6.5.x, 6.6.x oder 6.7.x
PHP	≥ 8.1
Sales-Channel	mindestens einer mit Storefront-Domain

Variante A: Über den Shopware Store¶

Erweiterungen → Im Store → „EU Gewährleistungs-Label" suchen
Plan auswählen (monatlich oder jährlich) und kaufen
Erweiterungen → Meine Erweiterungen → installieren und aktivieren
Cache wird automatisch geräumt

Variante B: ZIP-Upload¶

cd /var/www/shopware/custom/plugins
unzip /pfad/zu/KommoraEuWarrantyLabel-1.x.x.zip

cd /var/www/shopware
php bin/console plugin:refresh
php bin/console plugin:install --activate KommoraEuWarrantyLabel
php bin/console cache:clear

Nach der Installation¶

Das Plugin legt automatisch ein Custom-Field-Set namens „EU-Gewährleistung & Hersteller-Garantie" an.
An jedem Produkt erscheint ab sofort der Standard-Gewährleistungs-Hinweis – auch ohne Konfiguration.
Im Admin Einstellungen → System → Plugins → EU Gewährleistungs-Label zur Feinjustierung der Anzeige.

Storefront-Test¶

Storefront-URL aufrufen
Beliebiges Produkt öffnen
Unter dem Preis erscheint der Banner: > 2 Jahre gesetzliche Gewährleistung gemäß EU-Verbraucherrecht

Wenn der Banner nicht erscheint:

Cache leeren (bin/console cache:clear)
Storefront-Build (bin/build-storefront.sh)
Bei stark angepassten Themes ggf. den Block-Hook prüfen

Custom Field am Produkt¶

Im Admin → Produkt öffnen → Tab „EU-Gewährleistung":

Feld	Bedeutung
Garantie vorhanden	Bool. Wenn aktiv, wird zusätzlich zur Gewährleistung der Hersteller-Garantie-Hinweis angezeigt.
Garantie-Marke	String, z.B. „HP" oder „Apple". Wird im Anzeige-Text eingesetzt.
Garantiedauer	Zahl in Jahren (1–10).

Wenn die Felder leer sind: nur Gewährleistungs-Hinweis (Standardfall).

Deinstallation¶

Mit Datenerhalt¶

Plugin deaktivieren und entfernen. Custom-Field-Set und Werte bleiben in der DB.

Mit kompletter Datenlöschung¶

Beim Deinstallieren das Häkchen „Daten löschen" setzen:

Custom Fields werden aus product_translation.custom_fields per JSON_REMOVE entfernt
Custom-Field-Set wird gelöscht
Einträge in system_config werden entfernt

→ Weiter mit Konfiguration oder Produktspezifische Garantie.