Zusatzfelder

Die Zusatzfelder ersetzen die aus Shopware 5 bekannten Freitextfelder und bieten Dir die Möglichkeit, eigene Felder für die unterschiedlichen Programmbereiche hinzuzufügen, um diese dann z.B. in den Produkten zu verwenden.
Das Modul zur Verwaltung findest Du unter Einstellungen > System > Zusatzfelder
 

Set anlegen

Die Zusatzfelder werden nicht mehr wie aus Shopware 5 bekannt direkt für einen Programmbereich wie z.B. Produkten oder Kunden erstellt, sondern in Sets sortiert. Die Sets wiederum können dann einem oder mehreren Programmbereichen zugewiesen werden.
Um ein Set zu erstellen klicke auf den Button Set anlegen, es öffnet sich das folgende Fenster
 

Für die Erstellung eines neuen Sets ist ein eindeutiger technischer Name erforderlich.

Bitte beachte, dass der technische Name nachträglich nicht geändert werden kann

Zusätzlich kannst Du ein Label vergeben, welches u.A. für die Anzeige in der Administration verwendet wird. Das Label kann optional auch in allen Administrationssprachen gepflegt werden.

Außerdem ist es erforderlich, das Set für die einzelnen Programmbereiche verfügbar zu schalten.

Wenn kein Bereich ausgewählt wurde bedeutet dies nicht, dass das Set für alle Bereiche verfügbar ist!

Zusatzfeld anlegen

Das Fenster zur Anlage eines Zusatzfeldes öffnest Du über den Button Neues Zusatzfeld. 
 

Die Ansicht des Modals variiert je nach ausgewähltem Typ, da unterschiedliche Angaben erforderlich sind.
Das einzige Pflichtfeld zur Anlage eines Zusatzfelds ist der technische Name. Beachte aber bitte, dass bei einigen Zusatzfeldtypen (z.B. Auswahl) weitere Felder ausgefüllt werden sollten, da der Benutzer sonst keine sinnvollen Daten auswählen kann.

Auswahl

Ein Auswahl-Zusatzfeld bietet Dir die Möglichkeit, direkt bei der Anlage verschiedene Optionen zu definieren, aus denen dann bei der späteren Verwendung des Zusatzfelds eine oder mehrere Optionen gewählt werden können.

Für die Anlage eines Auswahl-Zusatzfeldes stehen diese Konfigurationsmöglichkeiten zur Verfügung:

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.
• Platzhalter: Wird im Dropdown-Menü angezeigt, solange noch keine Auswahl getroffen wurde
• Hilfetext: Der Hilfetext kann per Mouseover über ein blaues Fragezeichen-Symbol eingeblendet werden.
• Mehrfachauswahl: Über den Schalter definierst Du, ob nur eine Option oder mehrere ausgewählt werden können.
• Option 1 (- n):
  • Technischer Name: Auch jede der Optionen für die Auswahl benötigt einen eindeutigen technischen Namen
  • Label: Für die bessere Darstellung kann ein Label vergeben werden, dass die Option beschreibt. Dieses Label wird dann auch in der Auswahlliste anstelle des technischen Namens angezeigt.
• Option hinzufügen: Über dieser Button kannst Du die Eingabefelder für eine weitere Option hinzufügen.

Beispielhafte Ansicht in der Administration

   

Textfeld

Für die Anlage eines Textfeldes stehen diese Konfigurationsmöglichkeiten zur Verfügung:

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.
• Platzhalter: Wird angezeigt, solange noch keine Eingabe erfolgt ist
• Hilfetext: Der Hilfetext kann per Mouseover über ein blaues Fragezeichen-Symbol eingeblendet werden.

Beispielhafte Ansicht in der Administration
 

 

Medium

Bietet die Möglichkeit eine Mediendatei hinzufügen, um diese z.B. mit einer Template-Anpassung im Frontend auf der Artikeldetailsseite anzuzeigen.

Für die Anlage eines Medium-Zusatzfeldes stehen diese Konfigurationsmöglichkeiten zur Verfügung:

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.

Beispielhafte Ansicht in der Administration

   

Zahl

Stellt ein Feld zur Eingabe von Zahlen bereit.

Für die Anlage eines Zahlen-Zusatzfeldes stehen diese Konfigurationsmöglichkeiten zur Verfügung::

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.
• Platzhalter: Wird angezeigt, solange noch keine Eingabe erfolgt ist
• Hilfetext: Der Hilfetext kann per Mouseover über ein blaues Fragezeichen-Symbol eingeblendet werden.
• Zahlentyp: Hier kannst Du wählen, ob es sich bei den möglichen Eingaben um eine Ganzzahl oder eine Gleitkommazahl handelt.
• Schritte: Definiert die Schritte, die zur Eingabe der Zahl möglich sind. Hierdurch kannst Du z.B. sicherstellen, dass eine gewisse Staffelung immer eingehalten wird.
• Minimum: Lege hier die kleinstmögliche Eingabe fest
• Maximum: Lege hier die größtmögliche Eingabe fest

Beispielhafte Ansicht in der Administration
 

 

Datum / Zeit

Stellt eine Auswahlmaske zur Auswahl eines Datums und Zeitpunkts bereit.

Für die Anlage einer Datum/Zeit-Auswahl stehen diese Konfigurationsmöglichkeiten zur Verfügung::

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.
• Hilfetext: Der Hilfetext kann per Mouseover über ein blaues Fragezeichen-Symbol eingeblendet werden.

Beispielhafte Ansicht in der Administration
 

 

Checkbox

Hierüber hast Du die einfache Möglichkeit, eine Checkbox einzubinden, die im Hintergrund ein Boolean-Datensatz ("0"/"1") bereitstellt.

Für die Anlage einer Checkbox stehen diese Konfigurationsmöglichkeiten zur Verfügung:

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.
• Hilfetext: Der Hilfetext kann per Mouseover über ein blaues Fragezeichen-Symbol eingeblendet werden.

Beispielhafte Ansicht in der Administration
 

 

Aktiv/Inaktiv Schalter

Bindet einen Schalter ein, der im Hintergrund ein Boolean-Datensatz ("0"/"1") bereitstellt.

Für die Anlage eines Aktiv/Inaktiv-Schalters stehen diese Konfigurationsmöglichkeiten zur Verfügung:

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.
• Hilfetext: Der Hilfetext kann per Mouseover über ein blaues Fragezeichen-Symbol eingeblendet werden.

Beispielhafte Ansicht in der Administration
 

 

Text Editor

Stellt einen Text Editor zur Verfügung, der es Dir einfach ermöglicht, gestylten Text einzugeben und diesen z.B. mittels Variable im Template einzubinden.

Für die Anlage eines Text Editors stehen diese Konfigurationsmöglichkeiten zur Verfügung:

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.
• Platzhalter: Wird angezeigt, solange noch keine Eingabe erfolgt ist

Beispielhafte Ansicht in der Administration
 

Farbauswahl

Ermöglicht die Auswahl einer Farbe per Auswahl aus einer Farbpalette oder Eingabe des HEX-Farbcodes.

Für die Anlage einer Farbauswahl stehen diese Konfigurationsmöglichkeiten zur Verfügung:

• Technischer Name (Pflichtangabe): Eindeutiger Name für das Zusatzfeld, dieser darf nur einmal im System verwendet werden und kann nachträglich nicht geändert werden.
• Position: Über die Position ist eine Sortierung der Zusatzfelder innerhalb des Sets möglich. Je niedriger der Wert ist, umso weiter oben wird das Zusatzfeld angezeigt
• Pflichtfeld: Definiere hierüber, ob eine Auswahl erforderlich ist.
• Label: Das Label wird verwendet, um einen für den Benutzer nachvollziehbaren Namen zu vergeben. Diese Bezeichnung wird z.B. in den Modulen der Administration angezeigt, wenn das Zusatzfeld dort eingebunden ist.

Beispielhafte Ansicht in der Administration
 

 

Zusatzfeld in der Storefront einbinden

Solltest Du den Inhalt eines Zusatzfeldes in der Storefront ausgeben wollen, ist eine Template-Anpassung erforderlich.
Wie dies im Detail möglich ist, erfährst Du im Artikel Änderungen am Template vornehmen