Wiki-Quellcode von Theme-Konfigurator-Plugin

Verstecke letzte Bearbeiter

version	line-number	content
30.2	1	[[Plugin-Download>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-theme-config&fileid=11565\|\|target="_blank"]] (erfordert Anmeldung)
	2
15.69	3	{{content/}}
1.1	4
16.2	5	{{figure image="plugin_theme_config_home_de.png" width="600"}}
14.4	6	Das Menü des Theme-Konfigurators, wie es erscheint, nachdem das Plugin zum ersten Mal installiert wurde. Standardmäßig gibt es bereits eine Vorlage für das mit {{formcycle/}} ausgelieferte //Modern-Theme//.
	7	{{/figure}}
	8
14.3	9	Das Theme-Konfigurator-Plugin ermöglicht es, verschiedene Layout-Einstellungen eines Formulars wie Schriftgrößen, Farben und Abstände über eine grafische Oberfläche zu bearbeiten.
1.1	10
14.3	11	Das Plugin sollte als System-Plugin installiert werden, kann prinzipiell aber auch als Mandant-Plugin installiert werden. Das Plugin an sich erfordert keine Einstellung oder Konfiguration. Nach der Installation gibt es links im Hauptmenü einen neuen Menüeintrag mit dem Namen //Theme-Konfigurator//.
	12
	13	Die Bedienung des Theme-Konfigurators gliedert sich in zwei Abschnitte, die sich jeweils an unterschiedliche Nutzergruppen richten:
	14
16.5	15	; Erstellen von Layout-Vorlagen
	16	: Dies richtet sich an technisch versierte Nutzer, die Vorlagen für Layouts erstellen möchten. In einer Vorlage wird etwa festgelegt, welche Eigenschaften (Farben, Schriftgrößen etc.) bearbeitbar sein sollen. Basierend auf einer Vorlage kann dann ein Layout erstellt werden, in dem jeder Eigenschaft entsprechende Werte zugewiesen werden (Farbe=rot, Schriftgröße=12px etc.). Hierzu sind grundlegende Kenntnisse über {{smallcaps}}Css{{/smallcaps}} und [[{{smallcaps}}Scss{{/smallcaps}}>>url:https://sass-lang.com/\|\|rel="noopener noreferrer" target="_blank"]] notwendig. Für Nutzer, die keine Vorlagen erstellen sollen oder dürfen, kann diese Möglichkeit über ein [[Rollenrecht>>doc:Formcycle.UserInterface.UserSettings.Roles]] entzogen werden.
	17
14.7	18	; Erstellen von konkreten Layouts
14.10	19	: Dies richtet sich an gestalterisch versierte Nutzer. Basierend auf einer Vorlage kann ein konkretes Layout erstellt werden. Es ist auch möglich, mehrere Layouts basierend auf einer Vorlage zu erstellen, etwa eine Variation in Rot und eine Variation in Blau. Nachdem ein Layout erstellt wurde, kann es entwender als [[Design (CSS)>>doc:Formcycle.UserInterface.FilesAndTemplates.Design]]-Vorlage für den {{designer/}} oder als {{smallcaps}}Css{{/smallcaps}}-[[Mandantdatei>>doc:Formcycle.UserInterface.FilesAndTemplates.Files]] abgespeichert werden.
14.3	20
14.4	21	Wird das Plugin installiert, wird automatisch eine erste Layout-Vorlage im System angelegt. Diese enthält das mit {{formcycle/}} ausgelieferte //Modern-Theme//.
	22
14.9	23	Technisch werden durch Layout-Vorlagen {{smallcaps}}Scss{{/smallcaps}}-Dateien mit Variablen definiert. Durch Layouts wird diesen Variablen jeweils ein Wert zugewiesen.
	24
15.69	25	== Allgemeine Hinweise ==
1.1	26
15.69	27	=== Rollenrechte ===
14.7	28
	29	Dieses Plugin fügt dem [[Rollenmenü>>doc:Formcycle.UserInterface.UserSettings.Roles]] einige neue Rollenrechte hinzu. Daher ist es möglich, dass je nach Einstellungen einigen Benutzern bestimmte Möglichkeiten des Theme-Konfigurators nicht zur Verfügung stehen. In dem Fall sollte der entsprechende zuständige Administrator kontaktiert werden.
	30
15.69	31	=== Vollbildmodus ===
14.4	32
14.7	33	Da der Theme-Konfigurator viele Möglichkeiten bietet, kann der in {{formcycle/}} vorhandene Platz auf kleineren Bildschirmen nicht ausreichen. Hierfür gibt es einen Vollbildmodus, der durch Klick auf das Erweitern-Symbol ({{icon name="compress"/}}) rechts oben aktiviert und deaktiviert werden kann.
14.4	34
14.28	35	=== Export ===
	36
15.69	37	Links in der Liste mit den Layout-Vorlagen und darauf basierenden Layouts gibt es ein Herunterladen-Symbol ({{icon name="download"/}}), welches erscheint, wenn mit der Maus über eine Layout-Vorlage oder ein Layout gefahren wird.
14.28	38
	39	Durch Klick auf dieses Symbol kann die entsprechende Layout-Vorlage oder das Layout heruntergeladen werden. Falls eine Layout-Vorlage heruntergeladen wird, können zusätzlich auch einige oder alle Layouts mit heruntergeladen werden, dabei wird ein {{smallcaps}}Zip{{/smallcaps}}-Archiv erstellt.
	40
14.30	41	Weiterhin ist es über den Hochladen-Knopf ({{icon name="upload"/}}) in der Leiste oben links auch möglich, heruntergeladene Layout-Vorlagen und Layouts wieder zu importieren.
14.28	42
	43	Falls dabei Layout-Vorlagen oder Layouts überschrieben werden würden, erscheint ein Dialog mit einem entsprechenden Hinweis und möglichen Optionen.
	44
15.69	45	=== Dateiablage ===
14.7	46
14.10	47	{{figure image="plugin_theme_config_client_files_de.png"}}
	48	In den Mandantdateien werden die Konfigurationsdateien gespeichert, die von diesem Plugin benötigt werden. Dabei handelt es sich um automatisch generierte Dateien, die nicht manuell bearbeitet oder editiert werden sollten.
	49	{{/figure}}
	50
14.8	51	Die erstellten Layout-Vorlagen und Layouts werden als [[Mandantdatei>>doc:Formcycle.UserInterface.FilesAndTemplates.Files]] gespeichert. Diese automatisch erstellten Dateien sollten nicht manuell editiert oder gelöscht werden. Es ist aber etwa möglich, durch Export der entsprechenden Mandantdateien ein Backup zu erstellen und später wieder einzuspielen.
14.7	52
14.8	53	Die von diesem Plugin erzeugten Dateien haben verschiedene Dateiendungen:
	54
	55	; .scss
14.9	56	: Steht für //Sassy CSS//. Hierbei handelt es sich um die {{smallcaps}}Scss{{/smallcaps}}-Datei, welche die Implementierung einer Layout-Vorlage enthält.
14.8	57	; .thed
14.9	58	: Steht für //theme editor (configuration)//. Eine Konfigurationsdatei im {{smallcaps}}Json{{/smallcaps}}-Format, welche die bearbeitbaren Eigenschaften (Variables) der {{smallcaps}}Scss{{/smallcaps}}-Datei sowie die zu verwendeten Editoren enthält.
14.8	59	; .thpc
14.9	60	: Steht für //theme processing (configuration)//. Eine Konfigurationsdatei im {{smallcaps}}Json{{/smallcaps}}-Format, welche die konkret festgelegten Werte eines Layout für die einzelnen bearbeitbaren Eigenschaften der Layout-Vorlage enthält.
14.8	61	; .css
14.9	62	: Steht für //cascading style sheet//. Eine {{smallcaps}}Css{{/smallcaps}}-Datei, die aus einem Layout generiert wurde.
14.8	63
15.69	64	=== Behebung fehlender oder falscher Referenzen ===
1.1	65
14.10	66	{{figure image="plugin_theme_config_error_resolution_de"}}
14.11	67	Falls eine Konfigurationsdatei ungültige Werte enthält, erscheint ein entsprechender Dialog zur Fehlerbehebung. Im hier abgebildeten Fall wurde ein Layout ausgewählt, wobei es die zu der Layout-Vorlage gehörende {{smallcaps}}Scss{{/smallcaps}}-Datei nicht mehr gibt. Es kann nun entweder eine neue {{smallcaps}}Scss{{/smallcaps}}-Datei angelegt werden oder das Layout gelöscht werden. Alternativ kann die Fehlerbehebung auch abgebrochen werden. In dem Fall erscheint der Dialog erneut, wenn das Layout ausgewählt wird.
14.10	68	{{/figure}}
	69
15.69	70	In den Konfigurationsdateien der Layout-Vorlagen und Layouts werden Referenzen auf andere Dateien gespeichert. Etwa wird in der Layout-Datei eine (weiche) Referenz auf die Layout-Vorlage gespeichert. Falls in den Mandantdateien eine referenzierte Datei gelöscht wird, erscheint im Theme-Konfigurator ein enstprechender Dialog mit einem Hinweis darauf. Hier kann die falsche oder fehlende Referenz behoben werden, zum Beispiel indem eine neue Layout-Vorlage erstellt wird oder eine andere Vorlage genutzt wird.
14.10	71
15.69	72	== Erstellen eines konkreten Layouts ==
1.1	73
14.17	74	{{figure image="plugin_theme_config_layout_settings_de.png"}}
14.23	75	Wurde in der Liste links durch Klick ein Layout ausgewählt, kann dieses bearbeitet werden. Rechts werden alle Eigenschaften angezeigt, welche die Layout-Vorlage erlaubt, zu bearbeiten. Im Bereich in der Mitte wird ein Vorschauformular mit dem aktuellen Layout angezeigt.
14.17	76	{{/figure}}
	77
15.69	78	=== Allgemeine Aktionen ===
14.22	79
14.18	80	{{figure image="plugin_theme_config_new_layout_de.png"}}
14.23	81	Mittels der entsprechenden Schaltfläche in der Liste links kann ein neues Layout basierend auf einer Layout-Vorlage erstellt werden.
14.18	82	{{/figure}}
14.17	83
15.62	84	{{figure image="plugin_theme_config_default_modern_theme_de.png"}}
	85	Es ist möglich, ein Layout als Standard-Modern-Theme zu markieren. Es überschreibt dann das Modern-Theme, welches standardmäßig durch {{formcycle/}} ausgeliefert wird. Ob ein Formular das Modern-Theme benutzt, kann über die entsprechende Checkbox im {{designer/}} festgelegt werden (rechts in den Eigenschaften im Tab //Formular//).
	86	{{/figure}}
	87
16.3	88	Um ein neues Layout basierend auf einer Layout-Vorlage anzulegen, kann auf die Schaltfläche //Neues Theme// mit dem Plussymbol ({{icon name="plus"/}}) links in der Liste der Layout-Vorlagen geklickt werden. Es öffnet sich ein Dialog, in dem der Name des neuen Layouts eingegeben werden kann.
14.18	89
14.19	90	Nachdem ein neues Layout erstellt wurde, ist es links in der Liste unter der entsprechenden Vorlage zu sehen. Durch Klick auf das Layout wird es geöffnet und kann bearbeitet werden.
14.18	91
15.69	92	An jedem Layout gibt es in der Liste links beim Überfahren mit der Maus ein Aktivieren-Symbol ({{icon name="power-off"/}}). Wird auf dieses geklickt, kann das Layout als Standard-Modern-Theme markiert werden. Ist ein Layout als Standard-Modern-Theme markiert, wird das Layout für alle Formular angewendet, bei denen im {{designer/}} die Option //Modern Theme// aktiviert ist. Die Option //Modern Theme// findet sich im Formular-Tab rechts im {{designer/}}. Es ist zu beachten, dass immer nur ein Layout als Standard-Modern-Theme markiert werden kann. Hinweis: Technisch wird dabei eine Mandantdatei mit Namen //031-extended.css// angelegt, wodurch das durch {{formcycle/}} standardmäßig ausgelieferte Modern-Theme überschrieben wird.
14.26	93
14.22	94	In der Aktionsleiste ganz unten gibt es drei Aktionsmöglichkeiten:
14.21	95
14.22	96	; Vorschau aktualisieren
14.23	97	: Aktualisiert das Vorschauformular in der Mitte, sodass es den aktuellen Stand widerspiegelt. In der Regel wird die Vorschau automatisch aktualisiert, sobald rechts eine Eigenschaft geändert wird. Sollte dies einmal nicht der Fall sein, kann diese Schaltfläche genutzt werden.
14.22	98	; CSS herunterladen
14.23	99	: Falls notwendig, kann hier das {{smallcaps}}Css{{/smallcaps}} heruntergeladen werden, welches aus dem aktuellen Layout mit den aktuellen Einstellungen erzeugt wurde.
14.22	100	; Speichern
15.69	101	: Speichert die aktuelle Konfiguration des Layouts. Falls in der Konfiguration des Layouts eingestellt wurde, dass es als Mandantdatei oder Designer-Vorlage abgespeichert werden soll, werden diese Dateien jetzt ebenfalls erzeugt beziehungsweise aktualisiert.
14.22	102
15.69	103	=== Vorschaubereich ===
14.18	104
14.19	105	{{figure image="plugin_theme_config_preview_settings_de.png"}}
14.25	106	Der Vorschaubereich, der zeigt, wie das aktuelle Layout an einem Formular aussehen würde. Standardmäßig wird hier ein Demoformular angezeigt, es kann aber auch ein vorhandenes Formular ausgewählt werden.
14.19	107	{{/figure}}
	108
14.21	109	Im Bereich in der Mitte findet sich die Formularvorschau. Hier wird ein Formular angezeigt, wie es mit dem ausgewählten Layout aussehen würde. Standardmäßig wird hier ein generisches Testformular angezeigt. Bei Bedarf kann durch Klick auf das blaue Zahnradsymbol rechts oben ({{icon name="gear"/}}) auch ein bestehendes Formular für die Vorschau ausgewählt werden. Als fortgeschrittene Option ist es hier auch möglich, zusätzliche URL-Parameter an den Formularlink anzufügen, der im Vorschaubereich angezeigt wird.
14.19	110
15.69	111	=== Editierbereich ===
14.21	112
15.59	113	{{figure image="plugin_theme_config_css_design_files_de.png"}}
	114	Es ist auch möglich, ein Layout statt als Mandantdatei unter [[Design (CSS)>>doc:Formcycle.UserInterface.FilesAndTemplates.Design]] abzuspeichern. Es kann dann im {{designer/}} als Theme für ein Formular verwendet werden.
	115	{{/figure}}
	116
14.25	117	Im Editierbereich rechts kann das Layout bearbeitet werden. Der Editierbereich gliedert sich in zwei Abschnitte.
14.18	118
14.25	119	Im ersten Abschnitt werden einige allgemeine Einstellungen zum Layout vorgenommen:
	120
	121	; Unter Design (CSS) abspeichern
	122	: Ist diese Option aktiviert, wird das Layout als Vorlage für den {{designer/}} im Menü [[Design (CSS)>>doc:Formcycle.UserInterface.FilesAndTemplates.Design]] abgespeichert.
	123	; Unter Dateien (Mandant) abspeichern
14.26	124	: Ist diese Option aktiviert, wird das Layout als {{smallcaps}}Css{{/smallcaps}}-Datei in den [[Mandantdateien>>doc:Formcycle.UserInterface.FilesAndTemplates.Files]] abgespeichert.
14.25	125
14.27	126	Weiterhin erschient hier ein Hinweistext, falls das Layout als Standard-Modern-Theme für Formulare verwendet wird (siehe oben).
14.26	127
14.28	128	Die folgenden Abschnitte erlauben die Konfiguration des Layouts selber, so wie es durch die Layout-Vorlage vorgegeben wird. Hier können etwa Schriftgrößen, Farben und Abstände bearbeitet werden.
14.25	129
15.69	130	== Erstellen einer Layout-Vorlage ==
1.1	131
16.4	132	Eine Layout-Vorlage besteht aus zwei Teilen. Zum einen muss eine {{smallcaps}}Scss{{/smallcaps}}-Datei erstellt werden, in der die entsprechenden Layout-Regeln enthalten sind. {{smallcaps}}Scss{{/smallcaps}} kann Variablen enthalten, deren Werte später durch den Nutzer festgelegt werden, wenn dieser ein neues Layout erstellt. Zum anderen muss festgelegt werden, welche Variablen editierbar sein sollen und mit welchem Editoren die einzelnen Variablen bearbeitet werden sollen (etwa Texteditor, Pixel-Editor, Farbenwähler, Dateiwähler etc.). Optional können auch noch einige Einstellungen zur Transpilation des {{smallcaps}}Scss{{/smallcaps}} in {{smallcaps}}Css{{/smallcaps}} vorgenommen werden.
14.33	133
	134	{{figure image="plugin_theme_config_new_template_de.png"}}
15.57	135	Durch Klick auf das Plussymbol in der Aktionsleiste link oben kann eine neue Layout-Vorlage erstellt werden. Es muss ein Name vergeben werden, der in der Regel der gleiche Name wie der Name der {{smallcaps}}Scss{{/smallcaps}}-Datei sein sollte.
14.33	136	{{/figure}}
	137
15.57	138	Um eine neue Layout-Vorlage zu erstellen, kann auf das Plussymbol ({{icon name="plus"/}}) links oben gedrückt werden. Hier muss der Name der Layout-Vorlage und der Name der {{smallcaps}}Scss{{/smallcaps}}-Datei festgelegt werden. In der Regel sollte die {{smallcaps}}Scss{{/smallcaps}}-Datei den gleichen Namen wie die Layout-Vorlage erhalten.
14.33	139
14.34	140	Nach Auswahl einer Layout-Vorlage durch Klick auf diese in der linken Liste kann die Layout-Vorlage bearbeitet werden.
	141
15.69	142	=== SCSS-Vorlage ===
14.33	143
15.58	144	{{figure image="plugin_theme_config_template_scss_de.png"}}
15.10	145	Im {{smallcaps}}Scss{{/smallcaps}}-Tab kann der Inhalt der zu verwendenden {{smallcaps}}Scss{{/smallcaps}}-Datei bearbeitet werden. Die Nutzung von {{smallcaps}}Scss{{/smallcaps}}-Variablen ist möglich, deren Werte können dann pro Layout geändert werden. Variablen können durch Nutzung von //!default// mit Standardwerten vorbelegt werden.
15.9	146	{{/figure}}
	147
15.10	148	Im {{smallcaps}}Scss{{/smallcaps}}-Tab im rechten Bereich kann eine entsprechende {{smallcaps}}Scss{{/smallcaps}}-Datei erstellt werden.
	149
15.69	150	Es können dabei sogenannte [[{{smallcaps}}Scss{{/smallcaps}}-Variablen>>url:https://sass-lang.com/documentation/variables\|\|rel="noopener noreferrer" target="_blank"]] verwendet werden. Der Wert der Variablen wird dann pro Layout entsprechend durch den Nutzer festgelegt. {{smallcaps}}Scss{{/smallcaps}}-Variablen beginnen immer mit einem Dollarzeichen ($) und sollten nicht mit [[{{smallcaps}}Css{{/smallcaps}}-Variablen>>url:https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties\|\|rel="noopener noreferrer" target="_blank"]] verwechselt werden.
15.10	151
15.69	152	Um die {{smallcaps}}Scss{{/smallcaps}}-Variablen für ein Layout mit Werten zu befüllen, werden die Variablen mit ihren Werten der{{smallcaps}}Scss{{/smallcaps}}-Datei vorangestellt:
15.11	153
	154	{{code language="scss"}}
15.13	155	// Generated automatically by the system
15.11	156	$color: red;
	157	$fontSize: 16px;
	158	$fontFamily: "Liberation Sans";
15.13	159
	160	// Your SCSS rules and styles come here
	161	// ...
15.11	162	{{/code}}
	163
15.19	164	Es empfiehlt sich, in der {{smallcaps}}Scss{{/smallcaps}}-Datei für jede Variable einen Default-Wert zu deklarieren. Wenn dies am Anfang der Date geschieht, dann ist beim Lesen der {{smallcaps}}Scss{{/smallcaps}}-Datei auch schnell erkennbar, welche Variablen es gibt. In dem Fall sollten die Variablen mit der //default//-Regel versehen werden, damit nicht die Werte aus dem Layout überschrieben werden:
15.11	165
15.13	166	{{code language="scss"}}
	167	// Declare your variables at the beginning of the SCSS file
	168	// Not required, but good practice
	169	$color: red !default;
	170	$fontSize: 16px !default;
	171	$fontFamily: "Liberation Sans" !default;
	172
	173	// Rules and styles come here
	174	body {
	175	color: $color;
	176	font-size: $fontSize;
	177	font-family: $fontFamily;
	178	}
	179
	180	// ...
	181	{{/code}}
	182
15.14	183	Schließlich ist es auch möglich, andere {{smallcaps}}Scss{{/smallcaps}}-Dateien zu importieren:
15.13	184
15.14	185	{{code language="scss"}}
15.17	186	// You can import an SCSS file from the files of the current client
	187	@import "client/current/file.scss";
15.16	188
15.17	189	// You can also import a file from another client
	190	// Select a client by its name, alias, ID, or UUID
	191	@import "client/name/demo/file.scss";
	192	@import "client/alias/demo/file.scss";
	193	@import "client/id/152/file.scss";
	194	@import "client/uuid/c33c63c7-8047-4727-bcda-8d07e2c36d4d/file.scss";
15.16	195
15.17	196	// You can also import a CSS file
	197	@import "client/current/file.css";
15.16	198
15.17	199	// You can also import another layout template
	200	// It is transpiled with the default variable settings before being imported
	201	@import "client/current/file.thed";
15.16	202
15.17	203	// You can also import another layout
	204	// It is transpiled with the variable settings before being imported
15.25	205	@import "client/current/file.thpc";
	206
	207	// Import a file only when transpiling for a preview
	208	// A SCSS file is transpiled (a) when the user clicks the save
	209	// button, which also saves the result a client file or design template.
	210	// And (b), when the user has changed an option in the UI and we want to
	211	// to update the preview in the center section of the UI.
	212	@import "client/current/file.scss?previewOnly";
15.14	213	{{/code}}
	214
15.69	215	=== Editorkonfiguration ===
14.33	216
15.41	217	{{figure image="plugin_theme_config_editor_config_de.png"}}
	218	Im ersten Tab auf der rechten Seite kann festgelegt werden, mit welchen Editoren welche {{smallcaps}}Scss{{/smallcaps}}-Variablen bearbeitet werden sollen. Zudem wird hier auch die Reihenfolge der Editoren festgelegt.
	219	{{/figure}}
	220
15.46	221	Im ersten Tab auf der rechten Seite wird festgelegt, welche {{smallcaps}}Css{{/smallcaps}}-Variablen letzlich durch den Nutzer bearbeitet werden können, wenn dieser Layout erstellt, das auf der Vorlage beruht. Für jede Variable wird festgelegt,
	222
	223	* mit welchem Editor die Variable bearbeitet werden kann (wie etwa Texteditor, Dateieditor, Pixeleditor); und
	224	* an welcher Stelle der Oberfläche der Editor später erscheinen wird.
	225
15.69	226	Die Konfiguration funktioniert ähnlich zum {{designer/}}:
15.46	227
16.6	228	* Standardmäßig werden alle Editoren untereinander angeordnet. Über die entsprechende Einstellung (siehe unten um Abschnitt //Einstellungen zur Ansicht//) ist es möglich, Editoren auch nebeneinander anzuordnen. Diese Option sollte mit Bedacht genutz werden, um den Nutzer nicht mit zu vielen Information auf einmal zu überlasten.
15.46	229	* Alle Editoren werden in Fieldsets gruppiert. Dies sorgt für eine klarere Gliederung und erhöht die Lesbarkeit.
	230
	231	Editoren werden wie folgt hinzugefügt:
	232
	233	* Wurde eine neue Layout-Vorlage angelegt, gibt es zunächst nur einen Knopf: //Neue Gruppe//. Hiermit wird eine neue Gruppe (Fieldset) angelegt.
	234	* In dieser Gruppe gibt es nur erneut einen Knopf: //Neuer Editor//. Dieser fügt einen neuen Texteditor mit Standardeinstellungen zur Gruppe hinzu.
15.69	235	* Um noch eine neue Gruppe anzulegen, kann auf den {{icon name="plus"/}}-Knopf gedrückt werden. Dieser erscheint, sobald man mit der Maus über den Freiraum zwischen zwei Gruppen fährt (beziehungsweise über den Freiraum überhalb der ersten und unterhalb der letzten Gruppe).
15.47	236	* Um noch einen neuen Editor in einer Gruppe anzulegen, kann auf den Plus-Knopf ({{icon name="plus"/}}) gedrückt werden. Dieser erscheint, sobald man mit der Maus über den Freiraum zwischen zwei Editoren fährt (beziehungsweies über den Freiraum überhalb des ersten und unterhalb des letzten Editors).
15.46	237
	238	An jedem Editor sind nun folgende Einstellungen möglich:
	239
	240	; Variablenname und Anzeigename festlegen
	241	: Für jeden Editor muss festgelegt werden, welche Variable er bearbeitet und welcher Beschreibungstext beim Erstellen eines neuen Layouts angelegt wird. Dazu wird auf den blauen Beschreibungstext oben am Editor geklickt. Es öffnet sich ein Eingabefeld. Hier wird der Variablenname und der Anzeigename eingetragen, getrennt mit einm Doppelpunkt: {{code language="none"}}<variable-name>:<Display Name>{{/code}}. Hinweis: Es kann hier zu keinen Verwechslungen kommen, da {{smallcaps}}Scss{{/smallcaps}}-Variablen keinen Doppelpunkt enthalten dürfen. Der Anzeigename darf Doppelpunkte erhalten, der Variablenname wird durch den ersten Doppeltpunkt abgetrennt.
15.53	242	; Typ des Editors ändern
15.69	243	: Beim Überfahren des Editors mit der Maus erscheint rechts oben eine Leiste, wo der Type des Editor geändert werden kann. Zur Auswahl stehen hier verschiedene Editoren, wie einfach Texteditoren, Farbwähler, Pixeleditoren oder Dateiwähler. Einige Editoren haben zusätzliche Einstellungen. In diesem Fall erscheint rechts neben dem Editortyp in der Leiste ein Zahnradsymbol ({{icon name="gear"/}}). Ein Klick auf dieses Symbol öffnet einen Dialog mit den entsprechenden Einstellungen. Beispielsweise hat der //DecimalRangeEditor// zusätzliche Einstellungen für den Mindestwert, Maximalwert und die Schrittweite.
15.46	244	; Standardwert festlegen
	245	: Um den Standardwert für die Variable festzulegen, kann der Wert direkt über den Editor eingegeben werden.
15.47	246	; Hilfetext hinzufügen oder ändern
15.57	247	: Optional kann an jedem Editor ein Hilfetext angezeigt werden. Um einen Hilfetext hinzuzufügen oder den bestehenden Hilfetext zu ändern, kann links neben dem Editor auf das blaue Fragezeichensymbol ({{icon name="question-circle"/}}) gedrückt werden. Es öffnet sich ein Textfeld, wo der Text bearbeitet werden kann.
15.53	248	; Breite des Editor ändern
	249	: Falls die Einstellung aktiviert wurde, mehrere Editorem nebeneinander anzuordnen: Beim Überfahren des Editors mit der Maus erscheint rechts oben eine Leiste, wo die relative Breite des Editor geändert werden kann. Diese Breite ist relativ zu den Breite der anderen Editoren in der gleichen Zeile.
15.56	250	; Editor an eine andere Stelle schieben
15.69	251	: Jeder Editor kann per Drag&Drop an eine andere Stelle geschoben werden. Der Editor kann an jeder Stelle und auch an dem Anfassen-Symbol ({{icon name="arrows"/}}) angefasst werden.
15.56	252	; Editor löschen
15.69	253	: Beim Überfahren des Editors mit der Maus erscheint rechts oben eine Leiste mit einem Papierkorbsymbol ({{icon name="trash"/}}). Ein Klick auf dieses Symbol löscht den Editor.
15.46	254
15.69	255	=== Einstellungen ===
14.33	256
15.37	257	{{figure image="plugin_theme_config_template_settings_1_de.png"}}
	258	In den Einstellungen kann festgelegt werden, wie genau das {{smallcaps}}Scss{{/smallcaps}} in {{smallcaps}}Css{{/smallcaps}} umgewandelt wird und welche {{smallcaps}}Css{{/smallcaps}}-Dateien in der Vorschau deaktiviert werden sollen.
	259	{{/figure}}
	260
	261	{{figure image="plugin_theme_config_template_settings_2_de.png"}}
15.68	262	In den Einstellungen kann zudem weiter festgelegt werden, ob etwa [[Vendor-Präfix>>url:https://developer.mozilla.org/en-US/docs/Glossary/Vendor_Prefix\|\|target="_blank"]] automatisch angefügt werden sollen oder diverse {{smallcaps}}Css{{/smallcaps}}-Features automatisch für ältere Browser kompatibel gemacht werden.
15.37	263	{{/figure}}
	264
15.29	265	Im Tab //Einstellungen// im rechten Bereich können einige fortgeschrittene Einstellungen getroffen werden, welche unter anderem beeinflussen, wie genau das {{smallcaps}}Scss{{/smallcaps}} in {{smallcaps}}Css{{/smallcaps}} transpiliert wird. Die Einstellungen gliedern sich in vier Unterbereiche:
15.25	266
15.29	267	==== Einstellungen zur Ansicht ====
15.25	268
15.32	269	Hier können einige grundlegende Einstellungen zur Vorschau und zum Layout der Variableneditoren vorgenommen werden.
	270
15.29	271	; Mehrere Editoren pro Zeile erlauben
15.30	272	: Standardmäßig werden die Editoren für die einzelnen Variablen untereinander angezeigt. Wenn diese Option aktiviert ist, können Editoren auch nebeneinander angeordnet werden. Diese Funktionalität sollte mit Bedacht eingesetzt werden, da recht wenig Platz in der Breite zur Verfügung steht und der Nutzer so schnell verwirrt werden kann.
15.29	273	; Basis-Theme in Vorschau deaktivieren
15.69	274	: Ist diese Option aktiviert, wird das durch {{formcycle/}} ausgeliefert Basis-{{smallcaps}}Css{{/smallcaps}} in der Vorschau deaktiviert. Ob diese Option aktiviert werden sollte, hängt davon ab, ob das {{smallcaps}}Scss{{/smallcaps}} auf dem Basis-{{smallcaps}}Css{{/smallcaps}} aufbaut oder eigenständig ist.
15.29	275	; Modern-Theme in Vorschau deaktivieren
15.69	276	: Ist diese Option aktiviert, wird das durch {{formcycle/}} ausgeliefert Modern-Theme-{{smallcaps}}Css{{/smallcaps}} in der Vorschau deaktiviert. Ob diese Option aktiviert werden sollte, hängt davon ab, ob das {{smallcaps}}Scss{{/smallcaps}} auf dem Modern-Theme aufbaut oder nur das Basis-{{smallcaps}}Css{{/smallcaps}} benötigt.
15.29	277	; Formular-Theme in Vorschau deaktivieren
16.7	278	: Ist diese Option aktiviert, wird {{smallcaps}}Css{{/smallcaps}} des Themes deaktiviert, welches im {{designer/}} für das Formular eingestellt wurde.
15.29	279
	280	==== Einstellungen zur CSS-Ausgabe ====
	281
15.36	282	{{figure image="plugin_theme_config_template_browserlist_de.png"}}
15.37	283	Über eine Browser-Query kann festgelegt werden, welche Ziel-Browser unterstützt werden sollen. Über die entsprechende Schaltfläche neben der Browser-Query kann die Liste der auf die Browser-Query zutreffenden Browser angezeigt werden.
15.36	284	{{/figure}}
	285
15.37	286	In diesem Bereich können grundlegende Einstellungen für die {{smallcaps}}Css{{/smallcaps}}-Generierung vorgenommen werden, wie etwa ob das {{smallcaps}}Css{{/smallcaps}} minifiziert ausgegeben werden soll.
	287
15.33	288	; {{smallcaps}}Css{{/smallcaps}}-Ausgabemodus
15.32	289	: Ob das erzeugte {{smallcaps}}Css{{/smallcaps}} komprimiert werden soll oder für Menschen lesbarer ausgegeben wird.
15.33	290	:; COMPACT
15.35	291	:: Jeder Selektor mit all seinen Regeln wird in jeweils einer einzigen Zeile ausgegeben.
15.33	292	:; COMPRESSED
15.35	293	:: Es wird versucht, die Größe des {{smallcaps}}Css{{/smallcaps}} so gering wie möglich zu halten, etwa indem unnötige Leerzeichen und Zeilenumbrüche entfernt werden. In der Regel wird die {{smallcaps}}Css{{/smallcaps}}-Datei dadurch nur eine Zeile enthalten.
15.33	294	:; EXPANDED
15.34	295	:: Alle verschaltelten Selektoren im {{smallcaps}}Scss{{/smallcaps}} werden aufgelöst und ohne Einrückung ausgegeben. Jeder Selektor wird auf einer separaten Zeile ausgegeben.
15.33	296	:; NESTED
15.34	297	:: Im {{smallcaps}}Scss{{/smallcaps}} verschachtelte Regeln Selektoren durch Einrückung im {{smallcaps}}Css{{/smallcaps}} dargestellt.
15.32	298	; Zu unterstützende Browser
16.8	299	: Hier kann festgelegt werden, welche Browser unterstützt werden sollen. Dies hat etwa Auswirkungen darauf, welche Vendor-Präfixe automatisch hinzugefügt werden. Die Auswahl der Browser geschieht über eine sogenannte Browser-Query, zur Syntax siehe [[github.com/browserslist>>url:https://github.com/browserslist/browserslist#queries\|\|rel="noopener noreferrer" target="_blank"]]. Durch Betätigen der Schaltfläche //Browser aufzeigen// kann angezeigt werden, welche Browser letzlich bei einer Query herauskommen.
15.32	300	; Anzahl der Leerzeichen für die Einrückung
15.36	301	: Falls in der Ausgabe Zeilen eingerückt werden, kann hier festgelegt werden, wieviele Leerzeichen pro Einrückungslevel verwendet werden sollen.
15.32	302	; Genaugikeit für nummerische Berechnungen
15.36	303	: Die Genauigkeit (Anzahl der Kommastellen) für nummerische Berechnungen während der Transpilation, etwa wenn verschiedene {{smallcaps}}Css{{/smallcaps}}-Einheiten ineinander umgerechnet werden.
15.32	304	; Kommentare erhalten
15.36	305	: Wenn diese Option aktiviert ist, werden Kommentare im {{smallcaps}}Scss{{/smallcaps}} nicht entfernt.
15.32	306
15.29	307	==== Postcss-Einstellungen ====
	308
15.69	309	Hier können einige Einstellungen für [[postcss>>url:https://github.com/postcss/postcss\|\|rel="noopener noreferrer" target="_blank"]] getroffen werden, um das erzeugte {{smallcaps}}Css{{/smallcaps}} nachzubearbeiten.
15.37	310
15.38	311	; Doppelte {{smallcaps}}Css{{/smallcaps}}-Regeln entfernen
15.43	312	: Wenn diese Option aktiviert ist, werden doppelte {{smallcaps}}Css{{/smallcaps}}-Regeln entfernt. In der Regel ist dies unproblematisch. Wenn Selektoren sich gegenseitig überschreiben, kann dies in Einzelfällen das Layout beeinflussen.
15.69	313	; Unterstützung für [[Polyfiller>>url:https://de.wikipedia.org/wiki/Polyfill\|\|rel="noopener noreferrer" target="_blank"]] für neue {{smallcaps}}Css{{/smallcaps}}-Features aktivieren
	314	: Wenn aktiviert, wird das [[postcss-preset-env>>url:https://github.com/csstools/postcss-preset-env\|\|rel="noopener noreferrer" target="_blank"]]-Plugin für postcss aktiviert. Damit können aktuelle {{smallcaps}}Css{{/smallcaps}}-Features auch in älteren Browsern genutzt werden. Ob ein [[Polyfill>>url:https://de.wikipedia.org/wiki/Polyfill\|\|rel="noopener noreferrer" target="_blank"]] für ein bestimmtes {{smallcaps}}Css{{/smallcaps}}-Features aktiviert ist, wird von den zu unterstützenden Browsern bestimmt (siehe oben).
15.38	315	; Minimale {{smallcaps}}Css{{/smallcaps}}-Stage für unterstützte Features
15.69	316	: Bestimmt die [[{{smallcaps}}Css{{/smallcaps}}-Stage>>url:https://cssdb.org/#staging-process\|\|rel="noopener noreferrer" target="_blank"]], die ein {{smallcaps}}Css{{/smallcaps}}-Feature wenigstens haben muss, um durch das [[postcss-preset-env>>url:https://github.com/csstools/postcss-preset-env\|\|rel="noopener noreferrer" target="_blank"]]-Plugin potentiell mit einem Polyfill versehen zu werden.
15.37	317
15.29	318	==== Autoprefixer-Einstellungen ====
	319
15.69	320	In diesem Abschnitt kann das [[autprefixer>>url:https://github.com/postcss/autoprefixer\|\|rel="noopener noreferrer" target="_blank"]]-Plugin für [[postcss>>url:https://github.com/postcss/postcss\|\|rel="noopener noreferrer" target="_blank"]] konfiguriert werden. Diese fügt automatisch [[Vendor-Präfixe>>url:https://developer.mozilla.org/en-US/docs/Glossary/Vendor_Prefix\|\|rel="noopener noreferrer" target="_blank"]] automatisch hinzu. Welche Präfixe hinzugefügt werden, hängt von den eingestellten Browsern ab (siehe oben).
15.43	321
15.38	322	; Automatisches Hinzufügen von Präfixen aktivieren
15.43	323	: Wenn diese Option aktiviert ist, werden Vendor-Präfixe automatisch hinzugefügt.
15.38	324	; Unbenötigte Präfixe entfernen
15.43	325	: Wenn diese Option aktiviert ist, werden unbenötigte Vendor-Präfixe automatisch entfernt. Etwa werden Präfixe für alte Browser entfernt, die nicht mehr unterstützt werden brauchen.
15.38	326	; Präfix für @supports-Regeln hinzufügen
15.69	327	: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[@supports>>url:https://developer.mozilla.org/en-US/docs/Web/CSS/@supports\|\|rel="noopener noreferrer" target="_blank"]]-Regeln hinzugefügt.
15.38	328	; {{smallcaps}}Css{{/smallcaps}} einrücken wenn nicht minifiziert (Visual Cascade)
15.45	329	: Aktiviert die //cascade//-Option von //autprefixer// (Deklarationen am Doppelpunkt ausrichten).
15.38	330	; Präfixe für Flexbox-Eigenschaften hinzufügen
15.69	331	: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[Flexbox>>url:https://css-tricks.com/snippets/css/a-guide-to-flexbox/\|\|rel="noopener noreferrer" target="_blank"]]-Eigenschaften hinzugefügt.
15.38	332	; Präfixe für Rastereigenschaften (grid) hinzufügen
15.69	333	: Wenn diese Option aktiviert ist, werden auch Vendor-Präfixe für [[Grid>>url:https://css-tricks.com/snippets/css/complete-guide-grid/\|\|rel="noopener noreferrer" target="_blank"]]-Eigenschaften hinzugefügt.
15.29	334
15.70	335	== Versionshistorie ==
15.45	336
30.4	337	=== 0.8.0 ===
	338
	339	* Anpassungen für {{formcycle/}} Version 6.5.x. Diese Version ist nicht mit Version 6.4.x kompatibel.
	340
30.3	341	=== 0.7.1 ===
	342
	343	* Standardmäßig wird das mitgelieferte layout nicht mehr als Standard-Modern-Theme festgelegt. Beim Initialisieren des Plugin wurde immer die Datei //031-extended.css// automatisch erzeugt. Dies führte zu Problemen, dass diese CSS-Dateien im in Formulare eingebettet werden.
	344
15.69	345	=== 0.7.0 ===
15.64	346
16.9	347	* Anpassungen für {{formcycle/}} Version 6.4.x.
15.65	348	* Behebung eines Problems der Oberfläche, wo beim Öffnen einer Layout-Vorlage manchmal eine Fehlermeldung kam.
	349	* Kleine Darstellungsfehler an der Oberfläche behoben.
15.66	350	* Browser-Liste aktualisiert.
15.64	351
15.69	352	=== 0.6.1 ===
15.45	353
16.9	354	* Browserlist aktualisiert.
	355	* Modern-Theme-Vorlage aktualisiert.
15.45	356
15.69	357	=== 0.6.0 ===
15.45	358
16.10	359	* Anpassungen für {{formcycle/}} Version 6.3.x.
15.63	360	* Es kann ein Layout als Standard-Modern-Theme gewählt werden.
15.64	361	* Ein Layout kann sowohl als Mandantdatei als auch auch {{smallcaps}}Css{{/smallcaps}}-Template gespeichert werden. Zudem kann es auch nur als Standard-Modern-Theme gespeichert werden.
15.69	362	* Volle Breite für Formularvorschau. Die Auswahl des Formulars ist nun in einem Overlay-Dialog, der bei Klick auf das Zahnradsymbol rechts oben erscheint.
15.63	363	* Beim Installieren des Plugins wird neben einer Modern-Theme-Layout-Vorlage auch ein Layout für das Modern-Theme erstellt (falls dieses noch nicht existiert).
	364	* Kleinere Bug-Fixes.
15.45	365
15.69	366	=== 0.5.0 ===
15.45	367
15.63	368	* Kleine Anpassungen an der Oberfläche.
	369	* Am Vorschauformular können nun auch URL-Parameter gesetzt werden.
16.10	370	* `Basis-Theme in Vorschau deaktivieren` und //Modern-Theme in Vorschau deaktivieren// sind nun Eigenschaften der Layout-Vorlage
	371	* Neue Eigenschaft //Formular-Theme in Vorschau deaktivieren//
	372	* //postcss-discard-duplicates//-Plugin für postcss hinzugefügt.
	373	* Bei {{smallcaps}}Scss{{/smallcaps}}-Import-{{smallcaps}}Url{{/smallcaps}}s kann an die {{smallcaps}}Url{{/smallcaps}} der Parameter //previewOnly// angehangen werden. Die Dateien werden dann nur für die Vorschau inkludiert, nicht im transpilierten {{smallcaps}}Css{{/smallcaps}}, das abgespeichert wird.
	374	* Änderungen der Sytnax bei Import im {{smallcaps}}Scss{{/smallcaps}}. Der Pfad muss eine gültige {{smallcaps}}Uri{{/smallcaps}} sein: {{code language="none"}}@import "client/current/file.scss{{/code}}. Zudem können nun auch Layout-Vorlagen und Layouts direkt importiert werden.
15.45	375
15.69	376	=== 0.4.0 ===
15.45	377
15.64	378	* Anpassung an der Oberfläche.
	379	* Möglichkeit zur einspaltigen Darstellung von Editoren.
15.45	380
15.69	381	=== 0.3.0 ===
15.45	382
15.64	383	* Postprocessing und Prefixing für den {{smallcaps}}Css{{/smallcaps}}-Transpilierungsprozess.
	384	* Import und Export überarbeitet.
	385	* Dialoge zur Behebung fehlender oder invalider Referenzen in Konfigurationsdateien.
15.45	386
15.69	387	=== 0.2.0 ===
15.45	388
15.64	389	* Unterstützung der Auswahl von mehreren Dateien für den Export.
15.45	390
15.69	391	=== 0.1.0 ===
15.45	392
15.64	393	* Initialer Release.
	394	* Unterstützt {{formcycle/}} in Version 6.1.x.

Wiki-Quellcode von Theme-Konfigurator-Plugin

Navigation