Unterabschnitte

1.7 Konfiguration von OPT_VOUCHER

OPT_C3SURF_VOUCHER

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

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

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

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

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.

1.7.1 Optionale Parameter OPT_VOUCHER

C3SURF_VOUCHER_x_LIVES

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:


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

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

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.

C3SURF_VOUCHER_PRTUPDATE

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.

C3SURF_VOUCHER_USRLEN

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.

C3SURF_VOUCHER_USRCAP

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.

C3SURF_VOUCHER_PWDLEN

Standard-Einstellung: C3SURF_VOUCHER_PWDLEN='6'

Wertebereich: 1-12

Zeichenlänge für das Gutschein-Password.

C3SURF_VOUCHER_PWDMOD

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.

C3SURF_VOUCHER_PWDCAP

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.

© 2001-2012 Das fli4l-Team - 16. September 2012