Magex_ManufacturerData

Hinweis (keine Rechtsberatung): Diese Erweiterung schafft die technische Voraussetzung, Herstellerangaben als eigenen Abschnitt auf der Produktseite sichtbar zu platzieren. Ob die Inhalte im Einzelfall ausreichend sind, sollte bei Bedarf rechtlich geprüft werden.

Schnellzugriff

Produktseite: https://www.der-mage-experte.de/herstellerdaten-hyva
Installation: Abschnitt 3 öffnen
Nutzung im Admin: Abschnitt 5 öffnen
Troubleshooting: Abschnitt 8 öffnen

1. Überblick

Magex_ManufacturerData fügt auf der Hyvä-Produktdetailseite eine zusätzliche Section hinzu. In dieser Section wird der Inhalt des Produktattributes manufacturer_info (WYSIWYG/HTML) ausgegeben. Die Section erscheint nur, wenn das Attribut befüllt ist.

Wichtige Eckdaten

Attributcode: manufacturer_info
Standard-Label (Fallback): Manufacturer Info (Englisch)
Deutsches Label: Herstellerangaben
Attributgruppe (global): Magex ManufacturerData
Scope: Store View (mehrsprachig pflegbar)

2. Anforderungen

Magento Open Source / Commerce (getestet in Magento 2.4.8)
Hyvä Themes
PHP-Version gemäß Ihrer Magento-Installation

3. Installation (app/code)

Entpacken Sie die Extension in das Magento-Root-Verzeichnis.
Prüfen Sie, dass der Pfad so aussieht: app/code/Magex/ManufacturerData
Führen Sie die Magento Befehle aus:

bin/magento setup:upgrade
bin/magento cache:flush

Production Mode: Je nach Setup können zusätzlich folgende Schritte erforderlich sein: bin/magento setup:di:compile und bin/magento setup:static-content:deploy.

4. Was passiert beim setup:upgrade?

Beim ersten Lauf werden – sofern noch nicht vorhanden – automatisch folgende Elemente angelegt:

Produktattribut manufacturer_info als WYSIWYG/HTML (Scope: Store View)
Attributgruppe Magex ManufacturerData in allen Produkt-Attributsets (Sortierung weit unten)
Zuordnung des Attributes in diese Gruppe
Store-View-Labels automatisch nach Store-Locale:
- de* → Herstellerangaben
- fr* → Informations du fabricant
- it* → Informazioni del produttore
- alle anderen → Fallback: Manufacturer Info

Wichtig: Wenn ein Attribut mit Code manufacturer_info bereits existiert, wird es nicht neu angelegt. In diesem Fall erfolgt auch keine automatische Umstrukturierung. (Das Verhalten ist bewusst defensiv.)

5. Nutzung im Admin

5.1 Inhalte pflegen

Öffnen Sie ein Produkt im Magento Admin.
Wechseln Sie zur Attributgruppe Magex ManufacturerData.
Befüllen Sie das Feld Manufacturer Info (WYSIWYG).
Speichern Sie das Produkt.

5.2 Store View beachten

Das Attribut ist auf Store View gestellt. Pflege und Sichtbarkeit können somit je Sprache/Store View variieren. Stellen Sie sicher, dass Sie den Inhalt im richtigen Store View pflegen.

6. Ausgabe im Frontend (Hyvä)

Die Section erscheint in den Produktdetails (Accordion/Details-Bereich). Sie wird nur gerendert, wenn der Inhalt von manufacturer_info nicht leer ist.

Hinweis: WYSIWYG-Inhalte werden als HTML ausgegeben und über den Magento CMS-Filter gerendert (z. B. Directives/Widgets, sofern im Shop aktiviert).

7. Übersetzungen

Die Übersetzung des Section-Titels erfolgt über die i18n/*.csv-Dateien. Das Attributlabel im Admin wird zusätzlich je Store View in der Datenbank gespeichert.

Locale	Section / Label
de_DE, de_CH, de_AT, de_*	Herstellerangaben
fr_FR, fr_*	Informations du fabricant
it_IT, it_*	Informazioni del produttore
alle anderen	Manufacturer Info (Fallback)

8. Troubleshooting

8.1 Section wird nicht angezeigt

Prüfen Sie, ob manufacturer_info im aktuellen Store View befüllt ist.
Cache leeren: bin/magento cache:flush
Theme-Overrides: Prüfen Sie, ob Ihr Hyvä-Theme product.info.details / Sections überschreibt.

8.2 Feld/Gruppe ist im Produkt nicht sichtbar

Prüfen Sie im Produkt-Attributset, ob die Gruppe Magex ManufacturerData existiert.
Prüfen Sie unter Stores → Attributes → Product, ob manufacturer_info vorhanden ist.
Führen Sie bin/magento setup:upgrade erneut aus (und prüfen Sie das Log bei Fehlern).

8.3 Übersetzungen greifen nicht

Prüfen Sie die Store-Locale unter Stores → Configuration → General → Locale Options.
Leeren Sie Cache und ggf. Übersetzungs-Caches.
Wenn das Attribut bereits manuell existierte, kann es sein, dass Store-Labels bereits gesetzt sind und nicht überschrieben werden.

9. Deinstallation / Rollback

Das Entfernen/Deaktivieren der Extension entfernt nicht automatisch:

das Attribut manufacturer_info
die Gruppe Magex ManufacturerData
bereits gespeicherte Inhalte

Wenn Sie diese Elemente entfernen möchten, tun Sie das bitte bewusst im Admin bzw. per DB-Änderung.

10. Support

Technischer Support ist innerhalb eines Monats und nach Angabe des Lizenzschlüssels möglich. Auf der Kontaktseite finden Sie alle möglichen Kontaktwege.

Zurück zur Produktseite

Magex_ManufacturerData – Herstellerangaben für Hyvä (Produktseite)