ospo / module-warranty-notice
Harmonisierte EU-Mitteilung zum gesetzlichen Gewährleistungsrecht (VO (EU) 2025/1960) im Shop und in der Bestellmail
Package info
codeberg.org/OSPO/magento2-module-warranty-notice
Type:magento2-module
pkg:composer/ospo/module-warranty-notice
Requires
- php: ~8.3.0||~8.4.0
- magento/framework: *
- magento/module-checkout: *
- magento/module-sales: *
- magento/module-theme: *
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Zeigt die harmonisierte EU-Mitteilung über das gesetzliche Gewährleistungsrecht, die Online-Shops für Verbraucher seit 27.09.2026 vor Vertragsschluss hervorgehoben bereitstellen müssen (Richtlinie (EU) 2024/825, Durchführungsverordnung (EU) 2025/1960, in Deutschland Art. 246a § 1 Abs. 1 Nr. 11 EGBGB).
Die Mitteilung ist eine Grafik, deren Elemente nicht verändert werden dürfen. Online ist die farbige Fassung zu verwenden, lesbar in Standardgröße, mit einem klickbaren Link zum selben Ziel wie der QR-Code. Das Modul enthält deshalb die amtlichen Dateien der Europäischen Kommission unverändert:
view/frontend/web/images/legal-guarantee-notice-de.svg,-en.svg(Vektor, für die Anzeige im Shop)view/frontend/web/images/legal-guarantee-notice-de.png(für die Bestellmail, viele Mailprogramme zeigen kein SVG)
Was das Modul tut
Nach den praktischen Leitlinien der Kommission (April 2026) erscheint ein Link „Ihre gesetzlichen Gewährleistungsrechte". Beim ersten Klick öffnet sich die vollständige Mitteilung. Der Link steht:
- im Footer des Hyvä-Themes (allgemeiner Hinweis auf allen Seiten),
- auf Kategorie- und Suchergebnisseiten,
- im Warenkorb und im Checkout (auch im Luma-Checkout).
Der Dialog ist ein natives <dialog> mit einfachem JavaScript ohne Alpine.js, damit er in Hyvä und Luma gleich funktioniert. Er lässt sich mit der Tastatur bedienen und mit Esc schließen. Für Screenreader steht der Text der deutschen Mitteilung zusätzlich als unsichtbarer Text im Dialog. Auf schmalen Bildschirmen wird die Grafik nicht verkleinert, sondern lässt sich seitlich scrollen, damit sie lesbar bleibt.
In der Bestellbestätigung hängt das Modul die Mitteilung (PNG) mit Link an die Artikelliste an.
Konfiguration
Im Backend unter Shops -> Konfiguration -> OSPO -> EU-Gewährleistungshinweis, je Website oder Store-Ansicht, oder per bin/magento config:set.
| Pfad | Standard | Bedeutung |
|---|---|---|
ospo_warranty_notice/general/enabled | 1 | Mitteilung ausgeben, je Website oder Store-Ansicht einstellbar |
Für eine reine B2B-Website mit Zugangssperre kann die Mitteilung abgeschaltet werden: bin/magento config:set --scope=websites --scope-code=<code> ospo_warranty_notice/general/enabled 0.
Sprachen
Enthalten sind Deutsch und Englisch, andere Store-Sprachen bekommen die englische Fassung. Weitere Sprachen: die amtliche Datei als legal-guarantee-notice-<sprache>.svg ablegen und die Sprache mit dem Link-Ziel aus den Leitlinien in ViewModel/Notice.php ergänzen.
Nicht enthalten
Die GARAN-Kennzeichnung für Herstellergarantien über zwei Jahre (Anhang II der Verordnung). Sie gilt je Produkt und braucht Herstellerangaben.
Installation
composer require ospo/module-warranty-notice
bin/magento module:enable Ospo_WarrantyNotice
bin/magento setup:upgrade
Im Production-Modus danach bin/magento setup:di:compile und bin/magento setup:static-content:deploy.
Lizenz: OSL-3.0, wie Magento Open Source und Mage-OS. Die Grafiken der Mitteilung stammen von der Europäischen Kommission und dürfen unverändert weiterverwendet werden.