Weiter: 1.8 Dokumentation der Funktion Hoch: 1. Dokumentation des Paketes Zurück: 1.6 Dokumentation der Funktion
OPT_C3SURF_VOUCHER='no'
Das Opt C3SURF_VOUCHER benutzen ('yes'), Standard ist 'no'. Es soll das Gutscheinsystem von C3SURF verwendet werden. Gutscheine sind anonyme aber sichere Einmal-Accounts, die zur Anmeldung verwendet werden können. Voraussetzung ist die Einstellung "OPT_LOGINUSR='yes'".
Die Erzeugung und Löschung der Gutscheine übernehmen zwei nächtliche cron JOBs, welche jederzeit auch manuell(Admin-Interface) gestartet werden können. Weiter unten erfährst Du, wie Du diese Jobs selbst einplanen oder komplett abschalten kannst. So kannst Du entscheiden, ob alles automatisch und zu welcher Zeit ablaufen soll oder ob Du es lieber manuell aus dem Admin-Interface des fli4l heraus erledigst.
Alle neu generierten Gutscheine werden an eine Druckliste angehängt. Nur in der Druckliste ist das zum Gutschein gehörende Kennwort im Klartext gespeichert. Du kannst diese Liste jederzeit Herunterladen, Drucken oder Löschen. Nach dem Löschen der Liste, kann das Kennwort nicht wieder ermittelt werden. Der normale Ablauf ist, zuerst die Liste drucken und dann die Liste löschen. Es liegt in Deiner Verantwortung dafür zu sorgen, dass es immer nur ein gedrucktes Exemplar eines Gutscheines gibt. Die implementierte Druckfunktion ist rudimentär in html implementiert. Es wird keine Rücksicht auf Seitenumbruch genommen. Ehrlich gesagt weiß ich nicht, ob es überhaupt möglich ist im html darauf zu reagieren, da es sich um eine Beschreibungssprache für Bildschirmpräsentation handelt. Da sind gute Vorschläge oder Ratschläge an mich willkommen. Die Gutscheine, die dem Seitenwechsel zum Opfer fallen, kannst Du ja einfach vernichten. Das Verfallsdatum eines Gutscheines erledigt dann ja irgendwann den Rest. Oder du lädst die Liste herunter und löscht sie dann. Mit der heruntergeladenen Liste könntest Du mittels Tabellenkalkulation oder Textverarbeitung (Serienbrief) ein eigenes schönes Layout erstellen, welches dann auch Seitenwechsel sauber berücksichtigt. Wenn Du da etwas schönes erstellt hast, schicke es mir an c3surf@arcor.de. Ich würde es dann in das nächste Paket, natürlich unter Deinem Namen, im source Ast veröffentlichen. Ich habe es noch nicht gemacht, da ich das Gutscheinsystem von C3SURF selbst nicht benötige.
C3SURF_VOUCHER_N='n'
Wertebereich: 0 und Natürliche Zahlen
Es wird angegeben, wie viele verschiedene Gutscheinkategorien erzeugt werden sollen. Wichtigstes Kriterium für Gutscheine ist die Zeit, die man damit angemeldet bleiben kann. Daneben gibt man noch die Anzahl der Gutscheine und deren Gültigkeit in Tagen an. Siehe auch die folgenden Variablen.
C3SURF_VOUCHER_x_TIME='30'
Wertebereich: Natürliche Zahlen
Beispiel: Gutscheine der Kategorie 'n' sind für 30 Minuten ausgelegt.
Hier gibst Du die Anzahl der Minuten für einen Gutschein dieser Kategorie ('n' siehe oben) an.
C3SURF_VOUCHER_x_COUNT='3'
Wertebereich: Natürliche Zahlen
Beispiel: Es werden insgesamt 3 Gutscheine für diese Zeitkategorie erzeugt.
Hier gibst Du an, wieviele Gutscheine dieser Kategorie erzeugt werden sollen.
C3SURF_VOUCHER_x_DAYS='90'
Wertebereich: 0 und Natürliche Zahlen
Beispiel: Diese Gutscheine sind 90 Tage nach der Erzeugung gültig.
Hier gibst Du an, wie viele Tage ein solcher Gutschein ab seiner Erzeugung gültig sein soll. Daraus erzeugt C3SURF bei der Generierung ein Verfallsdatum für diesen Gutschein. Entsprechende Jobs sorgen für die Löschung, oder du wählst die manuelle Variante. Ein Gutschein erlischt normalerweise früher, nämlich dann, wenn er das erste Mal verwendet wird.
Wichtig: "0" bedeutet, dass Gutscheine dieser Kategorie kein Verfallsdatum haben. Diese werden
erst mit Benutzung ungültig oder wenn die Zeit komplett verbraucht wurde (wird auch durch
C3SURF_VOUCHER_LIVES_n beeinflusst). Löschen kannst Du sie aber jederzeit im
Admin-Interface des fli4l.
C3SURF_VOUCHER_x_LIVES='n'
Wertebereich(n): -1, 0, Natürliche Zahlen
Angabe von Stunden, die der Voucher noch nach der ersten Anmeldung weiterlebt.
Sonderfälle:
Lebt bis zum ursprünglich generierten Verfallsdatum aus C3SURF_VOUCHER_DAYS weiter.
(Standard), bedeutet Voucher wird mit erster Anmeldung ungültig.
Anzahl der Stunden, die der Voucher weiterlebt nach erster Anmeldung - ggf. ein neues Verfallsdatum berechnen.
Diese Gutscheine werden nicht mit der ersten Anmeldung ungültig, sondern leben 'n' Stunden weiter. Sobald der Gutschein benutzt wird, wird daraus ein zeitlich limitierter LOGINUSR-Account generiert oder es wird das Verfallsdatum des Vouchers neu berechnet. Dieser Account / Voucher darf sich beliebig oft an und wieder abmelden. Es wird das von LOGIN_USR gewohnte Quota-System für diesen Account verwendet. Erst wenn die gesamte Zeit verbraucht ist oder wenn das Verfallsdatum (C3SURF_VOUCHER_DAYS_n) erreicht wurde, wird dieser Account automatisch von C3SURF gelöscht.
C3SURF_VOUCHER_DEL_CRON='0 4 * * *'
Wertebereich: 'cron-Syntax' oder 'never'
Der oben angegebene Wert ist der Standard, wenn diese Variable in der config-Datei 'c3surf.txt' fehlt. Standard: lösche täglich morgens um 4 Uhr alle verfallenen Guscheine.
Die cron-Syntax ist einzuhalten, wird nicht geprüft. Zusätzlich kann der Wert 'never' verwendet werden. Dann wird der Job vom System überhaupt nicht eingeplant. Du kannst im Admin-Interface jederzeit manuell alle verfallenen Gutscheine löschen lassen.
C3SURF_VOUCHER_GEN_CRON='15 4 * * *'
Wertebereich: 'cron-Syntax' oder 'never'
Der oben angegebene Wert ist der Standard, wenn diese Variable in der config-Datei 'c3surf.txt' fehlt. Standard: generiere täglich morgens um 4:15 Uhr neue Gutscheine, falls weniger als C3SURF_VOUCHER_COUNT vorhanden sind.
Die cron-Syntax ist einzuhalten, wird nicht geprüft. Zusätzlich kann der Wert 'never' verwendet werden.
Dann wird der Job vom System überhaupt nicht eingeplant. Du kannst im Admin-Interface jederzeit manuell
neue Gutscheine bis zur Menge
C3SURF_VOUCHER_x_COUNT erzeugen lassen.
Alle neu generierten Gutscheine werden an eine Druckliste angehängt. Nur in der Druckliste ist das zum Gutschein gehörende Kennwort im Klartext gespeichert. Sorge selbst dafür, dass jeder Gutschein nur einmal gedruckt wird, indem Du die Liste sofort nach dem Ausdruck oder Herunterladen löscht. Lasse Unbefugte nicht an die Liste herankommen.
Standard-Einstellung: C3SURF_VOUCHER_PRTUPDATE='no'
Wertebereich: 'yes' oder 'no'
Aktualisierung der Druckdatei. Meine Empfehlung: 'no'. Wer wenige Gutscheine im System hält und die Druckdatei nach dem Ausdruck oder Herunterladen nicht löschen möchte, der kann mit 'yes' eine Aktualisierung der Druckdatei beim Verbrauch von Gutscheinen einstellen. Bei der Wahl von 'yes' werden benutzte Gutscheine auch aus der Druckdatei gelöscht. Das benötigt Ressourcen auf dem Router.
Standard-Einstellung: C3SURF_VOUCHER_USRLEN='12'
Wertebereich: '1-16'
Zeichenlänge für Gutscheinaccount festlegen, ab 8 Zeichen werden '-' als Trenner eingebaut, die auch eingegeben werden müssen. Es werden immer vier Zeichen gruppiert. Der Maximalwert ist 16.
Standard-Einstellung: C3SURF_VOUCHER_USRCAP='random'
| - | 'yes' | : | nur Großbuchstaben |
| - | 'no' | : | nur Kleinbuchstaben |
| - | 'random' | : | zufällige Wechsel von Groß- Kleinschreibung (Empfehlung) |
Mit dieser Variable wird festgelegt ob Groß- oder Kleinbuchstaben im Benutzernamen verwendet werden sollen. Der Wert "random" (empfohlen) bewirkt eine zufällige Auswahl.
Standard-Einstellung: C3SURF_VOUCHER_PWDLEN='6'
Wertebereich: 1-12
Zeichenlänge für das Gutschein-Password.
Standard-Einstellung: C3SURF_VOUCHER_PWDMOD='3'
Wertebereich: 1-5
Modulo für zufällige Verlängerung des Passwortes. Max: 5 (die Werte 0, 1, 2, 3, 4), Min 1 (der Wert 0). Es wird bei der Password-Generierung das Password zufällig um die möglichen Werte verlängert. Damit ergeben sich per default Password-Längen zwischen 6 und 8. Maximal einstellbar sind Password-Längen zwischen 12 und 16, das ist sicher genug mit zufälliger Groß- und Kleinschreibung.
Standard-Einstellung: C3SURF_VOUCHER_PWDCAP='random'
| - | 'yes' | : | nur Großbuchstaben |
| - | 'no' | : | nur Kleinbuchstaben |
| - | 'random' | : | zufällige Wechsel von Groß- Kleinschreibung (Empfehlung) |
Mit dieser Variable wird festgelegt ob Groß- oder Kleinbuchstaben im Passwort verwendet werden sollen. Der Wert "random" (empfohlen) bewirkt eine zufällige Auswahl.