SW Shopware 6 Shopware Anfänger

DfGpsr SW — Vollständiger Leitfaden

DfGpsr SW installieren, konfigurieren und betreiben: GPSR-Sicherheitsinformationen (Hersteller, verantwortliche Person in der EU, Warnhinweise, Dokumente) auf Ihren Produktseiten, mit Fallback-Werten pro Verkaufskanal, für Shopware 6.5, 6.6 und 6.7.

Aktualisiert Modulversion 1.0.0

DfGpsr SW zeigt auf Ihren Shopware-Produktseiten die Sicherheitsinformationen an, die nach der Verordnung (EU) 2023/988 — der Produktsicherheitsverordnung (GPSR), in Kraft seit dem 13. Dezember 2024 — verpflichtend sind. Shopware bietet dafür nichts Solides von Haus aus. DfGpsr SW schließt diese Lücke mit Zusatzfeldern pro Produkt, shopweiten Fallback-Werten, die pro Verkaufskanal konfigurierbar sind, und automatischer Anzeige unterhalb der Produktbeschreibung. Das Plugin ist bewusst ohne eigene Admin-Komponenten und ohne Storefront-JavaScript gebaut: ein und dasselbe ZIP installiert sich identisch auf Shopware 6.5, 6.6 und 6.7, ohne Kompilierung. Dieser Leitfaden behandelt Installation, globale Konfiguration, Dateneingabe pro Produkt, Übersetzung, Template-Anpassung und Fehlerbehebung.

DfGpsr SW ist ein technisches Anzeige-Werkzeug. Es hilft Ihnen, die geforderten Informationen darzustellen, doch die Richtigkeit und Vollständigkeit der eingegebenen Daten liegen in Ihrer Verantwortung, ebenso die Prüfung, ob die Verordnung auf Ihre Produkte anwendbar ist. Dieser Leitfaden stellt keine Rechtsberatung dar.

Was die GPSR vorschreibt

Beim Online-Verkauf verlangt die Verordnung (EU) 2023/988, dass jedes Angebot vor dem Kauf deutlich anzeigt:

  • den Hersteller: Name, Postanschrift und elektronische Adresse;
  • die in der EU niedergelassene verantwortliche Person (Artikel 16), wenn der Hersteller außerhalb der Union ansässig ist: Name, Postanschrift und elektronische Adresse;
  • die Warnhinweise und Sicherheitsinformationen in der Sprache des Ziellandes.

DfGpsr SW deckt diese drei Anforderungen ab, dazu eine Liste von Sicherheitsdokumenten (Anleitungen, Sicherheitsdatenblätter, Zertifikate) und einen Ausblenden-Schalter für Artikel außerhalb des Anwendungsbereichs der Verordnung.

Installation

  1. Laden Sie das Archiv DfGpsr-v1.0.0.zip aus Ihrem DataFirefly-Konto herunter.
  2. Kopieren Sie den entpackten Ordner DfGpsr in custom/plugins/ Ihres Shopware oder installieren Sie das ZIP über Administration → Erweiterungen → Meine Erweiterungen → Erweiterung hochladen.
  3. Installieren und aktivieren: 
    bin/console plugin:refresh
bin/console plugin:install --activate DfGpsr
bin/console cache:clear
  4. Bei der Installation legt das Plugin sein Zusatzfeld-Set df_gpsr an der Produkt-Entität an. Bei der Deinstallation ohne Datenerhalt werden dieses Set und alle seine Werte entfernt.

Kompatibel mit Shopware 6.5.x, 6.6.x und 6.7.x auf einer einzigen Codebasis. Es ist kein Storefront- oder Administrations-Build erforderlich, und das Plugin fügt keine Composer-Abhängigkeit hinzu. Genau das garantiert die identische Installation über alle drei Versionen hinweg, einschließlich der neuen 6.7-Administration.

Globale Konfiguration (Fallback-Werte)

Öffnen Sie Erweiterungen → Meine Erweiterungen → DataFirefly GPSR Compliance → ⋯ → Konfigurieren. Die Konfiguration ist in Karten gegliedert:

  • Allgemein: Anzeige des Blocks aktivieren, Abschnittstitel ein- oder ausblenden und eine Option, die Anzeige auch ohne Daten zu erzwingen (für Theming/Debugging reserviert).
  • Standard-Hersteller: Name, Postanschrift und E-Mail, die verwendet werden, wenn ein Produkt keinen eigenen Hersteller definiert.
  • Standard verantwortliche Person in der EU: Name, Postanschrift und E-Mail.
  • Standard-Sicherheitstexte: allgemeine Warnhinweise und Sicherheitsinformationen.

Alle diese Werte sind pro Verkaufskanal über den nativen Shopware-Umschalter oben in der Konfiguration einstellbar. Wählen Sie einen Kanal, um ihm spezifische Werte zuzuweisen, oder belassen Sie „Alle Verkaufskanäle“ für gemeinsame Werte.

Wenn Sie Ihre eigene Marke verkaufen, hinterlegen Sie den Hersteller einmal in der globalen Konfiguration: Der gesamte Katalog ist abgedeckt, ohne ein einziges Produkt anzufassen. Die Felder pro Produkt dienen dann nur noch für Ausnahmen.

Ein Produkt befüllen

Öffnen Sie ein Produkt unter Kataloge → Produkte, dann den Reiter Spezifikationen → Zusatzfelder. Die Gruppe GPSR — Produktsicherheit umfasst folgende Felder:

  • GPSR-Informationen für dieses Produkt ausblenden: Schalter, der für Artikel außerhalb des Anwendungsbereichs der Verordnung aktiviert wird.
  • Hersteller: Name, Postanschrift, E-Mail-Adresse.
  • Verantwortliche Person in der EU: Name, Postanschrift, E-Mail-Adresse.
  • Warnhinweise und Sicherheitsinformationen: Rich-Text-Editoren.
  • Sicherheitsdokumente: eines pro Zeile, im Format Bezeichnung|URL oder einfach eine URL.

Die Auflösungsregel ist einfach: Für jedes Feld verwendet das Plugin den Produktwert, sofern gesetzt, andernfalls greift es auf den Standardwert des Verkaufskanals zurück. Das Feld „Dokumente“ hat keinen globalen Fallback — es ist für jedes Produkt eigenständig.

Format der Sicherheitsdokumente

Geben Sie ein Dokument pro Zeile ein. Zwei Formate werden akzeptiert:

Bedienungsanleitung|https://beispiel.de/anleitung.pdf
Sicherheitsdatenblatt|https://beispiel.de/sdb.pdf
https://beispiel.de/zertifikat.pdf

Beim Format Bezeichnung|URL wird die Bezeichnung zum klickbaren Text; eine URL allein wird unverändert angezeigt. Alle Links öffnen in einem neuen Tab.

Übersetzung

Die Felder sind Standard-Zusatzfelder von Shopware: Sie werden produktweise über den Sprachumschalter der Administration oben auf der Produktseite übersetzt. Geben Sie zum Beispiel die Warnhinweise auf Französisch für die Sprache FR ein und wechseln Sie dann zu DE für die deutsche Version.

Die Storefront-Texte des Blocks (Titel „Produktsicherheit“, „Hersteller“, „Verantwortliche Person in der EU“ usw.) werden nativ in fünf Sprachen mitgeliefert: Deutsch, Englisch, Französisch, Spanisch und Italienisch. Sie werden automatisch entsprechend der Sprache des Verkaufskanals angezeigt, ohne Konfiguration.

Denken Sie daran, Ihre Warnhinweise in der Sprache jedes Ziellandes bereitzustellen: Die GPSR verlangt, dass die Sicherheitsinformationen für den Verbraucher des Zielmarktes verständlich sind.

Storefront-Anzeige

Der GPSR-Block wird automatisch auf der Produktdetailseite eingefügt, direkt nach der Beschreibung, in den Twig-Block page_product_detail_description_content_text. Er stellt den Hersteller und die verantwortliche Person nebeneinander dar, dann die Warnhinweise, die Sicherheitsinformationen und die Dokumentenliste. Der Block blendet sich automatisch aus, wenn keine Daten verfügbar sind — weder am Produkt noch in der globalen Konfiguration.

Template anpassen

Die Anzeigekomponente liegt in views/storefront/component/df-gpsr/gpsr-info.html.twig und wird über views/storefront/page/product-detail/description.html.twig eingefügt. Um den Block zu verschieben oder seine Darstellung zu ändern, überschreiben Sie eine dieser beiden Dateien in Ihrem Theme. Das Basis-Styling ist inline und bewusst neutral, leicht durch eigene Klassen zu ersetzen.

FAQ und Fehlerbehebung

Gilt die GPSR für meinen Shop? Wenn Sie Non-Food-Verbraucherprodukte an Kunden in der EU verkaufen, höchstwahrscheinlich ja. Die Verordnung gilt seit dem 13. Dezember 2024 für die meisten Produkte, einschließlich online verkaufter und aus Drittländern importierter Waren.

Der Block wird nicht angezeigt. Prüfen Sie, ob die Option „Anzeige aktivieren“ in der Konfiguration angehakt ist, ob das Produkt oder die globale Konfiguration mindestens einen Wert enthält, und ob der „Ausblenden“-Schalter am Produkt nicht aktiviert ist. Leeren Sie nach jeder Konfigurationsänderung den Cache.

Der Block wird angezeigt, ist aber leer. Wahrscheinlich ist die Option „auch ohne Daten anzeigen“ aktiv geblieben: Deaktivieren Sie sie, um zum normalen Verhalten (automatisches Ausblenden) zurückzukehren.

Meine Zusatzfelder werden in der 6.7-Admin als einfaches Textfeld dargestellt. Das Mapping der Zusatzfeld-Komponenten hat sich mit der Meteor-Administration weiterentwickelt. Wenn ein Adressfeld als einfacher Input statt als Textbereich dargestellt wird, ist das nur ein Admin-Anzeigedetail ohne Auswirkung auf das Storefront; melden Sie es dem Support für eine Anpassung.

Die Standardwerte werden nicht angewendet. Prüfen Sie, ob Sie die Konfiguration für den richtigen Verkaufskanal ausgefüllt haben. Ein auf „Alle Verkaufskanäle“ gesetzter Wert wird von einem kanalspezifischen Wert überschrieben, falls vorhanden.

Was passiert bei der Deinstallation? Mit der Option zum Löschen der Daten werden das Feld-Set df_gpsr und alle an Produkten eingegebenen Werte entfernt. Ohne sie bleiben die Daten für eine spätere Neuinstallation erhalten.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren