| ... |
... |
@@ -75,6 +75,9 @@ |
| 75 |
75 |
; Löschfristen verwalten {{version major="1" minor="7"}}{{/version}} |
| 76 |
76 |
: Berechtigung, um Löschfristen zu erstellen, zu bearbeiten oder löschen zu dürfen. |
| 77 |
77 |
|
|
78 |
+; Gewinnspiel zurücksetzen {{version major="2"}}{{/version}} |
|
79 |
+: Berechtigung ein vorhandenes Gewinnspiel zurücksetzen zu dürfen. |
|
80 |
+ |
| 78 |
78 |
==== Vorlagen verwalten ==== |
| 79 |
79 |
|
| 80 |
80 |
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. |
| ... |
... |
@@ -83,6 +83,9 @@ |
| 83 |
83 |
|
| 84 |
84 |
Berechtigung, um die für alle Gewinnspiele verwendete Oberfläche konfigurieren zu dürfen |
| 85 |
85 |
|
|
89 |
+; Verwalten der Standard-Einstellungen für Löschfristen {{version major="2"}}{{/version}} |
|
90 |
+: Berechtigung, um die Standardeinstellungen für Löschfristen von Gewinnspielen zu verwalten. |
|
91 |
+ |
| 86 |
86 |
=== Gewinnspiel-Portal öffnen === |
| 87 |
87 |
|
| 88 |
88 |
Berechtigung, das Gewinnspiel-Portal aus {{formcycle/}} heraus direkt öffnen zu dürfen |
| ... |
... |
@@ -259,6 +259,17 @@ |
| 259 |
259 |
:: **Desktop** - ab 1026 px Bildschirmbreite; Muss konfiguriert werden |
| 260 |
260 |
:: **Tablet** - zwischen 642 px und 1025 px Bildschirmbreite |
| 261 |
261 |
:: **Mobile** - bei 641 px oder weniger Bildschirmbreite |
|
268 |
+ |
|
269 |
+{{figure image="header.png" clear="h2"}} |
|
270 |
+Seit Version 1.8.0 erweitere Varianten der //Bannergrafiken//. |
|
271 |
+{{/figure}} |
|
272 |
+ |
|
273 |
+: Ab Version {{version major="1" minor="8"}}{{/version}} wurden die Typen der Bannergrafiken überarbeitet und um die Pfelge von Grafiken für Fall eines Gewinns erweitert. |
|
274 |
+:: **Desktop (1280px)** - ab 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
275 |
+:: **Tablet (960px)** - zwischen 960 px und 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
276 |
+:: **Mobile (600px)** - zwischen 600 px und 960 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
277 |
+:: **Mobile (320px)** - bei 600 px oder weniger Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
278 |
+ |
| 262 |
262 |
: 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. |
| 263 |
263 |
|
| 264 |
264 |
: Die folgenden Schaltflächen dienen der Konfiguration der Bannergrafiken: |
| ... |
... |
@@ -371,6 +371,9 @@ |
| 371 |
371 |
; **Kategorie** |
| 372 |
372 |
: Frei definierbare Kategorisierung eines Gewinns. Wird in der Plugin-Aktion //Gewinn ermitteln// genutzt für eine möglichen Limitierung der Gewinnziehung auf eine Kategorie. |
| 373 |
373 |
|
|
391 |
+; **Gruppe** |
|
392 |
+: Frei definierbare Gruppe eines Gewinns. Wird für das Ausspielen der Meta-Daten eines Preises innerhalb des Formulars benutzt. Ein Preis ohne Gruppe steht für die Visualisierung innerhalb des Formulars nicht zur Verfügung. Bei gleichen Gruppen-Namen werden ausschließlich die Daten des ersten Preises bereitgestellt. |
|
393 |
+: |
| 374 |
374 |
; **Gewinncode** |
| 375 |
375 |
: Code des Gewinns, welcher im Gewinnspiel-Portal eingeben werden kann, um über die Plugin-Aktion //Gewinn ermitteln// einen Gewinner-Vorgang zuzuweisen. |
| 376 |
376 |
|
| ... |
... |
@@ -413,7 +413,7 @@ |
| 413 |
413 |
Auf der linken Seite der Fußzeile im Verwaltungsdialog der Gewinne befindet sich die Schaltfläche //+ Excel Import//. Nach dem Klicken auf die Schaltfläche öffnet sich ein Dateiauswahldialog, über den eine bereits bestehende lokale Excel-Datei selektiert werden kann. Die Excel-Datei muss weder vom Dateityp //.xls// oder //.xlsx// sein. |
| 414 |
414 |
|
| 415 |
415 |
Falls es sich bei der ausgewählten Datei um eine Excel-Datei handelt, öffnet sich ein Dialog zur Konfiguration des Imports der Gewinne aus der Excel-Datei. Hierbei kann zuerst das Excel-Blatt ausgewählt werden, in welchem sich die Gewinne in der Excel-Datei befinden. Über das Ankreuzfeld //Erste Zeile ignorieren// kann bei ggf. bestehenden Spaltenbeschriftungen der Gewinne die erste Zeile des Excel-Blatts ignoriert werden. |
| 416 |
|
-Über die fünf Eingabefelder können die zugehörigen Spaltennummern der Exceltabelle angegeben werden. Jedes Gewinnattribut (Name, Kategorie, Gewinncode, Gewinn-Link, Beschreibung, Bild-URL) wird genau einer Spalte in der Exceltabelle zugeordnet. Nach dem Drücken auf den Button //Importieren// werden die Gewinne erstellt auf Grundlage der Exceltabelle und sind danach im Verwaltungsdialog der Gewinne zu sehen. |
|
436 |
+Über die fünf Eingabefelder können die zugehörigen Spaltennummern der Exceltabelle angegeben werden. Jedes Gewinnattribut (Name, Kategorie, Gruppe, Gewinncode, Gewinn-Link, Beschreibung, Bild-URL) wird genau einer Spalte in der Exceltabelle zugeordnet. Nach dem Drücken auf den Button //Importieren// werden die Gewinne erstellt auf Grundlage der Exceltabelle und sind danach im Verwaltungsdialog der Gewinne zu sehen. |
| 417 |
417 |
\\{{id name="backend_prize_import"/}} |
| 418 |
418 |
|
| 419 |
419 |
|
| ... |
... |
@@ -488,11 +488,24 @@ |
| 488 |
488 |
Vorhandene Schaltflächen unter //Bannergrafiken//. |
| 489 |
489 |
{{/figure}} |
| 490 |
490 |
|
|
511 |
+ |
|
512 |
+ |
| 491 |
491 |
; Bannergrafiken |
| 492 |
492 |
: 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: |
| 493 |
493 |
:: **Desktop** - ab 1026 px Bildschirmbreite; Muss konfiguriert werden |
| 494 |
494 |
:: **Tablet** - zwischen 642 px und 1025 px Bildschirmbreite |
| 495 |
495 |
:: **Mobile** - bei 641 px oder weniger Bildschirmbreite |
|
518 |
+ |
|
519 |
+{{figure image="header.png" clear="h2"}} |
|
520 |
+Seit Version 1.8.0 erweitere Varianten der //Bannergrafiken//. |
|
521 |
+{{/figure}} |
|
522 |
+ |
|
523 |
+: Ab Version {{version major="1" minor="8"}}{{/version}} wurden die Typen der Bannergrafiken überarbeitet und um die Pfelge von Grafiken für Fall eines Gewinns erweitert. |
|
524 |
+:: **Desktop (1280px)** - ab 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
525 |
+:: **Tablet (960px)** - zwischen 960 px und 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
526 |
+:: **Mobile (600px)** - zwischen 600 px und 960 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
527 |
+:: **Mobile (320px)** - bei 600 px oder weniger Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
|
528 |
+ |
| 496 |
496 |
: 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. |
| 497 |
497 |
|
| 498 |
498 |
: Die folgenden Schaltflächen dienen der Konfiguration der Bannergrafiken: |
| ... |
... |
@@ -594,7 +594,7 @@ |
| 594 |
594 |
|
| 595 |
595 |
=== Rückgabewert der Plugin-Aktion === |
| 596 |
596 |
|
| 597 |
|
-Rückgabewert der Aktion sind die Attribute des möglichen Gewinns, welche über [[Aktionsplatzhalter>>doc:Formcycle.UserInterface.Variables||anchor="HAktionsplatzhalter"]] ausgelesen werden können. So können sie zum Beispiel in [[HTML-Templates>>Formcycle.UserInterface.FilesAndTemplates.HTML]] im Gewinnspiel-Portal angezeigt werden. Ein weiterer Anwendungsfall wäre die Verwendung als [[Abarbeitungsbedingung>>doc:Formcycle.Designer.Workflow.LegacyWorkflow.ActionConditions]] einer Aktion vom Typ [[Statusänderung>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ChangeState]] bei Erfolg der Aktion //Gewinn ermitteln//. Hier könnte im geänderten Status nun über eine Aktion vom Typ [[Abschlussseite>>doc:Formcycle.UserInterface.MyForms.WorkflowProcessing.Actions.ResponsePage]] ein bestimmtes HTML-Template angezeigt werden. |
|
630 |
+Rückgabewert der Aktion sind die Attribute des möglichen Gewinns, welche über [[Aktionsplatzhalter>>doc:Formcycle.UserInterface.Variables||anchor="HAktionsplatzhalter"]] ausgelesen werden können. So können sie zum Beispiel in [[HTML-Templates>>Formcycle.UserInterface.FilesAndTemplates.HTML]] im Gewinnspiel-Portal angezeigt werden. Ein weiterer Anwendungsfall wäre die Verwendung als [[Abarbeitungsbedingung>>doc:Formcycle.Designer.Workflow.LegacyWorkflow.ActionConditions]] einer Aktion vom Typ [[Statusänderung>>doc:Formcycle.Designer.Workflow.LegacyWorkflow.Actions.ChangeState]] bei Erfolg der Aktion //Gewinn ermitteln//. Hier könnte im geänderten Status nun über eine Aktion vom Typ [[Abschlussseite>>doc:Formcycle.Designer.Workflow.LegacyWorkflow.Actions.ResponsePage]] ein bestimmtes HTML-Template angezeigt werden. |
| 598 |
598 |
|
| 599 |
599 |
**Über die folgenden Aktionsplatzhalter kann auf die zurückgegebenen Attribute der Plugin-Aktion in FORMCYCLE zugegriffen werden:** |
| 600 |
600 |
|
| ... |
... |
@@ -737,7 +737,18 @@ |
| 737 |
737 |
} |
| 738 |
738 |
{{/code}} |
| 739 |
739 |
|
|
773 |
+==== (% id="cke_bm_1486S" style="display:none" %) (%%)Umschalten der Einzeige eines Gewinnspiels in den Gewonnen-Status: {{version major="1" minor="8"}}{{/version}} ==== |
| 740 |
740 |
|
|
775 |
+Um im Falle eines Gewinns die Anzeige des Gewinnspiels abzuändern (z.B. Austausch der Banner-Grafik) ist die Funktion Contest.markAsWon() gedacht. Diese erwartet als Parameter die ID des Gewinnspiel-Projektes und das window in welchem das eigentliche Formular z.B. als IFrame ausgeliefert wird. Der Haupteinsatzort dieser Funktion ist das HTML-Template welches im Falle eines Gewinns ausgeliefert werden soll. |
|
776 |
+ |
|
777 |
+{{code language="none"}} |
|
778 |
+// Snippet für eine HTML-Abschlussseite welches die Anzeige des aktuellen Gewinnspiels in den Gewonnen-Status schaltet. |
|
779 |
+// Funktioniert für die Bereitstellung als Micro-Site und innerhalb des Portals. |
|
780 |
+if (window.parent && window.parent.Contest) { |
|
781 |
+ window.parent.Contest.markAsWon([%$PROJECT_ID%], window); |
|
782 |
+} |
|
783 |
+{{/code}} |
|
784 |
+ |
| 741 |
741 |
=== Portal-spezifisch === |
| 742 |
742 |
|
| 743 |
743 |
Innerhalb des Portals wird für die Carousel-Darstellung die Bibliothekt [[slick>>https://kenwheeler.github.io/slick/||rel="noopener noreferrer" target="_blank"]] verwendet. Dies lässt sich hierbei wie folgt ansprechen und umkonfigurieren: |
| ... |
... |
@@ -839,6 +839,16 @@ |
| 839 |
839 |
|
| 840 |
840 |
== Versionshistorie == |
| 841 |
841 |
|
|
886 |
+=== 1.8.0 === |
|
887 |
+ |
|
888 |
+* Funktionalität der Pflege Bannergrafiken um weitere responsive Stufe und spezielle Grafiken für den Fall des Gewinns erweitert |
|
889 |
+* JavaScript-Schnittstelle um die Banner-Grafik im Falle eines Gewinns umzuschalten hinzugefügt |
|
890 |
+ |
|
891 |
+=== 1.7.1 === |
|
892 |
+ |
|
893 |
+* Funktionalität zum Bereitstellen der MetaDaten von Preisen für die Visualisierung innerhalb des Formulars (PreRender-Plugin) |
|
894 |
+* Preis-Gruppen für die Zusammenfassung der zu visualisierenden Preise |
|
895 |
+ |
| 842 |
842 |
=== 1.7.0 === |
| 843 |
843 |
|
| 844 |
844 |
* Funktionalität zur Pflegung von Löschfristen und Ausführung eines Quartz-Jobs zur Anwendung der gepflegten Löschfristen |
