Änderungen von Dokument Gewinnspiel-Portal-Plugin

Von 5.1 nach 4.2

Von Version 4.2

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

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)
Anhänge (0 geändert, 0 hinzugefügt, 2 gelöscht)
- dialog_1_de.png
- dialog_2_de.png

Details

Seiteneigenschaften

Dokument-Autor

@@ -1,1 +1,1 @@
--XWiki.jdr
++XWiki.mko

Inhalt

@@ -10,7 +10,7 @@
  Beispiel für ein mit dem Plugin erstelltes Gewinnspiel-Portal.
  {{/figure}}
--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.
++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.
  == Installation ==
@@ -51,30 +51,6 @@
  ; Gewinnspiel-Formular bearbeiten
  : Berechtigung ein vorhandenes Gewinnspiel bearbeiten zu dürfen
--; Gewinner ermitteln {{version major="1" minor="4"}}{{/version}}
--: 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.
--
--; Teilnehmer exportieren {{version major="1" minor="5"}}{{/version}}
--: Berechtigung zum Exportieren der aktuellen Liste der Gewinnspiel-Teilnahmer
--
--; Ersatzgewinner ermitteln {{version major="1" minor="4"}}{{/version}}
--: Ermöglicht es, wiederholt Ersatzgewinner zu ermitteln.
--
--; Gewinne verwalten {{version major="1" minor="6"}}{{/version}}
--: Berechtigung, um neue Gewinne zu erstellen und vorhandene Gewinne bearbeiten und löschen zu dürfen.
--
--; Gewinnbild hochladen {{version major="1" minor="6"}}{{/version}}
--: Berechtigung das vorhandene Gewinnbild eines Gewinns hochladen zu dürfen.
--
--; Gewinnbild löschen {{version major="1" minor="6"}}{{/version}}
--: Berechtigung das vorhandene Gewinnbild eines Gewinns löschen zu dürfen.
--
--; Verknüpfung Gewinnervorgang aufheben {{version major="1" minor="6"}}{{/version}}
--: Berechtigung die vorhandene Verknüpfung eines Gewinnvorgangs am Gewinn aufheben zu dürfen.
--
--; Löschfristen verwalten {{version major="1" minor="7"}}{{/version}}
--: Berechtigung, um Löschfristen zu erstellen, zu bearbeiten oder löschen zu dürfen.
--
  ==== Vorlagen verwalten ====
  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.
@@ -93,6 +93,12 @@
  Zusätzliche Menüpunkte auf der {{formcycle/}} Verwaltungsoberfläche.
  {{/figure}}
++
++{{html wiki="true"}}
++<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>
++{{/html}}
++
++
  Durch die Konfiguration der entprechenden Rollenrechte erscheinen die folgenden neuen Menüeinträge auf der Verwaltungsoberfläche:
@@ -279,45 +279,10 @@
  ; **Formular bearbeiten**
  : Ö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.
--; **Gewinner ermitteln** {{version major="1" minor="4"}}{{/version}}
--: 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.
--
--; **Ersatzgewinner ermitteln** {{version major="1" minor="4"}}{{/version}}
--: 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.
--
--; **Teilnehmer exportieren** {{version major="1" minor="5"}}{{/version}}
--: 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.
--
  ; **Speichern**
  : Speichert die auf dieser Seite gemachten Einstellungen bzw. Änderungen an den Einstellungen.
  \\\\{{id name="backend_vorlagen"/}}
--=== Gewinner ermitteln {{version major="1" minor="4"}}{{/version}} ===
--
--Sobald der Teilnahmezeitraum abgelaufen ist oder ein Gewinnspiel deaktiviert wurde ist es mit den entsprechenden Berechtigungen möglich Gewinner zu ermitteln.
--
--{{figure image="dialog_1_de.png" clear="h2"}}
--Dialog zu Konfiguration der Gewinnerziehung.
--{{/figure}}
--
--==== Konfiguration ====
--
--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.
--
--{{figure image="dialog_2_de.png" clear="h2"}}
--Anzeige der ermittelten Gewinner
--{{/figure}}
--
--==== Asuwertung ====
--
--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.
--
--
--==== Gewinner nachziehen ====
--
--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.
--
--
  === Vorlagen verwalten ===
  {{figure image="vorlagen_ui_de.png" clear="h2"}}
@@ -452,11 +452,8 @@
  |contest-portal.css.txt|CSS-Code für das Gewinnspiel-Portal; Als txt-Datei hinterlegt, damit es nicht automatisch in alle Formulare eingebunden wird
  |contest-portal.footer.html|Inhalt des Fußbereiches der Gewinnspiel-Portalseite
  |contest-portal.header.html|Inhalt des Kopfbereiches der Gewinnspiel-Portalseite
--|contest-portal.js.txt|JavaScript der Gewinnspiel-Portalseite
--|contest-portal.meta.html|HTML header der Gewinnspiel-Portalseite
  |contest-portal.separator.html|Inhalt des Trenners in der Mitte auf der Gewinnspiel-Portalseite
--|contest-portal.title.html|Titel der Gewinnspiel-Portalseite
--|expired-overlay.png|Overlay-Grafik welche über dem Gewinnspielbanner angezeigt wird sobald dieses abgelaufen ist
++|contest-portal.title.html|Titel der Gewinnspiel-Portalseite~{~{/table}}
  == JavaScript-Schnittstellen ==
@@ -516,79 +516,6 @@
  {{/code}}
--==== Scrollen zum Formular: {{version major="1" minor="4"}}{{/version}} ====
--
--{{code language="none"}}
--// Innerhalb des Kontextes
--Contest.scrollToForm();
--
--// Innerhalb des Formulares
--// - falls dies in der selben Domaine betrieben wird
--window.parent.Contest.scrollToForm();
--
--// - falls dies nicht in der selben Domaine betrieben wird
--window.parent.postMessage('scrollToForm', '*');
--
--// Allgemein ansprechbar über postMessage:
--<window>.postMessage('scrollToForm', '*');
--
--{{/code}}
--
--==== Scrollen zum Anfang des Gewinnspiels: {{version major="1" minor="4"}}{{/version}} ====
--
--{{code language="none"}}
--// Innerhalb des Kontextes
--Contest.scrollToContestTop();
--
--// Innerhalb des Formulares
--// - falls dies in der selben Domaine betrieben wird
--window.parent.Contest.scrollToContestTop();
--
--// - falls dies nicht in der selben Domaine betrieben wird
--window.parent.postMessage('scrollToContestTop', '*');
--
--// Allgemein ansprechbar über postMessage:
--<window>.postMessage('scrollToContestTop', '*');
--
--{{/code}}
--
--==== Scrollen zum Anfang des Inhaltbereichs: {{version major="1" minor="4"}}{{/version}} ====
--
--{{code language="none"}}
--// Innerhalb des Kontextes
--Contest.scrollToContent();
--
--// Innerhalb des Formulares
--// - falls dies in der selben Domaine betrieben wird
--window.parent.Contest.scrollToContent();
--
--// - falls dies nicht in der selben Domaine betrieben wird
--window.parent.postMessage('scrollToContent', '*');
--
--// Allgemein ansprechbar über postMessage:
--<window>.postMessage('scrollToContent', '*');
--
--{{/code}}
--
--==== Berechnung eines Scroll-Offsets: {{version major="1" minor="5"}}{{/version}} ====
--
--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.
--
--{{code language="none"}}
--// Liefert standardmäßig 0 zurück
--Contest.calcScrollOffset();
--
--// Reduktion des Scroll-Offsets um 60 Pixel innerhalb einer mobilen Ansicht (Breite kleiner 960px).
--Contest.calcScrollOffset = function(){
--    if(window.matchMedia('(min-width: 960px)').matches){
--        return 0;
--    }else{
--        return -60;
--    }
--}
--{{/code}}
--
--
  === Portal-spezifisch ===
  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:
@@ -690,17 +690,7 @@
  == Versionshistorie ==
--=== 1.5.0 ===
--
--* Funktionalität zum Exportieren der aktuellen Teilnehmer-Liste anhand der Porjekt-spezifischen Postfach-Ansicht
--* JavaScript-Schnittstelle zum Anpassen der Scroll-Offsets
--
--=== 1.4.0 ===
--
--* Funktionalität zum Ermitteln von Gewinnern und deren Excel-Export
--* Erweiterung der scrollTo-Funktionen
--* Kleinere CSS-Anpassungen
--
++(% class="wikigeneratedid" %)
  === 1.3.4 ===
  * 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