Änderungen von Dokument Gewinnspiel-Portal-Plugin


Von Version 4.1
bearbeitet von jdr
am 16.11.2021, 08:55
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 1.1
bearbeitet von MKO
am 20.01.2021, 16:20
Änderungskommentar: Imported from XAR

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.jdr
1 +XWiki.mko
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,30 +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 -; Gewinne verwalten {{version major="1" minor="6"}}{{/version}}
64 -: Berechtigung, um neue Gewinne zu erstellen und vorhandene Gewinne bearbeiten und löschen zu dürfen.
65 -
66 -; Gewinnbild hochladen {{version major="1" minor="6"}}{{/version}}
67 -: Berechtigung das vorhandene Gewinnbild eines Gewinns hochladen zu dürfen.
68 -
69 -; Gewinnbild löschen {{version major="1" minor="6"}}{{/version}}
70 -: Berechtigung das vorhandene Gewinnbild eines Gewinns löschen zu dürfen.
71 -
72 -; Verknüpfung Gewinnervorgang aufheben {{version major="1" minor="6"}}{{/version}}
73 -: Berechtigung die vorhandene Verknüpfung eines Gewinnvorgangs am Gewinn aufheben zu dürfen.
74 -
75 -; Löschfristen verwalten {{version major="1" minor="7"}}{{/version}}
76 -: Berechtigung, um Löschfristen zu erstellen, zu bearbeiten oder löschen zu dürfen.
77 -
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.
... ... @@ -285,45 +285,10 @@
285 285  ; **Formular bearbeiten**
286 286  : Ö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.
287 287  
288 -; **Gewinner ermitteln** {{version major="1" minor="4"}}{{/version}}
289 -: 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.
290 -
291 -; **Ersatzgewinner ermitteln** {{version major="1" minor="4"}}{{/version}}
292 -: 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.
293 -
294 -; **Teilnehmer exportieren** {{version major="1" minor="5"}}{{/version}}
295 -: 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.
296 -
297 297  ; **Speichern**
298 298  : Speichert die auf dieser Seite gemachten Einstellungen bzw. Änderungen an den Einstellungen.
299 299  \\\\{{id name="backend_vorlagen"/}}
300 300  
301 -=== Gewinner ermitteln {{version major="1" minor="4"}}{{/version}} ===
302 -
303 -Sobald der Teilnahmezeitraum abgelaufen ist oder ein Gewinnspiel deaktiviert wurde ist es mit den entsprechenden Berechtigungen möglich Gewinner zu ermitteln.
304 -
305 -{{figure image="dialog_1_de.png" clear="h2"}}
306 -Dialog zu Konfiguration der Gewinnerziehung.
307 -{{/figure}}
308 -
309 -==== Konfiguration ====
310 -
311 -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.
312 -
313 -{{figure image="dialog_2_de.png" clear="h2"}}
314 -Anzeige der ermittelten Gewinner
315 -{{/figure}}
316 -
317 -==== Asuwertung ====
318 -
319 -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.
320 -
321 -
322 -==== Gewinner nachziehen ====
323 -
324 -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.
325 -
326 -
327 327  === Vorlagen verwalten ===
328 328  
329 329  {{figure image="vorlagen_ui_de.png" clear="h2"}}
... ... @@ -458,11 +458,8 @@
458 458  |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
459 459  |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
460 460  |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
461 -|contest-portal.js.txt|JavaScript der Gewinnspiel-Portalseite
462 -|contest-portal.meta.html|HTML header der Gewinnspiel-Portalseite
463 463  |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
464 -|contest-portal.title.html|Titel der Gewinnspiel-Portalseite
465 -|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}}
466 466  
467 467  == JavaScript-Schnittstellen ==
468 468  
... ... @@ -522,79 +522,6 @@
522 522  
523 523  {{/code}}
524 524  
525 -==== Scrollen zum Formular: {{version major="1" minor="4"}}{{/version}} ====
526 -
527 -{{code language="none"}}
528 -// Innerhalb des Kontextes
529 -Contest.scrollToForm();
530 -
531 -// Innerhalb des Formulares
532 -// - falls dies in der selben Domaine betrieben wird
533 -window.parent.Contest.scrollToForm();
534 -
535 -// - falls dies nicht in der selben Domaine betrieben wird
536 -window.parent.postMessage('scrollToForm', '*');
537 -
538 -// Allgemein ansprechbar über postMessage:
539 -<window>.postMessage('scrollToForm', '*');
540 -
541 -{{/code}}
542 -
543 -==== Scrollen zum Anfang des Gewinnspiels: {{version major="1" minor="4"}}{{/version}} ====
544 -
545 -{{code language="none"}}
546 -// Innerhalb des Kontextes
547 -Contest.scrollToContestTop();
548 -
549 -// Innerhalb des Formulares
550 -// - falls dies in der selben Domaine betrieben wird
551 -window.parent.Contest.scrollToContestTop();
552 -
553 -// - falls dies nicht in der selben Domaine betrieben wird
554 -window.parent.postMessage('scrollToContestTop', '*');
555 -
556 -// Allgemein ansprechbar über postMessage:
557 -<window>.postMessage('scrollToContestTop', '*');
558 -
559 -{{/code}}
560 -
561 -==== Scrollen zum Anfang des Inhaltbereichs: {{version major="1" minor="4"}}{{/version}} ====
562 -
563 -{{code language="none"}}
564 -// Innerhalb des Kontextes
565 -Contest.scrollToContent();
566 -
567 -// Innerhalb des Formulares
568 -// - falls dies in der selben Domaine betrieben wird
569 -window.parent.Contest.scrollToContent();
570 -
571 -// - falls dies nicht in der selben Domaine betrieben wird
572 -window.parent.postMessage('scrollToContent', '*');
573 -
574 -// Allgemein ansprechbar über postMessage:
575 -<window>.postMessage('scrollToContent', '*');
576 -
577 -{{/code}}
578 -
579 -==== Berechnung eines Scroll-Offsets: {{version major="1" minor="5"}}{{/version}} ====
580 -
581 -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.
582 -
583 -{{code language="none"}}
584 -// Liefert standardmäßig 0 zurück
585 -Contest.calcScrollOffset();
586 -
587 -// Reduktion des Scroll-Offsets um 60 Pixel innerhalb einer mobilen Ansicht (Breite kleiner 960px).
588 -Contest.calcScrollOffset = function(){
589 - if(window.matchMedia('(min-width: 960px)').matches){
590 - return 0;
591 - }else{
592 - return -60;
593 - }
594 -}
595 -{{/code}}
596 -
597 -
598 598  === Portal-spezifisch ===
599 599  
600 600  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:
... ... @@ -696,17 +696,7 @@
696 696  
697 697  == Versionshistorie ==
698 698  
699 -=== 1.5.0 ===
700 -
701 -* Funktionalität zum Exportieren der aktuellen Teilnehmer-Liste anhand der Porjekt-spezifischen Postfach-Ansicht
702 -* JavaScript-Schnittstelle zum Anpassen der Scroll-Offsets
703 -
704 -=== 1.4.0 ===
705 -
706 -* Funktionalität zum Ermitteln von Gewinnern und deren Excel-Export
707 -* Erweiterung der scrollTo-Funktionen
708 -* Kleinere CSS-Anpassungen
709 -
564 +(% class="wikigeneratedid" %)
710 710  === 1.3.4 ===
711 711  
712 712  * 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