Änderungen von Dokument Gewinnspiel-Portal-Plugin


Von Version 3.1
bearbeitet von MKO
am 29.03.2021, 21:07
Änderungskommentar: Imported from XAR
Auf Version 1.1
bearbeitet von MKO
am 20.01.2021, 16:20
Änderungskommentar: Imported from XAR

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -10,7 +10,7 @@
10 10  Beispiel für ein mit dem Plugin erstelltes Gewinnspiel-Portal.
11 11  {{/figure}}
12 12  
13 -Das kostenpflichtige 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.
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 14  
15 15  == Installation ==
16 16  
... ... @@ -51,15 +51,6 @@
51 51  ; Gewinnspiel-Formular bearbeiten
52 52  : Berechtigung ein vorhandenes Gewinnspiel bearbeiten zu dürfen
53 53  
54 -; Gewinner ermitteln {{version major="1" minor="4"}}{{/version}}
55 -: Berechtigung um nach Ablauf des Gewinnspiels Gewinner zu ermitteln, diese ggf. inkl Verarbeitung in einen anderen Status zu verschieben und anschließend per Excel zu explorieten.
56 -
57 -; Teilnehmer exportieren {{version major="1" minor="5"}}{{/version}}
58 -: Berechtigung zum Exportieren der aktuellen Liste der Gewinnspiel-Teilnahmer
59 -
60 -; Ersatzgewinner ermitteln {{version major="1" minor="4"}}{{/version}}
61 -: Ermöglicht es wiederholt Ersatzgewinner zu ermitteln.
62 -
63 63  ==== Vorlagen verwalten ====
64 64  
65 65  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.
... ... @@ -270,45 +270,10 @@
270 270  ; **Formular bearbeiten**
271 271  : Ö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.
272 272  
273 -; **Gewinner ermitteln** {{version major="1" minor="4"}}{{/version}}
274 -: Diese Schaltfläche ist bei entsprechender Berechtigung erst verfügbar sobald das Gewinnspiel offline geschalten wurde oder der Teilnahme-Zeitraum abgelaufen ist. Ferner ist er auch nicht mehr verfügbar sobald eine Gewinnerziehung durchgeführt wurde. Er öffnet den Dialog zu Konfiguration und zum Starten der Gewinnerziehung.
275 -
276 -; **Ersatzgewinner ermitteln** {{version major="1" minor="4"}}{{/version}}
277 -: Diese Schaltfläche ist bei entsprechender Berechtigung erst verfügbar sobald das Gewinnspiel offline geschalten wurde oder der Teilnahme-Zeitraum abgelaufen ist sowie bereits eine Gewinnerziehung stattgefunden hat. Er öffnet den Dialog zu Konfiguration und zum Starten der Nachziehung von Gewinnern.
278 -
279 -; **Teilnehmer exportieren** {{version major="1" minor="5"}}{{/version}}
280 -: Diese Schaltfläche ist bei entsprechender Berechtigung nur verfügbar wenn zum ausgewählten Gewinnspiel eine Projekt-spezifische Postfach-Ansicht definiert wurde. Beim Betätigen dieser Schaltfläche wird ein EXCEL-Export angesoßen welcher die dort definierten Formular-Felder inkl. aller Metadaten-Felder exportiert. Je nach Anzahl der Teilnehmer kann dieser Export mehrere Sekunden lang dauern.
281 -
282 282  ; **Speichern**
283 283  : Speichert die auf dieser Seite gemachten Einstellungen bzw. Änderungen an den Einstellungen.
284 284  \\\\{{id name="backend_vorlagen"/}}
285 285  
286 -=== Gewinner ermitteln {{version major="1" minor="4"}}{{/version}} ===
287 -
288 -Sobald der Teilnahmezeitraum abgelaufen ist oder ein Gewinnspiel deaktiviert wurde ist es mit den entsprechenden Berechtigungen möglich Gewinner zu ermitteln.
289 -
290 -{{figure image="dialog_1_de.png" clear="h2"}}
291 -Dialog zu Konfiguration der Gewinnerziehung.
292 -{{/figure}}
293 -
294 -==== Konfiguration ====
295 -
296 -Startet man über die entsprechenden Schaltflächen die Ermittlung der Gewinner eines Gewinnspiels, so öffnet sich hierbei ein Konfigurationdialog. In diesem wird angegeben aus welchem Status die Teilnehmer-Datensätze herangezogen werden, sowie die Anzahl der eigentlichen Gewinner in ihren Ausprägungen. Hierbei wird unterschieden zwischen Hauptgewinnern, Nebengewinnern und zusätzlichen Ersatzgewinnern. Die Datensätze die für die jeweilige Ausprägung gezogen weden, werden anschließen je nach Auswahl mit oder ohne ausgeführter Statusverarbeitgung in den zugehörigen Zielstatus überführt.
297 -
298 -{{figure image="dialog_2_de.png" clear="h2"}}
299 -Anzeige der ermittelten Gewinner
300 -{{/figure}}
301 -
302 -==== Asuwertung ====
303 -
304 -Nach der Ziehung wird eine Übersicht mit den ermittelten Gewinnern angezeigt. Hierbei werden je nach Verfügbarkeit Spalten der Projekt-spezifischen Postfach-Ansicht oder der Betreff inkl. von Standard-Spalten angezeigt. Ferner sind die Spalten über die zugehörige Auswahl anpassbar. Über die Schlatfläche "Export" steht zusätzlich diese Tabelle mit allen vorhandenen Spalten als Excel-Datei zur Verfügung. Ferner kann über "Export" > "... mit kompletten Datensätzen" das Excel auch um alle im Formular vorhandenen Eingabedaten erweitert werden.
305 -
306 -
307 -==== Gewinner nachziehen ====
308 -
309 -Nach einer initial durchgeführen Gewinnerziehung steht diese Option nicht mehr zur Verfügung. Ferner gibt es mit der entsprechenden Berechtigung die Möglichkeit weitere Ersatzgewinner zu ermitteln. Hierbei kommt der selbe Dialog zum Einsatz, jedoch ist nur die Konfiguration der Ersatzgewinner verfügbar.
310 -
311 -
312 312  === Vorlagen verwalten ===
313 313  
314 314  {{figure image="vorlagen_ui_de.png" clear="h2"}}
... ... @@ -443,11 +443,8 @@
443 443  |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
444 444  |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
445 445  |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
446 -|contest-portal.js.txt|JavaScript der Gewinnspiel-Portalseite
447 -|contest-portal.meta.html|HTML header der Gewinnspiel-Portalseite
448 448  |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
449 -|contest-portal.title.html|Titel der Gewinnspiel-Portalseite
450 -|expired-overlay.png|Overlay-Grafik welche über dem Gewinnspielbanner angezeigt wird sobald dieses abgelaufen ist
403 +|contest-portal.title.html|Titel der Gewinnspiel-Portalseite~{~{/table}}
451 451  
452 452  == JavaScript-Schnittstellen ==
453 453  
... ... @@ -507,79 +507,6 @@
507 507  
508 508  {{/code}}
509 509  
510 -==== Scrollen zum Formular: {{version major="1" minor="4"}}{{/version}} ====
511 -
512 -{{code language="none"}}
513 -// Innerhalb des Kontextes
514 -Contest.scrollToForm();
515 -
516 -// Innerhalb des Formulares
517 -// - falls dies in der selben Domaine betrieben wird
518 -window.parent.Contest.scrollToForm();
519 -
520 -// - falls dies nicht in der selben Domaine betrieben wird
521 -window.parent.postMessage('scrollToForm', '*');
522 -
523 -// Allgemein ansprechbar über postMessage:
524 -<window>.postMessage('scrollToForm', '*');
525 -
526 -{{/code}}
527 -
528 -==== Scrollen zum Anfang des Gewinnspiels: {{version major="1" minor="4"}}{{/version}} ====
529 -
530 -{{code language="none"}}
531 -// Innerhalb des Kontextes
532 -Contest.scrollToContestTop();
533 -
534 -// Innerhalb des Formulares
535 -// - falls dies in der selben Domaine betrieben wird
536 -window.parent.Contest.scrollToContestTop();
537 -
538 -// - falls dies nicht in der selben Domaine betrieben wird
539 -window.parent.postMessage('scrollToContestTop', '*');
540 -
541 -// Allgemein ansprechbar über postMessage:
542 -<window>.postMessage('scrollToContestTop', '*');
543 -
544 -{{/code}}
545 -
546 -==== Scrollen zum Anfang des Inhaltbereichs: {{version major="1" minor="4"}}{{/version}} ====
547 -
548 -{{code language="none"}}
549 -// Innerhalb des Kontextes
550 -Contest.scrollToContent();
551 -
552 -// Innerhalb des Formulares
553 -// - falls dies in der selben Domaine betrieben wird
554 -window.parent.Contest.scrollToContent();
555 -
556 -// - falls dies nicht in der selben Domaine betrieben wird
557 -window.parent.postMessage('scrollToContent', '*');
558 -
559 -// Allgemein ansprechbar über postMessage:
560 -<window>.postMessage('scrollToContent', '*');
561 -
562 -{{/code}}
563 -
564 -==== Berechnung eines Scroll-Offsets: {{version major="1" minor="5"}}{{/version}} ====
565 -
566 -Mit der Funktion Contest.calcScrollOffset() steht eine überschreibbare Schnittstelle zur Verfügung, welche innerhalb der Scroll-Funktionen (außer scrollToTop()) gerufen wird um den berechneten Offset anzupassen. So ist es z.B. ggf. nötig bei mobilen Ansichten absolut positionierte Header in diesem mit zu berücksichtigen. Der zurückgegebene Wert wird zum Offset addiert. Die Überlagerung kann innerhalb des Portal-JavaScripts oder innerhalb einer einbettenden Seite stattfinden.
567 -
568 -{{code language="none"}}
569 -// Liefert standardmäßig 0 zurück
570 -Contest.calcScrollOffset();
571 -
572 -// Reduktion des Scroll-Offsets um 60 Pixel innerhalb einer mobilen Ansicht (Breite kleiner 960px).
573 -Contest.calcScrollOffset = function(){
574 - if(window.matchMedia('(min-width: 960px)').matches){
575 - return 0;
576 - }else{
577 - return -60;
578 - }
579 -}
580 -{{/code}}
581 -
582 -
583 583  === Portal-spezifisch ===
584 584  
585 585  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:
... ... @@ -681,17 +681,7 @@
681 681  
682 682  == Versionshistorie ==
683 683  
684 -=== 1.5.0 ===
685 -
686 -* Funktionalität zum Exportieren der aktuellen Teilnehmer-Liste anhand der Porjekt-spezifischen Postfach-Ansicht
687 -* JavaScript-Schnittstelle zum Anpassen der Scroll-Offsets
688 -
689 -=== 1.4.0 ===
690 -
691 -* Funktionalität zum Ermitteln von Gewinnern und deren Excel-Export
692 -* Erweiterung der scrollTo-Funktionen
693 -* Kleinere CSS-Anpassungen
694 -
564 +(% class="wikigeneratedid" %)
695 695  === 1.3.4 ===
696 696  
697 697  * CSS-Anpassung um einen Layout-Unterschied zwischen Microsmite und Portal-Einbeung zu entfernen
dialog_1_de.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.mko
Größe
... ... @@ -1,1 +1,0 @@
1 -47.8 KB
Inhalt
dialog_2_de.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.mko
Größe
... ... @@ -1,1 +1,0 @@
1 -49.7 KB
Inhalt