Die Templateprogrammierung basiert auf den Datenfeldern, die Sie mit Hilfe des Datenbank-Designers angelegt haben. Die Datenfelder beinhalten Informationen zur Gestaltung (Darstellungsart) und zum Inhalt der einzelnen Felder. Die Namen der einzelnen Datenfelder Ihrer Abonnentendatenbank (wie z. B. ANREDE, NAME, BERUF etc.) werden Feldnamen genannt. Diese werden mit Hilfe BACKCLICK-spezifischer TAGs in die Templates integriert. Die Feldnamen werden immer in GROSSBUCHSTABEN geschrieben. Die Angaben, die während des An- oder Abmeldevorganges von den jeweiligen Abonnenten gemacht wurden, werden automatisch in die Abonnentendatenbank übernommen. Wie Sie die Datenfelder anlegen, entnehmen Sie bitte dem Kapitel Systemadministration -> Datenbank-Designer.
Sie können innerhalb der Templateprogrammierung auf alle vordefinierten Datenfelder zurückgreifen. Alle Fehler- und Erfolgsmeldungen, die während des Anmeldevorganges von BACKCLICK ausgegeben werden, sind in diesem Template als HTML-Code hinterlegt und werden nur in dem entsprechenden Fehler- oder Erfolgsfall angezeigt.
HINWEIS: Alle Meldungen müssen vorher bereits im Template definiert worden sein.
Im diesem Kapitel wird beschrieben, wie Sie die vorher definierten Eingabefelder in Ihr Template einfügen. Aufgrund des besseren Verständnisses wird jetzt anhand eines Beispiels die Templateerstellung für die Anmeldung erklärt. Um Ihnen die Templateprogrammierung zu erleichtern, werden parallel zu der Erläuterung der TAGs, Auszüge aus dem Quellcode des Beispieltemplates, angezeigt.
Das unten abgebildete Beispieltemplate liegt in der WebInterface Templateverwaltung unter der ID 1 vor und sieht wie folgt aus:
Abb. 8.4.1 - Webinterface Templates (Beispiel ID 1)
Vorbereitung des Templates
Voraussetzung für die Erstellung eines Templates ist eine nach Ihren Wünschen gestaltete HTML-Seite, in die Sie mit Hilfe der BACKCLICK-spezifischen TAGs die Eingabefelder für die Abonnentendaten einfügen.
Wenn Sie im <HEAD>-</HEAD>-TAG in Ihr Template folgendes einfügen, wird der Abonnent automatisch nach erfolgreicher Anmeldung auf die URL zurückgeführt, die Sie angegeben haben (siehe Templateverlinkung). Die Zahl "10" entspricht dabei der Anzahl an Sekunden, die verstreichen, bevor wieder zur Ausgangsseite "zurückgesprungen" wird. Dieser TAG ist optional.
Beispiel:
<!--REFRESH:10-->
Innerhalb des HTML-Templates fügen Sie nun ein Formfeld ein, in dem alle nötigen Variablen gespeichert werden. Alle, für das System wichtigen, Angaben, wie einleitende Sätze, Fehlermeldungen, Erfolgsmeldungen und natürlich auch Angaben für die Eingabefelder, müssen innerhalb dieser <form>-</form>-TAGs stehen. Um dieses Formfeld zu erstellen, fügen Sie an gewünschter Stelle im HTML-Quellcode folgendes ein:
Form-Feld Einleitung:
<FORM method="post" action="web.subscribe?tid=1" name="new_reader"></FORM>
HTML-Code-Ausschnitt aus dem Beispieltemplate:
Nachdem Sie den <form>-TAG eingefügt haben, folgen nun die Angaben für einleitende Sätze, Fehler- und Erfolgsmeldungen.
Einleitende Sätze einfügen
Die einleitenden Sätze werden nur beim ersten Aufruf der Anmeldemaske angezeigt und zur Begrüßung potentieller Abonnenten verwendet. Bei späteren Fehlermeldungen und Bestätigungen erscheinen sie nicht mehr. Um die einleitenden Sätze zu kennzeichnen, wird folgendes eingegeben:
An welcher Stelle und wie oft die Einträge erscheinen, bestimmen Sie selbst. Zwischen den TAGs kann ein beliebiger HTML-Code verwendet werden.
Fehlermeldungen
BACKCLICK kann bei falschen Angaben, nicht ausgefüllten Eingabefeldern oder Systemfehlern eine von Ihnen festgelegte Fehlermeldung ausgeben. Ob das Ausfüllen von Eingabefeldern optional oder obligatorisch ist, legen Sie beim Anlegen der Datenfelder fest. Um Abonnenten bestimmte Fehlermeldungen auszugeben, müssen Sie folgende TAGs in die HTML-Seite einfügen. Wenn sich ein Abonnent für einen bereits abonnierten Newsletter anmelden möchte, können Sie folgenden <ERROR>-TAG in Ihr Template einfügen:
Die Nummer der Verteilerlisten ID wird Ihnen im Menü Newsletter-Verwaltung -> Newsletter-Übersicht angezeigt.
Sie sollten für alle Verteilerlisten, die Sie in Ihrem System angelegt haben, eine Fehlermeldung im Template vorsehen. Text und Aussehen der Fehlermeldung kann definiert werden.
Fehlermeldungen, die bei der Überprüfung der Eingabefelder entstehen
Das System kann jedes Eingabefeld darauf prüfen, ob es ausgefüllt wurde oder nicht, wenn die Angaben Menüpunkt Systemadministration -> Datenbank-Designer dementsprechend konfiguriert sind. Bei dem Eingabefeld für die Email-Adresse wird eine Plausibilitätsprüfung vorgenommen. Es wird auf syntaktische Vollständigkeit und RFC-Konformität geprüft. Ob diese Email-Adresse dann wirklich eine valide Email-Adresse darstellt, wird zu diesem Zeitpunkt nicht überprüft. Um bei einer falschen Eingabe der Email-Adresse eine Fehlermeldung zu erhalten, fügen Sie folgenden TAG in die HTML-Seite ein:
In diesem Beispiel sehen Sie, was passiert, wenn eine fehlerhafte Email-Adresse angegeben wird. In diesem Fall sorgt der Code <?GIS name="EMAIL" content= "form"?> dafür, dass die bereits eingegebene, falsche Email-Adresse mit ausgegeben wird.
Wenn ein Eingabefeld, das als Pflichtfeld deklariert ist, nicht ausgefüllt wurde, können Sie die Abonnenten mit den folgenden <ERROR>-TAGs darauf hinweisen.
Einen allgemeinen Konfigurationsfehler können Sie sich folgendermaßen ausgeben lassen:
Wenn Sie diese Fehlermeldung sehen, haben Sie einen Fehler gemacht und sollten Ihr Template sowie die Angaben über die Datenfelder der Abonnentendatenbank noch einmal überprüfen. Überprüfen Sie auch die Konfiguration der verwendeten Newsletter.
Beispiel Feld Newsletter:
Beispiel Feld Nachname:
Beispiel Vorname:
Das System kann die Eingabefelder für die Postleitzahl oder das Alter daraufhin prüfen, ob der Abonnent Zahlen angegeben hat. Genau wie alle anderen feldspezifischen Eigenschaften legen Sie diese Funktion beim Anlegen der Datenfelder mit Hilfe des Datenbank-Designers fest.
Erfolgsmeldungen
Die erfolgreiche Anmeldung können Sie dem Abonnenten bestätigen, indem Sie innerhalb des Templates den <SUCCESS>-</SUCCESS>-TAG einfügen. Es ist empfehlenswert, eine Erfolgsmeldung für jede im System bestehende Verteilerliste anzugeben. Erst wenn der Abonnent alle geforderten Eingabefelder mit gültigen Werten ausgefüllt hat, wird eine Erfolgsmeldung angezeigt. Erfolgsmeldungen werden folgendermaßen realisiert:
Oben sehen Sie eine allgemeine Erfolgsmeldung. Sie haben aber auch die Möglichkeit, für jede einzelne Verteilerliste eine gesonderte Meldung auszugeben. Geben Sie bitte dazu die laufende Nummer (ID) der Verteilerliste durch "-" getrennt an.
Beispiel Verteilerliste 1:
spezielle Erfolgsmeldung:
Das Einfügen der Eingabefelder
Nachfolgend wird das Einfügen der BACKCLICK-SpezialTAGs für die Eingabefelder, die der Abonnent während seiner Anmeldung ausfüllen kann/muss, beschrieben. Da Sie bereits alle Angaben zur Darstellungsart, zum Inhalt und zur Prüfung der Felder gemacht haben, fügen Sie in Ihr Template nur noch kurze <?GIS FELDNAME?>-TAGs in den HTML-Code ein. Weitere Erklärungen dazu können Sie im Kapitel zum Datenbank-Designer nachlesen.
Beginn des Einfügens von Eingabefeldern:
<!--NEW-USER-->
Nach dem letzten Eingabefeld müssen Sie abschließend folgendes eingeben:
Ende des Einfügens von Eingabefeldern:
<!--/NEW-USER-->
Zwischen diesen beiden TAGs können Sie beliebigen HTML-Code verwenden. Nachfolgend werden die einzelnen TAGs zur Darstellung der Eingabefelder im Template aufgezeigt. Die Reihenfolge hierbei ist beliebig.
Beispiel für das Eingabefeld 'Email':
<?GIS EMAIL?>
Sie können aber auch die Werte, die im Datenbankdesigner als Standardwerte vorgegeben sind, für jedes Template und jedes Eingabefeld individuell bestimmen, indem Sie die HTML-Parameter in den BACKCLICK-SpezialTAG einfügen. Hier soll das Email-Eingabefeld 50 Zeichen breit dargestellt werden.
Beispiel für ein individuelles Eingabefeld Email:
<?GIS EMAIL params="size=50"?>
<?GIS EMAIL params="size=50"?>
Eingabefelder für die Verteilerlistenauswahl
Wenn Sie mehrere Newsletter zum Abonnieren anbieten, müssen Sie in das Template folgende TAGs integrieren:
Beispiel Newsletter:
<?GIS NEWSLETTER 1?>
Bitte geben Sie diese TAGs für jede im System bestehende Verteilerliste an, die der Abonnent auswählen können soll. Hinter NEWSLETTER geben Sie immer die Nummer der Verteilerliste an. Entnehmen Sie diese bitte der Verteilerlistenübersicht (Verteilerlisten-Verwaltung). Standardmäßig werden die Formularfelder zum Abonnieren der Verteilerlisten als Checkbox dargestellt, um den Abonnenten die Möglichkeit zu geben, mehrere Verteilerlisten auszuwählen. Sie können die Abonnenten auch direkt für einen bestimmten Newsletter anmelden, ohne dass die Möglichkeit besteht, den Newsletter abzuwählen. Er sieht die Checkbox zum Anmelden überhaupt nicht, sie bleibt für den Abonnenten unsichtbar.
Beispiel:
<?GIS NEWSLETTER hidden=1?>
Dies wird im Quellcode des Templates dann in ein "hidden Field" umgewandelt. Wenn Sie dem Abonnenten die Möglichkeit geben möchten, nur eine Verteilerliste unter mehreren angegebenen zu wählen, können Sie dies mit Hilfe des Formularfeldes "radio-Button" umsetzen.
Der dazugehörige TAG würde dann wie folgt aussehen:
Beispiel:
Bitte denken Sie daran, den "radio"-Parameter bei allen NEWSLETTTER-Feldern einzufügen. Wenn Sie einen Newsletter als Standard vorgeben möchten, fügen Sie dem TAG noch folgendes hinzu:
Beispiel:
<?GIS NEWSLETTER 1 radio checked?>
Auszug aus dem HTML-Code des Beispieltemplates:
Beispiel Newsletter:
Eingabefelder für die Passwordauswahl
Um ein Eingabefeld für Passwörter darzustellen, geben Sie im Template folgendes ein:
Password:
<?GIS PASSWORD?>
Password Wiederholen:
<?GIS PASSWORD?>
Wenn Sie zwei Eingabefelder für Passwörter in Ihr Anmeldetemplate einfügen, so prüft BACKCLICK automatisch, ob beide Passwörter übereinstimmen. Das ist sinnvoll, um Tippfehlern vorzubeugen.
Eingabefelder für allgemeine und benutzerspezifische Datenbankfelder
BACKCLICK wandelt die TAGs in Eingabefelder um, die die mit dem Datenbank-Designer definierten entsprechenden Eigenschaften haben. Das bezieht sich sowohl auf den Feldtyp als auch auf die Parameter. Zur Erstellung eines Abonnentenprofils ist es möglich, die zukünftigen Abonnenten während des Anmeldevorganges zu befragen. Anhand der vorangegangen Beispiele wird deutlich, dass Sie innerhalb des Templates nur noch den GIS-TAG einfügen müssen. Rund um diese TAGs können Sie beliebigen HTML-Code schreiben.
Beispiel für das Feld Anrede (radiobutton):
Wenn Sie eine Darstellung als Radiobutton oder Checkbox gewählt haben, müssen Sie innerhalb der <?GIS FELDNAME "value"?>-TAGs noch den Wert einfügen, der mit übergeben werden soll. Wenn Sie möchten, dass eine Checkbox oder ein Radiobutton schon angewählt ist, fügen Sie am Ende des TAGs ein "checked" ein.
Normalerweise haben Sie auf die Darstellung der Datenbankfelder nur im Datenbankdesigner Einfluss. Die dort eingestellten Werte werden bei Angabe des GIS TAGs aus dieser Datenbank übernommen und im Formular dargestellt. Sie können allerdings diese TAGs anders darstellen, als Sie es allgemein im Datenbank-Designer hinterlegt haben. Dazu ist die Angabe des "param" Attributs innerhalb des GIS TAGs gedacht. Nehmen wir an, Sie haben das Feld 'Vorname' im Datenbank-Designer mit einer Breite von 50 Zeichen angegeben. Um die Breite weiter einzugrenzen (z.B. auf 2 Zeichen), können Sie das wie folgt tun:
Beispiel:
<?GIS VORNAME params="size=2"?>
Normalerweise ist das Feld VORNAME nicht als Pflichtfeld zur Eingabe vorgesehen. Wenn Sie nun aber nur in diesem Template daraus ein Pflichtfeld machen möchten, können Sie das umsetzen, indem Sie am Ende des TAGs das Attribut "mandatory" einfügen.
Beispiel:
<?GIS VORNAME params="size=2" mandatory?>
Sie können auch Stylesheet-Zuweisungen für diese Inputfelder vornehmen.
Beispiel:
<?GIS VORNAME params="size=2 class="formatierungsname"" mandatory?>
Nachdem nun alle Eingabefelder im Template sind, müssen Sie nur noch den <NEW-USER>-TAG beenden:
Ende des Einfügens von Eingabefeldern:
<!-/NEW-USER-->
Mit dem <!--RETURN2-->-TAG können Sie zur Ausgangsseite zurückverlinken.
Beispiel:
<A href="<!--RETURN2-->">Hier klicken, um zur Ausgangsseite zurückzukehren</A>
Wenn Sie für alle Newsletter Eingabefelder angelegt und den <!--NEW-USER-->-TAG beendet haben, sind Sie mit der Erstellung des Templates fertig.