Handbuch CLP Information.

Installation, Produkt-Zuordnungen, Stammdatenpflege, CSV-Import und die Anzeigeeinstellungen. Stand Version 1.0.13.

Systemvoraussetzungen

Shopware ab 6.6 bis einschließlich 6.7. Das Plugin legt bei der Installation eigene Datenbanktabellen an und befüllt sie mit Stammdaten.

Was bei der Installation entsteht: 274 H-, P- und EUH-Sätze mit vollem Wortlaut sowie sechs GHS-Piktogramme (GHS02, GHS05, GHS06, GHS07, GHS08, GHS09). Du kannst sofort zuordnen, ohne vorher Stammdaten zu pflegen.

Installation

Das ZIP im Shopware-Admin unter Erweiterungen, Meine Erweiterungen hochladen, danach installieren und aktivieren. Anschließend den Lizenzschlüssel eintragen, siehe Lizenz.

Das Admin-Modul

Das Modul liegt unter Erweiterungen, Stone & Water - Plugin Suite und heißt Stone & Water - CLP Information. Es gliedert sich in vier Bereiche: Produkt-Zuordnungen, H/P-Sätze, Piktogramme und Einstellungen.

Die Listen der Produkt-Zuordnungen und der H/P-Sätze sind auf 25 Einträge je Seite ausgelegt und werden serverseitig geblättert. Die Suche bei den Produkten läuft ebenfalls serverseitig und findet über Produktname, Artikelnummer, zugeordnete H/P-Codes und Wortlaute, Piktogramme und Signalwort.

Produkt-Zuordnung anlegen

Eine Zuordnung besteht aus vier Angaben: Signalwort, Piktogramme, H- und P-Sätze und Freitext. Keine davon ist Pflicht.

  • Signalwort: Achtung oder Gefahr.
  • Piktogramme: Auswahl über Kacheln.
  • H/P-Sätze: Auswahl mit Suche, Vorschläge erscheinen beim Tippen.
  • Freitext: für alles, was die Standardsätze nicht abdecken.

Es lassen sich mehrere Produkte nacheinander suchen und sammeln. Die Angaben werden dann beim Speichern für alle ausgewählten Produkte gemeinsam angelegt.

Dynamische Produktgruppen

Zusätzlich oder anstelle einzelner Produkte lässt sich eine dynamische Produktgruppe auswählen. Das Dropdown ist durchsuchbar und zeigt die Anzahl der enthaltenen Produkte.

Beim Speichern wird die Zuordnung für alle Produkte der Gruppe angelegt. Große Mengen laufen gebündelt in Blöcken zu 50 Produkten. Pro Vorgang sind maximal 2500 Produkte möglich, darüber erscheint eine Fehlermeldung.

Überschreiben

Existiert für eines oder mehrere der ausgewählten Produkte bereits eine Zuordnung, erscheint ein Bestätigungsdialog mit der Liste der betroffenen Produkte, die ersten 50 samt Zähler für weitere.

Bei Bestätigung werden Signalwort, Piktogramme, H/P-Sätze und Freitext durch die neuen Werte ersetzt. Bei Abbruch wird nichts gespeichert.

Varianten

Hat eine Variante keine eigene Zuordnung, greift automatisch die Zuordnung des Hauptprodukts. Du musst also nicht jede Variante einzeln pflegen - nur dort, wo eine Variante abweichend gekennzeichnet werden muss.

H- und P-Sätze

Im Tab H/P-Sätze stehen die 274 mitgelieferten Sätze. Sie lassen sich ergänzen, ändern und löschen.

Für das Löschen gibt es Checkboxen und eine Sammelaktion. Ein Bestätigungsdialog listet auf, was verschwindet. Gelöschte Sätze werden zugleich aus allen Produkt-Zuordnungen entfernt und verschwinden aus offenen Editor-Auswahlen.

Piktogramme

Neben den sechs GHS-Piktogrammen lassen sich eigene anlegen: Code, Bezeichnung und eine Grafik als SVG, PNG, JPG oder WebP. Die Datei wird in der Shopware-Medienverwaltung abgelegt und im Storefront sowie in den Auswahlkacheln verwendet. Bestehende Piktogramme können eine neue Grafik erhalten oder gelöscht werden.

Hover-Text: Je Piktogramm lässt sich optional ein Hover-Text hinterlegen. Er erscheint im Storefront als Tooltip, wenn der Kunde mit der Maus über das Piktogramm fährt, und wird zusätzlich als alt-Attribut gesetzt. Ohne Hover-Text werden wie sonst Code und Bezeichnung angezeigt.

Touch-Geräte: Ohne Mauszeiger gibt es kein Hover. Auf Smartphones und Tablets wird der Tooltip deshalb nicht eingeblendet - die Information sollte also nicht ausschließlich dort stehen.

CSV-Import und -Export

H/P-Sätze und Piktogramme lassen sich im jeweiligen Tab als CSV exportieren und wieder importieren. Der Export ist UTF-8 mit BOM und Semikolon als Trennzeichen, also direkt in Excel zu öffnen.

Der Import ist ein Upsert über die Spalte code: bestehende Codes werden aktualisiert, neue angelegt, gelöscht wird nichts. Semikolon oder Komma werden automatisch erkannt, Anführungszeichen und Zeilenumbrüche innerhalb von Feldern werden korrekt verarbeitet.

Spalten H/P-Sätze: code, wording, legacy_id.
Spalten Piktogramme: code, name, hover_text, image_url, legacy_id.

Enthält die Spalte image_url eine Adresse, wird das Bild serverseitig geladen, in der Medienverwaltung abgelegt und dem Piktogramm zugewiesen. Weil der Download auf dem Server passiert, gibt es keine Probleme mit externen Quellen. Unveränderte Bild-URLs werden erkannt und übersprungen, damit keine Duplikate entstehen. Fehlgeschlagene Downloads werden gezählt und in der Ergebnismeldung ausgewiesen, der restliche Import läuft weiter.

Position der Anzeige

Unter Einstellungen, Anzeige im Storefront wird festgelegt, wo die CLP-Angaben erscheinen:

  • In der Buy-Box - direkt beim Preis und Kauf-Button.
  • Unter der Produktbeschreibung - im Textbereich weiter unten.
  • Buy-Box und Beschreibung - an beiden Stellen.

Über den Schalter „CLP-Anzeige aktiv" lässt sich die komplette Ausgabe ein- und ausblenden.

Die Überschrift im Storefront lautet „Einordnung nach CLP-Verordnung", der Ausklapper heißt „Weitere Informationen". Beides sind Shopware-Textbausteine und unter Einstellungen, Shop, Textbausteine anpassbar.

Ausklapper

Zwei Einstellungen steuern das Aufklappverhalten:

H/P-Sätze direkt ausgeklappt. Ist die Option aktiv, ist der Ausklapper beim Seitenaufruf bereits geöffnet.

Alles im Ausklapper darstellen. Damit wandern auch Piktogramme, Signalwort und Freitext in den Ausklapper und werden erst nach Klick sichtbar. Standard ist aus, das heißt Piktogramme und Signalwort stehen sofort sichtbar.

Nur Wortlaut anzeigen

Standardmäßig steht links der Code und rechts der Wortlaut, in einem zweispaltigen Raster mit fester Code-Spalte, sodass alle Wortlaute an derselben Kante beginnen. Auf schmalen Displays steht der Code über dem Wortlaut.

Mit der Option „Nur Wortlaut der H/P-Sätze anzeigen" entfällt die Code-Spalte. Dann steht nur der Satztext über die volle Breite. Standard ist aus.

Lizenz

Die Lizenz wird auf der Vorschaltseite des Admin-Moduls aktiviert. Erst danach sind die Bereiche des Moduls zugänglich. Geprüft wird gegen unsere Lizenzplattform, gebunden an die Shop-Domain.

Problemlösung

Auf der Produktseite steht nichts. Prüfen, ob die CLP-Anzeige in den Einstellungen aktiv ist, ob für das Produkt überhaupt eine Zuordnung existiert und ob die Lizenz aktiv ist. Danach den Shop-Cache leeren.

Eine Variante zeigt die falschen Angaben. Ohne eigene Zuordnung erbt die Variante vom Hauptprodukt. Soll sie abweichen, braucht sie eine eigene Zuordnung.

Nach dem CSV-Import fehlen Bilder. Die Ergebnismeldung nennt die Zahl fehlgeschlagener Downloads. Meist ist die Bild-URL nicht öffentlich erreichbar.

Der Tooltip erscheint nicht. Auf Touch-Geräten wird er bewusst nicht eingeblendet, weil es dort kein Hover gibt.

Support

Fragen und Wünsche direkt an uns: Kontakt. Support kommt vom Entwickler, nicht von einer Hotline.

Über den Store oder direkt bei uns.

Zwei Wege, derselbe Funktionsumfang - such dir aus, was besser zu deinem Setup passt.

Direkt über Stone & Water

Ab sofort möglich

Monatlich4,99 €
Halbjährlich24,99 €17 % günstiger
Bester PreisJährlich44,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.