ThemeWare® nutzt verschiedene Zusatzfelder um kategorie- bzw. produktspezifische Informationen in der Storefront nutzen oder darstellen zu können.
In diesem Bereich der Wissensdatenbank erklären wir alle Zusatzfelder von ThemeWare®.
Tipp: Eine Deinstallation kann helfen, wenn du beispielsweise ThemeWare®-Zusatzfelder gelöscht hast. Diese stehen nach einer erneuten Installation wieder zur Verfügung.
Technischer Name:
Der technische Name der ThemeWare® Zusatzfelder hat einen festen Aufbau. Jedes Zusatzfeld besteht aus einem Theme spezifischen Teil und aus einem Zusatzfeld spezifischen Teil.
Grundsätzlicher Aufbau: {Theme spezifisch}__{Zusatzfeld spezifisch}
Der Theme spezifische Teil beginnt mit dem Präfix twt. Darauf folgt der Theme-Name (z.B. modern oder clean) und die Theme-Edition (pro bzw. cloud) des verwendeten Themes. Der Theme spezifische Teil wird durch den Suffix custom_field abgeschlossen. Durch diesen Aufbau sind für jedes Theme individuelle Zusatzfelder möglich.
Theme spezifisch: {Präfix}_{Theme-Name}_{Theme-Edition}_{Suffix}
Nach dem Theme spezifischen Aufbau folgt der Zusatzfeld spezifische Teil. Dieser beginnt mit dem Set (z.B. category oder product) dem das Zusatzfeld angehört. Abschließend folgt der eigentliche Name des Zusatzfeldes (z.B. body_class).
Zusatzfeld spezifisch: {Set}__{Name des Zusatzfeldes}
Alles wird klein geschrieben und mit Unterstrichen getrennt.
Beispiel:
twt_modern_pro_custom_field__category__body_class
{Präfix}_{Theme-Name}_{Theme-Edition}_{Suffix}__{Set}__{Name des Zusatzfeldes}
Vererbung aus der Theme-Konfiguration
Viele ThemeWare®-Zusatzfelder vom Typ "Auswahl" bieten die Option "vererbt aus Theme-Konfiguration". Diese ist die Standard-Option: Der entsprechende Wert wird dann aus der globalen Theme-Konfiguration übernommen.
Wählst du stattdessen "nein"/"ja" (bzw. einen konkreten Wert), gilt diese Einstellung nur für die jeweilige Kategorie bzw. das jeweilige Produkt und überschreibt die Theme-Konfiguration.
Hinweis: Bei einigen Funktionen muss in der Theme-Konfiguration zusätzlich die Darstellungs-Option "anzeigen (per Zusatzfeld)" gewählt sein, damit ein "ja" am Zusatzfeld greift.
Zusatzfeld-Verwaltung
Die von ThemeWare® verwendeten Zusatzfelder kannst du über die Kategorie- bzw. die Produkt-Verwaltung bearbeiten.
Du findest diese zudem in der Zusatzfeld-Verwaltung von Shopware 6. Von einer Bearbeitung dieser technischen Informationen raten wir aber dringend ab. Eine fehlerfreie Funktionalität können wir derzeit nur gewährleisten wenn die Felder nicht bearbeitet werden.
Wichtig: Wir raten von der Bearbeitung der technischen Informationen von Zusatzfeldern in der Zusatzfeld-Verwaltung von Shopware 6 dringend ab.
Eigene Zusatzfelder
Lege eigene Zusatzfelder immer in einem eigenen Zusatzfeld-Set an, nicht in den Sets von ThemeWare®. Shopware gleicht die Zusatzfeld-Sets von ThemeWare® bei jedem Update mit der Auslieferung ab und entfernt dabei alle Felder, die nicht dazugehören. Das gilt in der Pro-Edition ab Version 5.5.0, in der Cloud-Edition schon bisher.
Was beim Update passiert
Ab Version 5.5.0 gilt beim Update:
| Fall | Ergebnis |
|---|---|
| Eigenes Feld in einem Set von ThemeWare® | Das Update verschiebt es in ein eigenes Set, z.B. "Eigene Felder Produkte". Name und Werte bleiben, du musst nichts tun |
Der technische Name beginnt wie die Felder von ThemeWare® (twt_…_custom_field__) |
Das Feld ist kein offizielles Feld von ThemeWare® und wird entfernt, die Werte bleiben erhalten |
| Das Verschieben schlägt fehl | Das Feld wird entfernt, die Werte bleiben erhalten. In den Ereignis-Logs (Einstellungen => System => Ereignis-Logs) steht ein Eintrag von ThemeWare® |
| Cloud-Edition | Das Feld wird entfernt, die Werte bleiben erhalten |
Hinweis: Entfernt Shopware nur die Felddefinition, bleiben die gespeicherten Werte an Produkten und Kategorien erhalten. Sie sind wieder sichtbar, sobald das Feld mit demselben technischen Namen und Typ wieder existiert.
Entferntes Feld wiederherstellen
- Ermittle den technischen Namen und den Typ des Felds, z.B. aus einer Sicherung, einem Export oder deinen Templates
- Lege ein eigenes Zusatzfeld-Set an (Einstellungen => System => Zusatzfelder) und darin das Feld mit demselben technischen Namen und demselben Typ
- Die gespeicherten Werte sind danach wieder sichtbar
Gib eigenen Feldern einen eigenen technischen Namen, der nicht wie die Felder von ThemeWare® mit twt_…_custom_field__ beginnt.