Search by

ospo / module-warranty-notice

splendidinternet

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

Issues

Type:magento2-module

pkg:composer/ospo/module-warranty-notice

Statistics

Installs: 4

Dependents: 0

Suggesters: 0

1.0.4 2026-10-16 17:25 UTC

This package is auto-updated.

Last update: 2026-11-17 18:55:12 UTC


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)

Quelle: https://commission.europa.eu/publications/high-resolution-vector-files-eu-notice-and-label-product-guarantees_en

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.

PfadStandardBedeutung
ospo_warranty_notice/general/enabled1Mitteilung 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.