| ... |
... |
@@ -259,17 +259,6 @@ |
| 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 |
| 262 |
|
- |
| 263 |
|
-{{figure image="header.png" clear="h2"}} |
| 264 |
|
-Seit Version 1.8.0 erweitere Varianten der //Bannergrafiken//. |
| 265 |
|
-{{/figure}} |
| 266 |
|
- |
| 267 |
|
-: 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. |
| 268 |
|
-:: **Desktop (1280px)** - ab 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 269 |
|
-:: **Tablet (960px)** - zwischen 960 px und 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 270 |
|
-:: **Mobile (600px)** - zwischen 600 px und 960 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 271 |
|
-:: **Mobile (320px)** - bei 600 px oder weniger Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 272 |
|
- |
| 273 |
273 |
: 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. |
| 274 |
274 |
|
| 275 |
275 |
: Die folgenden Schaltflächen dienen der Konfiguration der Bannergrafiken: |
| ... |
... |
@@ -382,9 +382,6 @@ |
| 382 |
382 |
; **Kategorie** |
| 383 |
383 |
: Frei definierbare Kategorisierung eines Gewinns. Wird in der Plugin-Aktion //Gewinn ermitteln// genutzt für eine möglichen Limitierung der Gewinnziehung auf eine Kategorie. |
| 384 |
384 |
|
| 385 |
|
-; **Gruppe** |
| 386 |
|
-: 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. |
| 387 |
|
-: |
| 388 |
388 |
; **Gewinncode** |
| 389 |
389 |
: Code des Gewinns, welcher im Gewinnspiel-Portal eingeben werden kann, um über die Plugin-Aktion //Gewinn ermitteln// einen Gewinner-Vorgang zuzuweisen. |
| 390 |
390 |
|
| ... |
... |
@@ -427,7 +427,7 @@ |
| 427 |
427 |
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. |
| 428 |
428 |
|
| 429 |
429 |
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. |
| 430 |
|
-Ü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. |
|
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. |
| 431 |
431 |
\\{{id name="backend_prize_import"/}} |
| 432 |
432 |
|
| 433 |
433 |
|
| ... |
... |
@@ -502,24 +502,11 @@ |
| 502 |
502 |
Vorhandene Schaltflächen unter //Bannergrafiken//. |
| 503 |
503 |
{{/figure}} |
| 504 |
504 |
|
| 505 |
|
- |
| 506 |
|
- |
| 507 |
507 |
; Bannergrafiken |
| 508 |
508 |
: 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: |
| 509 |
509 |
:: **Desktop** - ab 1026 px Bildschirmbreite; Muss konfiguriert werden |
| 510 |
510 |
:: **Tablet** - zwischen 642 px und 1025 px Bildschirmbreite |
| 511 |
511 |
:: **Mobile** - bei 641 px oder weniger Bildschirmbreite |
| 512 |
|
- |
| 513 |
|
-{{figure image="header.png" clear="h2"}} |
| 514 |
|
-Seit Version 1.8.0 erweitere Varianten der //Bannergrafiken//. |
| 515 |
|
-{{/figure}} |
| 516 |
|
- |
| 517 |
|
-: 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. |
| 518 |
|
-:: **Desktop (1280px)** - ab 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 519 |
|
-:: **Tablet (960px)** - zwischen 960 px und 1280 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 520 |
|
-:: **Mobile (600px)** - zwischen 600 px und 960 px Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 521 |
|
-:: **Mobile (320px)** - bei 600 px oder weniger Bildschirmbreite {{version major="1" minor="8"}}{{/version}} |
| 522 |
|
- |
| 523 |
523 |
: 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. |
| 524 |
524 |
|
| 525 |
525 |
: Die folgenden Schaltflächen dienen der Konfiguration der Bannergrafiken: |
| ... |
... |
@@ -586,54 +586,6 @@ |
| 586 |
586 |
|contest-portal.title.html|Titel der Gewinnspiel-Portalseite |
| 587 |
587 |
|expired-overlay.png|Overlay-Grafik welche über dem Gewinnspielbanner angezeigt wird sobald dieses abgelaufen ist |
| 588 |
588 |
|
| 589 |
|
-{{id name="config_quartz"/}} |
| 590 |
|
- |
| 591 |
|
-== Konfiguration des Quartz-Jobs {{version major="1" minor="7"}}{{/version}} == |
| 592 |
|
- |
| 593 |
|
-{{figure image="contest_quartz_config_de" clear="h2"}} |
| 594 |
|
-Konfiguration der Cron-Expression Property und Beschreibung des Quartz-Jobs |
| 595 |
|
-{{/figure}} |
| 596 |
|
- |
| 597 |
|
-Das automatisierte Löschen und die damit verbundene Überprüfung der [[Löschfristen>>doc:Formcycle.PluginDocumentation.ContestPortalPlugin.WebHome||anchor="deletions"]] aller Gewinnspiele wird durch einen Quartz-Job ermöglicht, welcher eine Cron-Expression benötigt, die angibt, wann dieser Job ausgeführt wird. Standardmäßig ist kein Quartz-Job mit Cron-Expression hinterlegt. |
| 598 |
|
- |
| 599 |
|
-; portal.contestent.deletion.cron |
| 600 |
|
-: Über die Plugin-Property //portal.contestent.deletion.cron// kann eine Cron-Expression angegeben werden, damit ein Job mit dieser Cron-Expression angelegt wird. Um die Erstellung einer Cron-Expression zu erleichtern kann beispielsweise das Online-Tool CronMaker verwendet werden: [[cronmaker.com>>url:http://cronmaker.com]]. In der Beschreibung des Portalplugins wird nach Speicherung der Plugin-Property noch einmal erfasst, ob der Quartz-Job angelegt werden konnte bzw. ob die Cron-Expression damit valide ist und wann der Job als Nächstes ausgeführt wird. |
| 601 |
|
- |
| 602 |
|
-== Plugin-Aktion: Gewinn ermitteln {{version major="1" minor="6"}}{{/version}} == |
| 603 |
|
- |
| 604 |
|
-{{figure image="aktion_prize_chance.png" clear="h2"}} |
| 605 |
|
-Nutzeroberfläche für Plugin-Aktion vom Typ //Gewinn ermitteln// |
| 606 |
|
-{{/figure}} |
| 607 |
|
- |
| 608 |
|
-Die Plugin-Aktion //Gewinn ermitteln// ermöglicht es, durch Eingabe eines Gewinncodes im Gewinnspiel-Formular oder durch eine konfigurierbare Wahrscheinlichkeit, Gewinne für eingegangene Vorgänge zu ermitteln. |
| 609 |
|
- |
| 610 |
|
-=== Parameter === |
| 611 |
|
- |
| 612 |
|
-==== Ziehmodus ==== |
| 613 |
|
- |
| 614 |
|
-; **Gewinncode** |
| 615 |
|
-: Beim Zieh-Modus Gewinncode muss über das Gewinnspiel-Formular ein Gewinncode eingegeben werden, wobei bei Übereinstimmung mit dem Gewinncode eines bestehenden Gewinns des Gewinnspiels dies am Gewinn vermerkt wird. Hierfür muss über das Textfeld //Gewinncodefeld// das zugehörige Eingabetextfeldelement des Formulars für den Gewinncode angegeben werden. |
| 616 |
|
- |
| 617 |
|
-; **Gewinnchance** |
| 618 |
|
-: Durch den Zieh-Modus //Gewinnchance// kann das Ziehen auf eine bestehende Kategorie der Gewinne beschränkt werden, durch das Auswahlmenü //Limitieren auf Kategorie//. |
| 619 |
|
-Die konfigurierbare Wahrscheinlichkeit wird über das Textfeld //Gewinnchance 1 zu// angegeben. Hierbei wird z.B. bei Eingabe einer 100 die Gewinnchance 1 zu 100 genutzt. |
| 620 |
|
-Falls ein Gewinner über die Gewinnchance ermittelt wird, wird in der ausgewählten limitierten Kategorie ebenfalls ein zufälliger Gewinn aus der Gewinnkategorie ausgewählt. |
| 621 |
|
- |
| 622 |
|
-=== Rückgabewert der Plugin-Aktion === |
| 623 |
|
- |
| 624 |
|
-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. |
| 625 |
|
- |
| 626 |
|
-**Über die folgenden Aktionsplatzhalter kann auf die zurückgegebenen Attribute der Plugin-Aktion in FORMCYCLE zugegriffen werden:** |
| 627 |
|
- |
| 628 |
|
-|=Rückgabewert|=Beschreibung |
| 629 |
|
-|[%$Aktionsname.SUCCESS%]|Aktion war erfolgreich und der abgeschickte Vorgang hat einen Gewinn gezogen. Dieser Wert kann true oder false sein |
| 630 |
|
-|[%$Aktionsname.RESULT[0].uuid%]|Eindeutige UUID des erhaltenen Gewinns |
| 631 |
|
-|[%$Aktionsname.RESULT[0].description%]|Beschreibung des erhaltenen Gewinns |
| 632 |
|
-|[%$Aktionsname.RESULT[0].category%]|Kategorie des erhaltenen Gewinns |
| 633 |
|
-|[%$Aktionsname.RESULT[0].process%]|Eindeutige UUID des Gewinner-Vorgangs |
| 634 |
|
-|[%$Aktionsname.RESULT[0].picture%]|Bild-URL des erhaltenen Gewinns |
| 635 |
|
-|[%$Aktionsname.RESULT[0].link%]|Gewinn-Link des erhaltenen Gewinns |
| 636 |
|
- |
| 637 |
637 |
== JavaScript-Schnittstellen == |
| 638 |
638 |
|
| 639 |
639 |
=== Allgemein === |
| ... |
... |
@@ -764,18 +764,7 @@ |
| 764 |
764 |
} |
| 765 |
765 |
{{/code}} |
| 766 |
766 |
|
| 767 |
|
-==== (% id="cke_bm_1486S" style="display:none" %) (%%)Umschalten der Einzeige eines Gewinnspiels in den Gewonnen-Status: {{version major="1" minor="8"}}{{/version}} ==== |
| 768 |
768 |
|
| 769 |
|
-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. |
| 770 |
|
- |
| 771 |
|
-{{code language="none"}} |
| 772 |
|
-// Snippet für eine HTML-Abschlussseite welches die Anzeige des aktuellen Gewinnspiels in den Gewonnen-Status schaltet. |
| 773 |
|
-// Funktioniert für die Bereitstellung als Micro-Site und innerhalb des Portals. |
| 774 |
|
-if (window.parent && window.parent.Contest) { |
| 775 |
|
- window.parent.Contest.markAsWon([%$PROJECT_ID%], window); |
| 776 |
|
-} |
| 777 |
|
-{{/code}} |
| 778 |
|
- |
| 779 |
779 |
=== Portal-spezifisch === |
| 780 |
780 |
|
| 781 |
781 |
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: |
| ... |
... |
@@ -877,25 +877,6 @@ |
| 877 |
877 |
|
| 878 |
878 |
== Versionshistorie == |
| 879 |
879 |
|
| 880 |
|
-=== 1.8.0 === |
| 881 |
|
- |
| 882 |
|
-* Funktionalität der Pflege Bannergrafiken um weitere responsive Stufe und spezielle Grafiken für den Fall des Gewinns erweitert |
| 883 |
|
-* JavaScript-Schnittstelle um die Banner-Grafik im Falle eines Gewinns umzuschalten hinzugefügt |
| 884 |
|
- |
| 885 |
|
-=== 1.7.1 === |
| 886 |
|
- |
| 887 |
|
-* Funktionalität zum Bereitstellen der MetaDaten von Preisen für die Visualisierung innerhalb des Formulars (PreRender-Plugin) |
| 888 |
|
-* Preis-Gruppen für die Zusammenfassung der zu visualisierenden Preise |
| 889 |
|
- |
| 890 |
|
-=== 1.7.0 === |
| 891 |
|
- |
| 892 |
|
-* Funktionalität zur Pflegung von Löschfristen und Ausführung eines Quartz-Jobs zur Anwendung der gepflegten Löschfristen |
| 893 |
|
- |
| 894 |
|
-=== 1.6.0 === |
| 895 |
|
- |
| 896 |
|
-* Funktionalität zur Pflegung von Gewinnen eines Gewinnspiels und Import von Gewinnen aus Excel-Dateien |
| 897 |
|
-* Aktion zur Ermittlung und Prüfung von Gewinnen anhand von Gewinncodes oder konfigurierbarer Wahrscheinlichkeit |
| 898 |
|
- |
| 899 |
899 |
=== 1.5.0 === |
| 900 |
900 |
|
| 901 |
901 |
* Funktionalität zum Exportieren der aktuellen Teilnehmer-Liste anhand der Porjekt-spezifischen Postfach-Ansicht |
