Scheduler-Commands

Die Adventskalender-Pro Erweiterung bietet aktuell drei Commands für den Scheduler - welche das sind, kannst Du im Folgenden nachlesen.

AdventskalenderPro Reminder: sendReminders

Dieser Scheduler verschickt die Erinnerungen für die Teilnahme am nächsten Adventskalender-Türchen. Diese Funktion ist aktuell nur für den Public-Mode verfügbar. Hierbei werden alle Teilnehmer des letzten Tages selektiert, welche den Reminder aktiviert und Deine E-Mailadresse bestätigt haben.

Der Scheduler kann wie folgt eingerichtet werden:

Class: Execute console commands (scheduler)
Schedulable Command: adventskalender_pro:sendparticipants: Sends reminders to participants via email.
Start: 02. Dezember 20xx, 0:05 Uhr
Ende:  25. Dezember 20xx, 12:00 Uhr
Frequenz: 60 Sekunden (jede Minute)
Parallele Ausführung: Nein

Der Scheduler wird in dieser Konfiguration jede Minute ausgeführt. Wenn eine Benutzer-Teilnahme länger als 24 Stunden her ist und der Teilnehmer den letzten Reminder aktiviert hatte, wird eine Erinnerung rausgeschickt.

Er verschickt dann standardmäßig 50 Erinnerungen pro Durchgang und wiederholt dies Prozess nach 1 Minute erneut. Die Menge der Erinnerungen kann aber als Parameter im Scheduler angepasst werden.

AdventskalenderPro Lottery: sendParticipants

Dieser Scheduler sendet nach einem Gewinnspiel-Tag die Teilnehmer im CSV-Format an eine im Gewinnspiel hinterlegte E-Mail-Adresse. Du kannst diesen verwenden, wenn Du lieber selbst die Gewinner des Tages ermitteln willst.

Der Scheduler sollte am 02. Dezember um 0:01 Uhr starten und am 25. Dezember um 12 Uhr Mittags enden. Er bekommt eine Frequenz von 86400 Sekunden (1 Tag). Das heißt, er wird das erste Mal in der Nacht vom ersten auf den zweiten Tag ausgeführt und verarbeitet die Teilnehmer. Das letzte Mal wird er in der Nacht vom 24. auf den 25. ausgeführt und ermittelt die letzten Teilnehmer bzw. Gewinner.

Class: Execute console commands (scheduler)
Schedulable Command: adventskalender_pro:sendparticipants: Sends reminders to participants via email.
Start: 02. Dezember 20xx, 0:01 Uhr
Ende:  25. Dezember 20xx, 12:00 Uhr
Frequenz: 86400 Sekunden (jeden Tag)
Parallele Ausführung: Nein

Jeder Adventskalender-Tag-Datensatz hat eine Checkbox Participants sent. Wenn der Scheduler die Teilnehmer dieses Tages versendet, setzt er diese Checkbox, so dass diese kein zweites Mal versendet werden.

Warnung:

Wenn Du bereits einen Testversand vorgenommen hast, vergiss nicht diesen Haken vor Gewinnspielstart wieder zu entfernen!

AdventskalenderPro Lottery: determineWinners

Dieser Scheduler ermittelt nach einem Gewinnspiel-Tag die Gewinner des Gewinnspiels. Dabei werden, sofern eine Gewinnspiel-Frage vorhanden ist, nur die richtig abgegebenen Antworten berücksichtigt.

Class: Execute console commands (scheduler)
Start: 02. Dezember 20xx, 0:05 Uhr
Ende:  25. Dezember 20xx, 12:00 Uhr
Frequenz: 86400 Sekunden (jeden Tag)
Parallele Ausführung: Nein

Jeder Adventskalender-Tag-Datensatz hat eine Checkbox Winners determined. Wenn der Scheduler die Gewinner dieses Tages ermittelt, setzt er diese Checkbox, so dass diese kein zweites Mal ermittelt werden. Wenn Du bereits eine Testermittlung vorgenommen, vergiss nicht diesen Haken vor Gewinnspielstart wieder zu entfernen!

Hinweis:

Auch wenn eine automatische Ziehung von Gewinnern hiermit möglich ist, empfehlen wir jedoch die Gewinner selbst zu ermitteln bzw. auszuwählen. Wenn mal an Tagen nicht so viele Teilnehmer teilnehmen, kann es vorkommen, dass der Zufallsgenerator zwei Mal den gleichen Gewinner zieht und das ist möglicherweise nicht gewünscht.

Allgemein

Alle Scheduler erstellen bei jeder Ausführung ein Log-File, indem sie die TYPO3-interne Logging-Funktion nutzen. Das Log-File wird unter "var/log" abgelegt, entweder unter "/typo3temp/" oder außerhalb des TYPO3 Document Root -Verzeichnisses, wenn composer verwendete wird (siehe https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/ApiOverview/Logging/Configuration/Index.html).

Das Log-File kann ebenfalls via E-Mail versandt werden - dies kann in den Einstellungen im Erweiterungsmanager aktiviert werden.

Die Scheduler werden auch ausgeführt, wenn Du Tage simulierst. Somit kannst Du den Versand von Remindern, Teilnehmern und die Ziehung der Gewinner simulieren.

Command auf der Shell ausführen

Die Commands können auch auf der Shell ausgeführt werden:

vendor/bin/typo3 adventskalender_pro:sendreminders
vendor/bin/typo3 adventskalender_pro:sendparticipants
vendor/bin/typo3 adventskalender_pro:determinewinners