Wiki-Quellcode von Gewinnspiel-Portal-Plugin

Zeige letzte Bearbeiter
1 [[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/Gewinnspiel-Portal (fc-portal-contest)&fileid=13794||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung)
2
3 {{content/}}
4
5 {{info}}
6 {{version major="6" minor="1" patch="0"/}}Für das Gewinnspiel-Portal-Plugin wird mindestend {{formcycle/}} in der Version 6.1.0 benötigt
7 {{/info}}
8
9 {{figure image="beispiel_de.jpg" clear="h2"}}
10 Beispiel für ein mit dem Plugin erstelltes Gewinnspiel-Portal.
11 {{/figure}}
12
13 Das Gewinnspiel-Portal bietet die Möglichkeit, Portale für eine beliebige Anzahl an Gewinnspielen innerhalb von {{formcycle/}} zu erstellen und verwalten. Diese Gewinnspiele nutzen für die Dateneingabe der Teilnehmer {{formcycle/}} Formulare. Das Gewinnspiel-Portal kann auf allen Mandanten auf dem {{fcserver/}} genutzt werden, wobei auf jedem Mandanten ein eigenes Gewinnspiel-Portal eingerichtet werden kann.
14
15 == Installation ==
16
17 Das Gewinnspiel-Portal kann nur als [[Systemplugin>>doc:Formcycle.SystemSettings.UserInterface.SystemPlugins]] installiert werden und ist daher automatisch für alle Mandanten auf dem {{formcycle/}} Server nutzbar. Das Gewinnspiel-Portal besteht aus zwei separaten Plugins, //contest-view-portal.jar// und //contest-management-portal.jar//, welche zwingend zusammen installiert werden müssen. Es ist dabei egal, in welcher Reihenfolge die beiden Plugins installiert werden.
18
19 == Rollenrechte ==
20
21 {{figure image="rollenrechte_de.png" clear="h2"}}
22 Nach der Installation des Plugins zusätzlich konfigurierbare [[Rollenrechte>>doc:Formcycle.UserInterface.UserSettings.Roles]] in der Benuterverwaltung.
23 {{/figure}}
24
25 Die Menüeinträge des Gewinnspielportals sind auf der {{formcycle/}} Oberfläche standardmäßig nicht sichtbar. Es müssen daher bei den entsprechenden Nutzergruppen unter [[Rollen>>doc:Formcycle.UserInterface.UserSettings.Roles]] die Rechte für das Konfigurieren und für das Öffnen des Gewinnspielportals gesetzt werden. Diese Rechte sind wie folgt untergliedert:
26
27 === Gewinnspiel-Portal verwalten ===
28
29 Unter diesem Hauptpunkt können alle für die Administration des Gewinnspiel-Portals nötigen Rechte vergeben werden.
30
31 ==== Gewinnspiele verwalten ====
32
33 ; Gewinnspiel anlegen (leer)
34 : Berechtigung ein neues Gewinnspiel anzulegen, welches nicht auf einer Vorlage beruht
35
36 ; Gewinnspiel importieren
37 : Berechtigung ein exportiertes Gewinnspiel importieren zu dürfen
38
39 ; Gewinnspiel aus Vorlage anlegen
40 : Berechtigung ein neues Gewinnspiel anzulegen, welches auf einer Vorlage aufbaut
41
42 ; Gewinnspiel kopieren
43 : Berechtigung ein vorhandenes Gewinnspiel kopieren zu dürfen
44
45 ; Gewinnspiel exportieren
46 : Berechtigung ein vorhandenes Gewinnspiel exportieren zu dürfen
47
48 ; Gewinnspiel löschen
49 : Berechtigung ein vorhandenes Gewinnspiel löschen zu dürfen
50
51 ; Gewinnspiel-Formular bearbeiten
52 : Berechtigung ein vorhandenes Gewinnspiel bearbeiten zu dürfen
53
54 ==== Vorlagen verwalten ====
55
56 Notwendige Berechtigung, um neue Gewinnspielvorlagen erstellen und vorhandene Gewinnspielvorlagen bearbeiten und löschen zu dürfen. Nur wenn dieses Recht aktiv ist, kann der Nutzer ein vorhandenes Gewinnspiel als Vorlage speichern.
57
58 ==== Konfigurieren ====
59
60 Berechtigung, um die für alle Gewinnspiele verwendete Oberfläche konfigurieren zu dürfen
61
62 === Gewinnspiel-Portal öffnen ===
63
64 Berechtigung, das Gewinnspiel-Portal aus {{formcycle/}} heraus direkt öffnen zu dürfen
65
66 == Menüpunkte auf der Verwaltungsoberfläche ==
67
68 {{figure image="portal_menue_elemente_de.png" clear="h2" width="150"}}
69 Zusätzliche Menüpunkte auf der {{formcycle/}} Verwaltungsoberfläche.
70 {{/figure}}
71
72
73 {{html wiki="true"}}
74 <div class='xm-figure xm-float-right xm-clear-h2' data-alt='Zusätzliche Menüpunkte auf der Verwaltungsoberfläche.'><div class='xm-figure-inner' style='width:160px'>{{lightbox image='portal_menue_elemente_de.png' width='150' group='$height' group='$group' title='Zusätzliche Menüpunkte auf der Verwaltungsoberfläche.'/}}<div class='xm-figure-caption'>Zusätzliche Menüpunkte auf der {{formcycle/}} Verwaltungsoberfläche.</div></div></div>
75 {{/html}}
76
77
78 Durch die Konfiguration der entprechenden Rollenrechte erscheinen die folgenden neuen Menüeinträge auf der Verwaltungsoberfläche:
79
80
81 === Gewinnspiele ===
82
83 Nachdem das Gewinnspiel-Portal installiert wurde und der entsprechende Nutzer die Berechtigungen erhalten hat, befinden sich auf der {{formcycle/}} Verwaltungsoberfläche ein neuer Menüpunkt //Gewinnspiele// mit den folgenden drei Unterpunkten:
84
85 ; Gewinnspiele verwalten
86 : Unter diesem Punkt können Gewinnspiele angelegt und die Einstellungen von vorhandenen Gewinnspielen eingesehen und angepasst werden. Siehe [[Gewinnspiele verwalten>>doc:Formcycle.PluginDocumentation.ContestPortalPlugin.WebHome||anchor="backend_gewinnspiele"]].
87
88 ; Vorlagen verwalten
89 : Unter diesem Punkt können neue Vorlagen für Gewinnspiele angelegt und vorhandene Vorlagen eingesehen und angepasst werden. Siehe [[Vorlagen verwalten>>doc:Formcycle.PluginDocumentation.ContestPortalPlugin.WebHome||anchor="backend_vorlagen"]].
90
91 ; Konfiguration
92 : Unter diesem Punkt können Stuktur, Aussehen und Verhalten des Gewinnspiel-Portals konfiguriert werden. Siehe [[Portal konfigurieren>>doc:Formcycle.PluginDocumentation.ContestPortalPlugin.WebHome||anchor="backend_portal"]].
93
94 === Gewinnspiel öffnen ===
95
96 Wenn für den Benutzer in den Rollenrechten die Berechtigung zum Öffnen des Gewinnspiel-Portals gegeben wurde, erscheint im Hauptmenü auf der {{formcycle/}} Verwaltungsoberfläche eine zusätzliche Schaltfläche //Gewinnspiel öffnen//.
97
98 == Grundstruktur des Gewinnspiel-Portals ==
99
100 Mit dem Gewinnspiel-Portal kann aus mehreren vorgegebenen Elementen eine Portal-Webseite konfiguriert werden, in welcher die für ein Gewinnspiel-Portal benötigten Elemente enthalten sind. Die Webseite untergliedert sich in die folgenden Elemente:
101
102 ; (1) Kopfbereich, (7) Fußbereich und (4) Trenner vom Portal
103 : Diese Elemente werden einmal konfiguriert und werden für alle Gewinnspiele im Gewinnspiel-Portal genutzt.
104
105 ; (2) Bannergrafik, (3) Inhalt (Formular, Beschreibung, ggf. Ankündigungen oder Mitteilungen über den Beginn oder das Ende des Gewinnspiels), (5) Teilnahmebedingungen und (6) Datenschutz
106 : Diese Elemente können für jedes Gewinnspiel individuell konfiguriert werden.
107
108 {{lightbox image="portal_aufbau_de.jpg" group="g0" width="800"/}}
109
110 == Verwaltungsoberfläche im FORMCYCLE Backend ==
111
112 {{id name="backend_gewinnspiele"/}}
113
114 === Gewinnspiele verwalten ===
115
116 {{figure image="gewinnspiele_ui_de.png" clear="h2"}}
117 Verwaltungsoberfläche für den Menüpunkt //Gewinnspiele verwalten//
118 {{/figure}}
119
120 Unter diesem Menüpunkt können die vorhandenen Gewinnspiele verwaltet und neue Gewinnspiele angelegt werden.
121
122 ==== Menü ====
123
124 Auf der linken Seite befindet sich die Liste aller vorhandenen Gewinnspiele. Über die Buttons über der Liste kann ein neues Gewinnspiel angelegt werden {{ficon name="plus-circle-outline"/}} oder ein zuvor in der Liste ausgewähltes Gewinnspiel kopiert {{icon name="fa-files-o" title="Kopieren" size="1x" cssClass="fa-files-o"/}}, exportiert {{icon name="fa-download" title="Exportieren" size="1x" cssClass="fa-download"/}}, als Vorlage gespeichert {{icon name="fa-save" title="Als Vorlage speichern" size="1x" cssClass="fa-save"/}} oder gelöscht {{ficon name="trash-alt2"/}} werden. Über die Suchen-Schaltfläche {{icon name="fa-search" title="Suchen" size="1x" cssClass="fa-search"/}} kann ein Eingabefeld eingeblendet werden, nach dessen Inhalt die Gewinnspiel-Liste automatisch gefiltert wird. Beim Anlegen eines neuen Gewinnspiels kan entweder ein neues leeres Gewinnspiel angelegt, ein zuvor exportiertes Gewinnspiel wieder geladen oder eine Vorlage als Grundlage für das Gewinnspiel verwendet werden.
125
126 Links neben dem Namen des Gewinnspiels wird jeweils ein Symbol angezeigt, welches die folgende Bedeutung hat:
127
128 ; {{ficon name="checkbox-marked-circle"/}}
129 : Ein ausgefüllter Kreis mit Haken bedeutet, dass das Gewinnspiel aktiviert ist und sich aktuell innerhalb des konfigurierten Online-Zeitraumes befindet
130 ; {{ficon name="checkbox-marked-circle-outline"/}}
131 : Ein nicht ausgefüllter Kreis mit Haken bedeutet, dass das Gewinnspiel aktiviert ist, sich aber aktuell nicht innerhalb des konfigurierten Online-Zeitraumes befindet. Das heißt dass das Gewinnspiel entweder nicht mehr oder noch nicht online ist.
132 ; {{ficon name="circle-outline"/}}
133 : Ein leerer Kreis bedeutet, dass das Gewinnspiel momentan nicht aktiv ist
134
135 ==== Einstellungen ====
136
137 {{figure image="gs_onlineeinstellungen_de.png" clear="h2"}}
138 Mögliche Optionen zum Konfigurieren der (datumsabhängigen) Sichtbarkeit des Gewinnspiels und der Positionierung des Beschreibungstextes
139 {{/figure}}
140
141
142 {{html wiki="true"}}
143 <div class='xm-figure xm-float-right xm-clear-h2' data-alt='Mögliche Optionen zum Konfigurieren der (datumsabhängigen) Sichtbarkeit des Gewinnspiels und der Positionierung des Beschreibungstextes'><div class='xm-figure-inner' style='width:310px'>{{lightbox image='gs_onlineeinstellungen_de.png' width='300' group='$height' group='$group' title='Mögliche Optionen zum Konfigurieren der (datumsabhängigen) Sichtbarkeit des Gewinnspiels und der Positionierung des Beschreibungstextes'/}}<div class='xm-figure-caption'>Mögliche Optionen zum Konfigurieren der (datumsabhängigen) Sichtbarkeit des Gewinnspiels und der Positionierung des Beschreibungstextes</div></div></div>
144 {{/html}}
145
146
147 Nachdem auf die //Neues Gewinnspiel//-Schaltfläche geklickt oder ein Gewinnspiel in der Liste ausgewählt wurde, erscheint rechts die Konfigurationsseite für das Gewinnspiel. Hier können im oberen Bereich links konfiguriert werden, wann und wie das Gewinnspiel sichtbar sein soll. Die foldenden Optionen können konfiguriert werden:
148
149
150 ; **Aktiviert (Das Gewinnspiel ist aufrufbar)**
151 : Das Gewinnspiel kann über einen Link aufgerufen werden
152
153 ; **Gewinnspiel im Portal anzeigen**
154 : Das Gewinnspiel wird im Portal angezeigt; Nur anwählbar, wenn die Option //**Aktiviert** (Das Gewinnspiel ist aufrufbar)// zuvor angewählt wurde; Anderenfalls ist diese Option ausgegraut und das Gewinnspiel wird nicht im Portal angezeigt
155
156 ; **Name des Gewinnspiels:**
157 : Im Portal angezeigter Name des Gewinnspiels. Wird zudem als //title//-Attribut für das {{formcycle/}}-Formular des Gewinnspiels verwendet.
158
159 ; **UUID des Gewinnspiels:**
160 : Gibt die eindeutige UUID des Gewinnspiels aus um dieses identifizieren zu können.
161
162 ; **Online von:**
163 : Zeitpunkt, ab dem das Gewinnspiel online geschaltet wird. Falls die Option //**Aktiviert** (Das Gewinnspiel ist aufrufbar)// angewählt wurde, wird vor dem an dieser Stelle konfigurierten Zeitpunkt beim Öffnen des Gewinnspiels nur die //Ankündigung// des Gewinnspiels angezeigt. Sofern //Gewinnspiel im Portal anzeigen// angewählt wurde, wird das Gewinnspiel auch vor dem hier konfigurierten Zeitpunkt bereits im Gewinnspiel-Portal angezeigt. Auch in diesem Fall wird beim Öffnen des Gewinnspiels die //Ankündigung// gezeigt.
164
165 ; **Online bis:**
166 : Zeitpunkt, ab dem das Gewinnspiel offline geschaltet wird. Falls die Option //**Aktiviert** (Das Gewinnspiel ist aufrufbar)// angewählt wurde, wird ab dem an dieser Stelle konfigurierten Zeitpunkt beim Öffnen des Gewinnspiels nur die //Abgelaufen//-Mitteilung des Gewinnspiels angezeigt. Sofern //Gewinnspiel im Portal anzeigen// angewählt wurde, wird das Gewinnspiel auch vor dem hier konfigurierten Zeitpunkt bereits im Gewinnspiel-Portal angezeigt. Auch in diesem Fall wird beim Öffnen des Gewinnspiels die //Ankündigung// gezeigt.
167
168 ; **Layout:**
169 : An dieser Stelle kann über 5 Buttons konfiguriert werden, ob und wenn ja an welcher Stelle der konfigurierte //Beschreibungstext// angezeigt werden soll. Zur Auswahl stehen:
170 :; **Formular links**
171 :: Der //Beschreibungstext// wird rechts neben dem Formular angezeigt
172 :; **Formular rechts**
173 :: Der //Beschreibungstext// wird links neben dem Formular angezeigt
174 :; **Formular oben**
175 :: Der //Beschreibungstext// wird unter dem Formular angezeigt
176 :; **Formular unten**
177 :: Der //Beschreibungstext// wird über dem Formular angezeigt
178 :; **ohne Beschreibung**
179 :: Es wird nur das Formular und kein //Beschreibungstext// angezeigt
180
181 {{figure image="gs_microsite_de.png" clear="h2"}}
182 Mögliche Optionen zum Öffnen des Gewinnspiels bzw. zum Generieren von Code zum Einbetten des Gewinnspiels im Punkt //Microsite//
183 {{/figure}}
184
185 ; **Microsite**
186 : An dieser Stelle werden drei Schaltflächen angezeigt, mit denen das ausgewählte Gewinnspiel geöffnet oder ein Link zum Gewinnspiel ermittelt werden kann. Die Buttons haben dabei die folgenden Funktionen:
187 :; **Öffnen**
188 :: Öffnet das Gewinnspiel so, wie es aktuell sichtbar ist. Dabei werden alle durch das Gewinnspiel konfigurieten Inhalte angezeigt. Die durch das Gewinnspiel-Portal bereitgestellten Inhalte wie Kopfbereich, Furßbereich, usw. werden nicht mit dargestellt.
189 :; **Vorschau**
190 :: Selbe Funktion wie die //Öffnen//-Schaltfläche, allerdings wird das Formular im Vorschaumodus geöffnet. Beim Absenden des Formulars wird inneralb des zuvor vom Formualar verwendeten Bildschirmbereichs die Zusammenfassung über die an den Server übertragenen Daten angezeigt, welche auch bei einem normalen {{formcycle/}}-Formular nach dem Absenden aus der Vorschau angezeigt. Am rechten Rand der Schaltfläche kann durch den Klick auf den nach unten gerichteten Pfeil ein Menü geöffnet werden, welches zwei weitere Vorschau-Optionen enthält. Diese sind:
191 :; **Vorschau als angekündigt**
192 :: Öffnet das Gewinnspiel so, wie es sichtbar ist, wenn der Zeitpunkt ab dem es online ist noch nicht erreicht wurde.
193 :; **Vorschau als abgelaufen**
194 :: Öffnet das Gewinnspiel so, wie es sichtbar ist, wenn der Zeitpunkt bis zu dem es online war überschritten wurde.
195 :; **Bereitstellen**
196 :: Öffnet einen Dialog, in dem die URL zum Öffnen des Gewinnspiels ermittelt werden kann. Hierbei können die folgenden Optionen konfiguriert werden, welche das Aussehen des Gewinnspiels beeinflussen:
197 ::; **Kopfbereich des Gewinnspiels ausblenden (Bilder)**
198 ::: Wenn diese Option gewählt wird, wird die Bannergrafik nicht angezeigt.
199 ::; **Beschreibung des Gewinnspiels ausblenden**
200 ::: Wenn diese Option gewählt wird, wird die Beschreibung des Gewinnspiels nicht angezeigt, unabhängig davon, was unter //Layout// konfiguriert wurde.
201 ::; **Fußbereich des Gewinnspiels ausblenden (Datenschutz & Teilnahmebedingungen)**
202 ::: Wenn diese Option gewählt wird, werden die für das Gewinnspiel konfigurierten Inhalte für //Datenschutz// und //Teilnahmebedingungen// nicht angezeigt.
203 ::; **Zu verwendender Server**
204 ::: Auswahl, über welchen Server das Gewinnspiel geöffnet werden soll. Zur Auswahl stehen Master- und eventuell vorhande Frontend-Server.
205 :: Darunter wird die sich aufgrund der selektierten Optionen ergebende URL angezeigt. Durch einen Klick auf die //Quellcode kopieren//-Schaltfläche rechts kann diese in die Zwischenablage kopiert werden.
206 :: Alternativ kann durch einen Klick auf den nach unten gerichteten Pfeil am rechten Rand der Schaltfläche ein Menü geöffnet werden, welches drei weitere Optionen enthält. Diese öffnen jeweils einen Dialog, dessen Konfigurationsmöglichkeiten den bereits beschriebenen entsprecht. Anstelle einer URL werden allerdings in eine Webseite einzufügende Inhalte zum Einbinden des Gewinnspiels angezeigt. Die drei Optionen sind:
207 :; **Bereitstellen als HTML Link**
208 :: Generiert Quellcode, mit dem das Gewinnspiel direkt als HTML-Code in eine Webseite eingebunden werden kann.
209 :; **Bereitstellen als Inlineframe**
210 :: Generiert Quellcode, mit dem das Gewinnspiel als Inlineframe in eine Webseite eingebunden werden kann.
211 :; **Bereitstellen als Ajax/JavaScript**
212 :: Generiert Quellcode, mit dem das Gewinnspiel per Ajax (JavaScript) in eine Webseite eingebunden werden kann.
213
214 {{figure image="gs_inhalt_de.png" clear="h2"}}
215 Quellcode-Ansicht eines Editors im Reiter //Teilnahmebedingungen// von //Inhalt//.
216 {{/figure}}
217
218 ; **Inhalt**
219 : An dieser Stelle wird der eigentliche Inhalt des Gewinnspiels konfiguriert. Die einzelnen Inhaltselemente des Gewinnspiels können über die oben befindlichen Schaltflächen ausgewählt werden. Danach kann in dem darunter befindlichen WYSIWYG-Editor der jeweilige Inhalt eingefügt werden. Bei den HTML-Inhalten kann durch einen Klick auf //Quellcode// jeweils in die Quellcodeansicht gewechselt werden. Hierdurch können zum Beispiel für bestimmte Inhalte auch eigene IDs oder CSS-Klassen genutzt werden. Falls das Gewinnspiel nicht im Portal geöffnet werden soll, aber zusätzlicher JavaScript- und CSS-Code dafür benötigt wird, kann dieser unter //JavaScript (Microsite)// bzw. unter //CSS (Microsite)// definiert werden.
220 : Folgende Inhalte können an dieser Stelle konfiguriert werden:
221 :; **Beschreibung**
222 :: Beschreibungstext zum Gewinnspiel. Wird neben bzw. über oder unter dem Formular angezeigt.
223 :; **Teilnahmebedingungen**
224 :: Teilnahmebedingungen des Gewinnspiels. Wird im Portal unterhalb des Trenners neben dem //Datenschutz// angezeigt.
225 :; **Datenschutz**
226 :: Datenschutzbedingungen des Gewinnspiels. Wird im Portal unterhalb des Trenners neben den //Teilnahmebedingungen// angezeigt.
227 :; **Ankündigung**
228 :: Inhalt, welcher anstelle vom Formular und dem Beschreibungstext angezeigt wird, wenn das Gewinnspiel noch nicht gestartet ist.
229 :; **Abgelaufen**
230 :: Inhalt, welcher anstelle vom Formular und dem Beschreibungstext angezeigt wird, nachdem das Gewinnspiel beendet wurde.
231 :; **CSS (Microsite)**
232 :: Zusätzlicher CSS-Code, welcher nur für dieses Gewinnspiel verwendet werden soll.
233 :; **JavaScript (Microsite)**
234 :: Zusätzlicher JavaScript-Code, welcher nur für dieses Gewinnspiel verwendet werden soll.
235 :; **HTML header (Microsite)**
236 :: Zusätzlicher HTML-Code, welcher nur im Headerbereich dieses Gewinnspiels verwendet werden soll. Dies können zum Beispiel Metadaten oder Verweise auf andere CSS- oder JavaScript-Dateien sein.
237
238 {{figure image="gs_bannergrafiken_de.png" clear="h2"}}
239 Vorhandene Schaltflächen unter //Bannergrafiken//.
240 {{/figure}}
241
242 ; Bannergrafiken
243 : Oben rechts können die auf der Gewinnspiel-Portalseite beim Auswählen dieses Gewinnspiels und auf der Microsite angezeigten Bannergrafiken konfiguriert werden. Für unterschiedliche Geräteklassen bzw. Bildschirmauflösungen können dabei verschiedene Grafiken genutzt werden. Zur Auswahl stehen die folgenden Größen:
244 :: **Desktop** - ab 1026 px Bildschirmbreite; Muss konfiguriert werden
245 :: **Tablet** - zwischen 642 px und 1025 px Bildschirmbreite
246 :: **Mobile** - bei 641 px oder weniger Bildschirmbreite
247 : Wenn eine Bannergrafik für eine Geräteklasse nicht explizit konfiguriert wird, wird bei der Anzeige die Grafik des nächstgrößeren Formats verwendet. Dementsprechend sollte die Grafik für //Desktop// immer konfiguriert werden, während //Tablet// und //Mobile// optional sind. Unterstützt werden alle im Browser zulässigen Bildformate.
248
249 : Die folgenden Schaltflächen dienen der Konfiguration der Bannergrafiken:
250 :; **Desktop**, **Tablet** und **Mobile**
251 :: Durch anklicken dieser Schaltflächen kann zwischen den Grafiken für die einzelnen Geräteklassen gewchselt werden
252 :; **+ Bannergrafik ändern**
253 :: Öffnet einen Dateiauswahldialog zum selektieren einer lokal gespeicherten Grafik. Nach dem Bestätigen der Auswahl wird die Datei hochgeladen. Falls bereits zuvor eine Grafik vorhanden war, wird dieser ersetzt.
254 :; {{ficon name="trash-alt2"/}}-Symbol rechts neben dem Dateinamen einer bereits vorhandenen Grafik
255 :: Löschen der Grafik
256
257 ==== Fußzeile ====
258
259 Hier befinden sich die folgenden zwei Schaltflächen:
260
261 ; **Formular bearbeiten**
262 : Öffnet den Formulardesigner für den Formularteil des Gewinnspiels. Da es sich um ein normales {{formcycle/}}-Formular handelt, erfolgt die Erstellung und Konfiguration des Formulars analog. Vom Designer aus kann dementsprechend auch die Statusverarbeitung des Formulars konfiguriert werden.
263
264 ; **Speichern**
265 : Speichert die auf dieser Seite gemachten Einstellungen bzw. Änderungen an den Einstellungen.
266 \\\\{{id name="backend_vorlagen"/}}
267
268 === Vorlagen verwalten ===
269
270 {{figure image="vorlagen_ui_de.png" clear="h2"}}
271 Verwaltungsoberfläche für den Menüpunkt //Vorlagen verwalten//.
272 {{/figure}}
273
274 Unter diesem Menüpunkt können die vorhandenen Vorlagen für Gewinnspiele verwaltet und neue Vorlagen angelegt werden. An der Oberfläche kann eine Teilmenge der bei //Gewinnspiele verwalten// vorhandenen Optionen konfiguriert werden.
275
276 ==== Menü ====
277
278 Auf der linken Seite befindet sich die Liste aller vorhandenen Vorlagen. Über die Schaltfläche {{ficon name="plus-circle-outline"/}} über der Liste kann eine neue Vorlage angelegt werden, indem ein zuvor exportiertes Gewinnspiel oder eine zuvor exportierte Vorlage wieder importiert wird. Eine vorhandene Vorlage kann mit der sich daneben befindenden Schaltfläche {{icon name="fa-files-o" title="Kopieren" size="1x" cssClass="fa-files-o"/}} kopiert, mit {{icon name="fa-download" title="Exportieren" size="1x" cssClass="fa-download"/}} exportiert und mit {{ficon name="trash-alt2"/}} gelöscht werden. Über die Suchen-Schaltfläche {{icon name="fa-search" title="Suchen" size="1x" cssClass="fa-search"/}} kann ein Eingabefeld eingeblendet werden, nach dessen Inhalt die Vorlagen-Liste automatisch gefiltert wird.
279
280 ==== Einstellungen ====
281
282 Nachdem eine Vorlage angelegt bzw. in der Liste ausgewählt wurde, erscheint rechts die Konfigurationsseite für diese. Die foldenden Optionen können konfiguriert werden:
283
284 ; **Name der Vorlage:**
285 : Innerhalb von {{formcycle/}} angezeigter Name der Vorlage.
286
287 ; **Layout:**
288 : An dieser Stelle kann über 5 Buttons konfiguriert werden, ob und wenn ja an welcher Stelle der konfigurierte //Beschreibungstext// angezeigt werden soll. Zur Auswahl stehen:
289 :; **Formular links**
290 :: Der //Beschreibungstext// wird rechts neben dem Formular angezeigt
291 :; **Formular rechts**
292 :: Der //Beschreibungstext// wird links neben dem Formular angezeigt
293 :; **Formular oben**
294 :: Der //Beschreibungstext// wird unter dem Formular angezeigt
295 :; **Formular unten**
296 :: Der //Beschreibungstext// wird über dem Formular angezeigt
297 :; **ohne Beschreibung**
298 :: Es wird nur das Formular und kein //Beschreibungstext// angezeigt
299
300 ; **Microsite**
301 : An dieser Stelle wird nur eine Schaltflächen angezeigt, mit der die ausgewählte Vorlage wie ein normales Gewinnspiel im Vorschaumodus geöffnet werden kann. Der Button hat dabei die folgenden Funktionen:
302 :; **Vorschau**
303 :: Die Gewinnspiel-Vorlage bzw. das Formular wird im Vorschaumodus geöffnet. Beim Absenden des Formulars wird inneralb des zuvor vom Formualar verwendeten Bildschirmbereichs die Zusammenfassung über die an den Server übertragenen Daten angezeigt, welche auch bei einem normalen {{formcycle/}}-Formular nach dem Absenden aus der Vorschau angezeigt. Am rechten Rand der Schaltfläche kann durch den Klick auf den nach unten gerichteten Pfeil ein Menü geöffnet werden, welches zwei weitere Vorschau-Optionen enthält. Diese sind:
304 :; **Vorschau als angekündigt**
305 :: Öffnet die Gewinnspiel-Vorlage so, wie das Gewinnspiel sichtbar ist, wenn der Zeitpunkt ab dem es online ist noch nicht erreicht wurde.
306 :; **Vorschau als abgelaufen**
307 :: Öffnet die Gewinnspiel-Vorlage so, wie das Gewinnspiel sichtbar ist, wenn der Zeitpunkt bis zu dem es online war überschritten wurde.
308
309 {{figure image="gs_inhalt_de.png" clear="h2"}}
310 Quellcode-Ansicht eines Editors im Reiter //Teilnahmebedingungen// von //Inhalt//.
311 {{/figure}}
312
313 ; **Inhalt**
314 : An dieser Stelle wird der eigentliche Inhalt der Gewinnspiel-Vorlage konfiguriert. Die vorhandenen Optionen entsprechen exakt dem, was im Menüpunkt //Gewinnspiele verwalten// konfiguriert werden kann. Die einzelnen Inhaltselemente der Gewinnspiel-Vorlage können über die oben befindlichen Schaltflächen ausgewählt werden. Danach kann in dem darunter befindlichen WYSIWYG-Editor der jeweilige Inhalt eingefügt werden. Bei den HTML-Inhalten kann durch einen Klick auf //Quellcode// jeweils in die Quellcodeansicht gewechselt werden. Hierdurch können zum Beispiel für bestimmte Inhalte auch eigene IDs oder CSS-Klassen genutzt werden. Falls das in der Gewinnspiel-Vorlage konfigurierte Gewinnspiel später nicht im Portal geöffnet werden soll, aber zusätzlicher JavaScript- und CSS-Code dafür benötigt wird, kann dieser unter //JavaScript (Microsite)// bzw. unter //CSS (Microsite)// definiert werden.
315 : Folgende Inhalte können an dieser Stelle konfiguriert werden:
316 :; **Beschreibung**
317 :: Beschreibungstext der Gewinnspiel-Vorlage. Wird neben bzw. über oder unter dem Formular angezeigt.
318 :; **Teilnahmebedingungen**
319 :: Teilnahmebedingungen der Gewinnspiel-Vorlage. Wird im Portal unterhalb des Trenners neben dem //Datenschutz// angezeigt.
320 :; **Datenschutz**
321 :: Datenschutzbedingungen der Gewinnspiel-Vorlage. Wird im Portal unterhalb des Trenners neben den //Teilnahmebedingungen// angezeigt.
322 :; **Ankündigung**
323 :: Inhalt, welcher anstelle vom Formular und dem Beschreibungstext angezeigt wird, wenn das Gewinnspiel noch nicht gestartet ist.
324 :; **Abgelaufen**
325 :: Inhalt, welcher anstelle vom Formular und dem Beschreibungstext angezeigt wird, nachdem das Gewinnspiel beendet wurde.
326 :; **CSS (Microsite)**
327 :: Zusätzlicher CSS-Code, welcher nur für diese Gewinnspiel-Vorlage verwendet werden soll.
328 :; **JavaScript (Microsite)**
329 :: Zusätzlicher JavaScript-Code, welcher nur für diese Gewinnspiel-Vorlage verwendet werden soll.
330 :; **HTML header (Microsite)**
331 :: Zusätzlicher HTML-Code, welcher nur im Headerbereich dieses Gewinnspiels verwendet werden soll. Dies können zum Beispiel Metadaten oder Verweise auf andere CSS- oder JavaScript-Dateien sein.
332
333 {{figure image="gs_bannergrafiken_de.png" clear="h2"}}
334 Vorhandene Schaltflächen unter //Bannergrafiken//.
335 {{/figure}}
336
337 ; Bannergrafiken
338 : Oben rechts können die auf der Gewinnspiel-Portalseite beim Auswählen dieses Gewinnspiels und auf der Microsite angezeigten Bannergrafiken für diese Gewinnspiel-Vorlage konfiguriert werden. Für unterschiedliche Geräteklassen bzw. Bildschirmauflösungen können dabei verschiedene Grafiken genutzt werden. Zur Auswahl stehen die folgenden Größen:
339 :: **Desktop** - ab 1026 px Bildschirmbreite; Muss konfiguriert werden
340 :: **Tablet** - zwischen 642 px und 1025 px Bildschirmbreite
341 :: **Mobile** - bei 641 px oder weniger Bildschirmbreite
342 : Wenn eine Bannergrafik für eine Geräteklasse nicht explizit konfiguriert wird, wird bei der Anzeige die Grafik des nächstgrößeren Formats verwendet. Dementsprechend sollte die Grafik für //Desktop// immer konfiguriert werden, während //Tablet// und //Mobile// optional sind. Unterstützt werden alle im Browser zulässigen Bildformate.
343
344 : Die folgenden Schaltflächen dienen der Konfiguration der Bannergrafiken:
345 :; **Desktop**, **Tablet** und **Mobile**
346 :: Durch anklicken dieser Schaltflächen kann zwischen den Grafiken für die einzelnen Geräteklassen gewchselt werden
347 :; **+ Bannergrafik ändern**
348 :: Öffnet einen Dateiauswahldialog zum selektieren einer lokal gespeicherten Grafik. Nach dem Bestätigen der Auswahl wird die Datei hochgeladen. Falls bereits zuvor eine Grafik vorhanden war, wird dieser ersetzt.
349 :; {{ficon name="trash-alt2"/}}-Symbol rechts neben dem Dateinamen einer bereits vorhandenen Grafik
350 :: Löschen der Grafik
351
352 ==== Fußzeile ====
353
354 Hier befinden sich die folgenden zwei Schaltflächen:
355
356 ; **Formular bearbeiten**
357 : Öffnet den Formulardesigner für den Formularteil der Gewinnspiel-Vorlage. Da es sich um ein normales {{formcycle/}}-Formular handelt, erfolgt die Erstellung und Konfiguration des Formulars analog. Vom Designer aus kann dementsprechend auch die Statusverarbeitung des Formulars konfiguriert werden.
358
359 ; **Speichern**
360 : Speichert die auf dieser Seite gemachten Einstellungen bzw. Änderungen an den Einstellungen.
361 \\\\{{id name="backend_portal"/}}
362
363 === Konfiguration ===
364
365 {{figure image="portal_ui_de.png" clear="h2"}}
366 Verwaltungsoberfläche für den Menüpunkt //Portal konfigurieren//.
367 {{/figure}}
368
369 In diesem Menüpunkt kann das Aussehen des Gewinnspiel-Portals angepasst werden. Die folgenden Reiter stehen für die Konfiguration des Portals zur Verfügung:
370
371 ; Kopfbereich
372 : Über dem Formular angezeigter Inhalt.
373
374 ; Trenner
375 : Bereich, welcher zwischen Formular/Beschreibung und den Teilnahmebedingungen/Datenschutz angezeigt wird.
376
377 ; Fußbereich
378 : Unter Teilnahmebedingungen/Datenschutz angezeigter Inhalt.
379
380 ; CSS
381 : Innerhalb des Gewinnspiel-Portals zu verwendender CSS-Code.
382
383 ; JavaScript (Portal)
384 : Innerhalb des Gewinnspiel-Portals zu verwendender JavaScript-Code.
385
386 ; HTML header (Portal)
387 : Zusätzlicher HTML-Code, welcher im Headerbereich des Gewinnspiel-Portals verwendet werden soll. Dies können zum Beispiel Metadaten oder Verweise auf andere CSS- oder JavaScript-Dateien sein.
388
389 == Speicherort der Inhalte des Gewinnspiel-Portals ==
390
391 Die unter //Konfiguration// getätigten Einstellungen werden in {{formcycle/}} als Dateien hinterlegt. Diese befinden sich unter [[Dateien und Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.Files]].
392
393 **Es handelt sich um die folgenden Dateien:**
394 {{table dataTypeAlpha="0-1" preSort="0-asc" caption=""}}|=Dateiname|=Inhalt
395 |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
396 |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
397 |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
398 |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
399 |contest-portal.title.html|Titel der Gewinnspiel-Portalseite{{/table}}
400
401 (% class="xm-table xm-fw-false xm-fl-none" data-xm-table-dta="0-1" data-xm-table-ps="0-asc" %)
402 (((
403 |=Dateiname|=Inhalt
404 |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
405 |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
406 |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
407 |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
408 |contest-portal.title.html|Titel der Gewinnspiel-Portalseite
409 )))
410
411
412 (% class="xm-table xm-fw-false xm-fl-none" data-xm-table-dta="0-1" data-xm-table-ps="0-asc" %)
413 (((
414 |=Dateiname|=Inhalt
415 |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
416 |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
417 |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
418 |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
419 |contest-portal.title.html|Titel der Gewinnspiel-Portalseite
420 )))
421
422
423 (% class="xm-table xm-fw-false xm-fl-none" data-xm-table-dta="0-1" data-xm-table-ps="0-asc" %)
424 (((
425 |=Dateiname|=Inhalt
426 |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
427 |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
428 |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
429 |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
430 |contest-portal.title.html|Titel der Gewinnspiel-Portalseite
431 )))
432
433
434 (% class="xm-table xm-fw-false xm-fl-none" data-xm-table-dta="0-1" data-xm-table-ps="0-asc" %)
435 (((
436 |=Dateiname|=Inhalt
437 |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
438 |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
439 |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
440 |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
441 |contest-portal.title.html|(((
442 Titel der Gewinnspiel-Portalseite
443 )))
444 )))
445
446 == Versionshistorie ==
447
448 === 1.3.2 ===
449
450 * Korrektur falscher Bilder in der Lightbox der Gewinnspielübersicht
451
452 **1.3.1**
453
454 * Über den Plugin-Parameter //portal.usebaseurl// kann aktiviert werden, dass für die Gewinnspiel-URLs die hinterlegten Basis-URLs benutzt werden.
455 * Ausgabe der UUID des Gewinnspiels auf entsprechender Konfigurations-Seite
456
457 **1.3.0**
458
459 * Fehlerbehebung beim Ausliefern über den Frontend-Server
460 * Einbau eines iFrame-Resizer für Microseiten
461 * Weitergabe von scroll-Nachrichten an top-window
462
463 **1.2.4**
464
465 * Weiterleitung von postMessage an iframe innerhalb von Microsites
466
467 **1.2.3**
468
469 * Durchreichen von URL-Parametern an IFames im Portal
470 * Fix zum direkten Selektieren eines Gewinnspiels im Portal per URL-Parameter
471
472 **1.2.2**
473
474 * Undo/Redo-Funktionalität an Editoren aktiviert
475 * Zentral pflegbares Overlay für abgelaufene Gewinnspiele eingebaut
476 * Kleinere Anpassungen/Bugfixes
477
478 **1.2.0**
479
480 * Einbinden von grid.css auch in Portal- und Gewinnspiel-Text-Editoren
481 * Überarbeitung des Portal-Layoutings und Anpassung responsiver Breakpoints
482 * Separate Einbindung von jQuery um dass unnötigen Laden von Primefaces zu umgehen
483
484 **1.1.0**
485
486 * Anpassungen für FORMCYCLE Version 6.5.x und PrimeFaces 8
487
488 **1.0.1**
489
490 * Anpassungen für FORMCYCLE Version 6.4.x

Navigation

Copyright 2000-2025