Die Produktdetailseite eines Tresors braucht Feuerschutz und Schlossart, die eines Rucksacks Material und Volumen. Wer das in Magento sauber zeigen will, schreibt es meist in die Beschreibung, und das Datenblatt hängt als Link irgendwo im Fließtext. Dann stimmt eine Zahl im Attribut und eine andere im Text, und niemand weiß, welche gilt. Wir zeigen, wie du die Produktdetailseite in Magento pflegbar aufwertest: Eckdaten kommen als Highlights aus den Attributen, Dokumente hängen als Anhänge am Produkt. Beides bleibt in den Stammdaten.
Warum Beschreibungstexte der falsche Ort für Produktdaten sind
Was in einer Beschreibung steht, existiert nur dort. Export, Filter, Vergleichstabelle, Feed: nichts davon sieht den Satz “feuerfest bis 60 Minuten” in einem Textfeld. Ändert sich der Wert, muss jemand den Text finden und von Hand anpassen. Bei einem Katalog mit mehreren Kategorien passiert das irgendwann nicht mehr.
Magento kennt die strukturierte Variante, hat aber eine enge Auffassung davon. Attribute, die im Storefront sichtbar sind, erscheinen in der Tabelle unter “Mehr Informationen”. Gleiche Darstellung für alle Kategorien, kein Icon, weit weg vom Bestellformular. Und für Datenblätter, Montageanleitungen oder Zertifikate gibt es im Standard keinen Download-Bereich am Produkt. Also landet alles im Beschreibungstext, oder jemand legt PDFs im Medienverzeichnis ab und verlinkt sie händisch.
Unsere Haltung dazu ist einfach: Wenn eine Information ein Attribut hat, soll die Produktseite sie von dort holen. Dafür haben wir zwei Module.
Product Highlights: Eckdaten pro Kategorie aus Attributen
Product Highlights legt am Kategorieformular einen Abschnitt “Product Highlights” an (Katalog → Kategorien). Jede Zeile besteht aus einem Produktattribut, einem optionalen Icon und einem Alternativtext. Bleibt der Alternativtext leer, nimmt das Modul die Bezeichnung des Attributs. Die Reihenfolge der Zeilen ist die Reihenfolge auf der Seite, per Drag-and-drop änderbar.
Auf der Produktseite erscheinen Attributbezeichnung und Wert des jeweiligen Produkts. Hat ein Produkt für ein Attribut keinen Wert, entfällt die Zeile nur bei diesem Produkt. Bei Auswahllisten steht der Text der gewählten Option da, bei Mehrfachauswahl alle Optionen mit Komma getrennt. Es gibt also keine leeren “Material: “-Zeilen, und niemand pflegt etwas doppelt.
Vererbung entlang des Kategoriebaums
Du musst nicht jede Unterkategorie einzeln konfigurieren. Ein Produkt übernimmt die Konfiguration seiner Kategorie, und hat diese keine eigene, die der Oberkategorie, bis zur Wurzel. Das Beispiel aus der Doku: “Tresore” hat Feuerschutz und Schlossart, “Wertschutzschränke” darunter nichts und erbt beides, “Möbeltresore” hat nur Gewicht und zeigt deshalb auch nur Gewicht.
Das ist der Punkt, an dem man sich vertut. Die Konfiguration einer Unterkategorie ergänzt die der Oberkategorie nicht, sie ersetzt sie. Wer in “Möbeltresore” Gewicht ergänzen will und Feuerschutz weiter sehen möchte, trägt beides ein. Liegt ein Produkt in mehreren Kategorien, gilt die tiefste Kategorie des aktuellen Store-Baums, und kommt der Besucher über eine Kategorieseite, gilt diese. Das Attribut hat außerdem Store-Scope, ein fremdsprachiger Store View kann also andere Attribute zeigen.
Icons und die SVG-Prüfung
Erlaubt sind SVG und PNG bis 1 MB. Über “Auswählen” greifst du auf bereits hochgeladene Icons zurück, damit dasselbe Symbol nicht für jede Kategorie neu hochgeladen wird. Die Dateien liegen in pub/media/catalog/category/highlight_icons.
SVG verdient einen zweiten Blick. Eine SVG-Datei ist XML und kann Skripte, Ereignisattribute wie onload oder externe Verweise enthalten. Magento prüft SVG-Markup selbst nicht. Das Modul prüft deshalb vor dem Schreiben Dateiendung, MIME-Typ und bei SVG das Markup, und lehnt Dateien mit Skripten, Ereignisattributen, eingebetteten Fremdinhalten oder externen Verweisen ab. Ein Icon-Upload für Redakteure ist damit kein Einfallstor mehr. Wer schon einmal Sicherheitslücken in Magento-Shops nachgelesen hat, weiß, warum wir das für keine Kleinigkeit halten.
Product Attachments: Datenblätter, Anleitungen, Zertifikate am Produkt
Product Attachments löst das zweite Problem. Unter Katalog → Produktanhänge legst du einen Anhang an: Name, optionale Beschreibung, Datei-Upload (erlaubt sind unter anderem PDF, DOC, DOCX, XLS, XLSX, PPTX, CSV, TXT, ZIP, JPG, PNG und MP4) oder alternativ eine externe URL. Dazu kommen Kundengruppe (Pflichtfeld), Store und ein Aktiv-Schalter.
Ein Anhang kann mehreren Produkten zugewiesen werden, ein Produkt mehrere Anhänge haben. Zugewiesen wird im Anhang-Formular im Tab “Produkte auswählen”. Ein Sicherheitsdatenblatt für eine ganze Produktfamilie legst du damit einmal ab. Wird es ersetzt, ändert sich die Datei an einer Stelle.
Im Frontend erscheint ein Downloads-Tab oder, je nach Einstellung, ein Block unter der Produktbeschreibung. Jede Zeile zeigt Namen, optional Dateigröße und ein Icon. Konfiguriert wird unter Shops → Konfiguration → CopeX → Product Attachment: Modul aktivieren, Anzeige als Tab, Dateigröße anzeigen, Bezeichnung des Tabs (Standard “Product Attachment”, für deutsche Shops einfach überschreiben) und Icon-Typ. Eigene Icons je Dateityp pflegst du unter Katalog → Produktanhänge → Icons verwalten.
Die Steuerung nach Kundengruppe ist im B2B-Umfeld der eigentliche Hebel. Preislisten oder technische Unterlagen, die nur Wholesale-Kunden sehen sollen, lassen sich so an das Produkt hängen. Gäste sehen nur Anhänge, bei denen die Gruppe “NOT LOGGED IN” gewählt ist. Das ist aber eine reine Sichtbarkeitsregel auf der Produktseite. Hochgeladene Dateien liegen unter pub/media/productattach/ und werden direkt vom Webserver ausgeliefert, es gibt keinen Download-Controller mit Berechtigungsprüfung. Wer die URL kennt, kann die Datei auch ohne Login laden. Für Preislisten, die wirklich nur Wholesale-Kunden sehen dürfen, reicht das Modul deshalb nicht, dafür braucht es geschützte Auslieferung.
Was die Module nicht tun
- Keine Redaktion der Werte. Beide Module zeigen, was in den Stammdaten steht. Fehlen die Attributwerte, bleibt die Highlight-Zeile leer. Die Datenqualität kommt aus deinem PIM, ERP oder Import, nicht aus dem Modul.
- Highlights ersetzen, ergänzen nicht. Siehe Vererbung oben. Das ist gewollt, aber man muss es wissen.
- Hyvä-Platzierung. Das Standard-Template gibt nur ihm bekannte Kindblöcke aus. Das Modul verschiebt die Highlights deshalb in den Container
alert.urls, auf breiten Bildschirmen stehen sie neben dem Lagerstatus. Wer sie zwischen Sternen und Kurzbeschreibung will, braucht einen eigenen Container im Theme. Die Doku zeigt das Layout-XML dafür. - Kein Schutz der Dateien. Siehe Kundengruppen oben: Die Kundengruppe blendet nur den Link aus.
- Kein Import und keine Zuweisung per Attribut. Anhänge werden im Admin pro Anhang den Produkten zugewiesen. Für große Mengen gibt es eine REST-API zum Anlegen, Ändern, Lesen und Löschen von Anhängen (inklusive Dateiinhalt und Produktliste). Damit lässt sich ein Datenblatt-Import aus PIM oder ERP bauen, das ist aber Projektarbeit.
- Eigenes Markup entsteht durch Template-Austausch im Theme. Das ist Theme-Arbeit, keine Konfiguration.
Installation und Voraussetzungen
Product Highlights: Magento 2.4.7 bis 2.4.9, PHP 8.1 bis 8.5, Luma oder Hyvä, keine weiteren Module nötig.
composer require copex/module-producthighlights
php bin/magento module:enable CopeX_ProductHighlights
php bin/magento setup:upgrade
php bin/magento cache:flushsetup:upgrade legt das Kategorie-Attribut highlight_attributes an. Die aufgelöste Konfiguration wird je Kategorie und Store View im Cache-Typ “Collections Data” gehalten. Beim Speichern einer Kategorie wird sie automatisch verworfen, nach Importen oder direkten Datenbankänderungen hilft bin/magento cache:clean. Fehler landen in var/log/system.log und brechen die Produktseite nie ab.
Product Attachments: Magento 2.4.7 bis 2.4.9, PHP 8.3 bis 8.5, Hyvä-Theme-Modul (das Frontend-Template und das ViewModel nutzen es).
composer require copex/module-product-attachment
php bin/magento module:enable CopeX_ProductAttachments
php bin/magento setup:upgrade
php bin/magento cache:flushDas Upload-Verzeichnis pub/media/productattach/ braucht Schreibrechte und wird beim ersten Upload angelegt. Beide Module sind Software der CopeX GmbH und setzen eine Lizenzvereinbarung voraus. Eine Übersicht findest du auf der Modulseite.
Was du als nächstes tun kannst
Wenn deine Produktseiten Eckdaten und Dokumente heute in Textfeldern verstecken, gibt es zwei pragmatische erste Schritte:
- Attribut-Inventur: Nimm dir drei Kategorien und notiere, welche fünf Eckdaten Kunden dort tatsächlich suchen. Prüfe, ob es dafür schon Attribute gibt und ob sie gefüllt sind. Die Antwort sagt dir, ob das Problem in der Darstellung oder in den Stammdaten liegt.
- Umsetzung mit uns: Wir richten Highlights und Anhänge ein, passen die Platzierung im Theme an und klären die Anbindung an dein PIM oder ERP. Passend dazu unsere Leistungen für Content und Pflege und Hyvä. Schreib uns für ein Erstgespräch oder an office@copex.io.
Verwandte Themen aus unserem Blog: GARAN-Label in Magento 2 umsetzen (ebenfalls ein Fall von Pflichtinfos aus Produktattributen), Strukturierte Datenformate für Magento-Händler und Sicherheit in Magento 2.
