Zusatzfelder

Die Zusatzfelder bieten Dir die Möglichkeit, eigene Felder für die unterschiedlichen Programmbereiche hinzuzufügen, um hier dann eigene Informationen zu speichern. So kannst Du zum Beispiel für Produkte oder Kategorien eigene Zusatzinformationen angeben, die im Standard noch nicht vorhanden sind und diese dann auch z.B. im Rule Builder nutzen oder in die Storefront anzeigen lassen.
Das Modul zur Verwaltung findest Du unter Einstellungen > System > Zusatzfelder

CustomFields sollten grundsätzlich in der Standardsprache des Shops bearbeitet werden (im Admin auf Standardsprache wechseln). So ist sichergestellt, dass die Vererbung der Werte für alle Sprachen gilt. Das ist wichtig, wenn man Regeln oder anderes mit diesem Wert anlegen will. Wenn man für eine Sprache einen anderen Wert haben möchte, so sollte man im Admin auf diese Sprache wechseln und dort den Wert im CustomField eintragen. Somit wird der Wert nur für diese Sprache überschrieben. Anderenfalls ist nicht sichergestellt, dass in allen Sprachen ein Wert vorhanden ist, da die Vererbung nicht greift. Somit können Regeln in diesen Sprachen nicht greifen und der Kunde kann beispielsweise ein Produkt mit einer Shipping Method kaufen, die für dieses Produkt nicht geeignet ist.

Set anlegen

Die Zusatzfelder werden in Sets sortiert. Das bedeutet jedes Set kann mehrere Zusatzfelder beinhalten. Du kannst beispielsweise thematisch ähnliche Zusatzfelder in einem Set zusammen fassen. Diese Sets wiederum können dann einem oder mehreren Programmbereichen wie Produkten oder Kategorien zugewiesen werden. Anschließend hast Du innerhalb dieser Programmbereiche dann die Möglichkeit, die Zusatzfelder mit Informationen zu füllen.
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

Bitte achte darauf, dass die Zusatzfelder keine TWIG Sonderzeichen wie bspw. - oder # beinhalten. Dies kann sonst in Produktexporten für Fehlermeldungen sorgen.

Die Position legt die Reihenfolge fest, mit der Zusatzfelder in der Administration angezeigt werden. Je höher der eingetragene numerische Wert ist, um so weiter hinten wird das Zusatzfeld in der Administration angezeigt.
Zusätzlich kannst Du ein Label vergeben, welches für die Anzeige in der Administration verwendet wird. Das Label kann optional auch in allen Administrationssprachen gepflegt werden.

Außerdem ist es erforderlich, anzugeben, für welche Programmbereiche das Set verfügbar sein soll.

Wenn kein Bereich ausgewählt wurde, wird das Set zwar angelegt, ist aber in keinem Bereich verfügbar.

Zusatzfeld anlegen

Wenn Du das Set angelegt hast oder auch bei bereits bestehenden Sets werden im unteren Bereich alle Zusatzfelder dieses Sets angezeigt. 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 sein können.
Der technische Name ist aber in jedem Fall ein Pflichtfeld. Je nach Zusatzfeldtyp (z.B. Auswahl) sollten aber weitere Felder ausgefüllt werden, da der Benutzer sonst keine sinnvollen Daten auswählen kann.
Wenn Du ein Zusatzfeld erstellst, wird dieses automatisch als Textbaustein in allen Textbausteinen-Sets angelegt. Du musst somit keinerlei Anpassungen in der Datenbank vornehmen.

Mit der Option “Modifizierbar über Store API” wird das Zusatzfeld auf ‘öffentlich’ gestellt. Das bedeutet, dass jeder über die Shop-API auf die gespeicherten Informationen zugreifen kann. Wenn kritische Informationen, wie z. B. Kundeninformationen, in das Feld eingegeben werden, sollten sie nicht für die Shop-API verfügbar gemacht werden.

Bitte achte darauf, dass die Zusatzfelder keine TWIG Sonderzeichen wie bspw. - oder # beinhalten. Dies kann sonst in Produktexporten für Fehlermeldungen sorgen.

Auswahl

Ein Auswahl-Zusatzfeld bietet Dir die Möglichkeit, verschiedene Optionen zu definieren, aus denen dann bei der späteren Verwendung des Zusatzfelds eine oder mehrere Optionen gewählt werden können. Bei einem Kategorie Zusatzfeld könntest Du zum Beispiel mehrere Stichpunkte angeben, aus denen dann später in der Kategoriekonfiguration eines oder mehrere ausgewählt und somit zugewiesen 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.
Modifizierbar über Store API: Wenn diese Option aktiviert ist, kann die Store-API dieses Feld ändern. Dies kann verwendet werden, um benutzerdefinierte Daten zu speichern, wenn neue Felder zur Storefront hinzugefügt werden. Zum Beispiel für neue Felder im Registrierungsformular.
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.
- 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.