Die Datei "gbk.htm" ist das eigentliche Gästebuch. Sie finden diese Seite (sowie auch die anderen HTML-Seiten) in Rohfassung vor. Editieren sie sie nach ihren Vorstellungen. Zum Testen sind sie gebrauchsfertig, wenn sie alle rot markierten Teile angepasst haben.
Im Gästebuch muss es genau einmal die Zeile <!--begin--> geben! Diese Zeile wird jeweils durch den neusten Eintrag ersetzt.
Damit dieses möglich ist, müssen sie auf dem Server die Write-Attribute setzen. (Mit "ws_ftp": 1. serverseitig Datei markieren / 2. rechte Maustaste / 3. chmod wählen / 4. dreimal read + write markieren / 5. OK. Ansonsten "chmod 666" )
Die Datei "gbk_puf.htm" ist der Eingabepuffer.
Auch hier muss genau einmal die Zeile <!--begin--> erscheinen! Setzen sie ebenfalls die Write-Attribute.
Wer keinen Wert auf den Puffer legt, kann ihn in gbk.cfg durch mit_update=0 abschalten (s.u.).
In die Datei "gbk_log.htm" wird ein Kurzprotokoll aller Einträge geschrieben, auch der fehlerhaften Versuche. Sie enthält alle Aufrufe von ohs_gbk.pl in der Form: "Datum - REMOTE_HOST - Status".
Vergessen sie nicht, genau einmal die Zeile <!--begin--> zu notieren und ebenfalls die Write-Attribute zu setzen.
Wer keinen Wert auf den Logfile legt, kann ihn in gbk.cfg durch mit_log=0 abschalten (s.u.).
Jetzt müssen sie einige Anpassungen vornehmen:
Die Datei "gbk_add.htm" enthält das Formular, mit dem ein neuer Gästebucheintrag erzeugt wird.
- Sie müssen hier in der folgenden Zeile HOME durch ihren Ordnernamen ersetzen.
<INPUT TYPE="hidden" NAME="cfgfile" VALUE="HOME/gbk/gbk.cfg">
Die Attribute der Formular-Komponenten dürfen nicht verändert werden! Eine andere Plazierung der ganzen Tags innerhalb <FORM>...</FORM> ist natürlich möglich.
Sie können in ihrem Gästebuch auf die Eingabemöglichkeit von Wohnort und Land, E-Mail oder URL verzichten. Entfernen sie dazu die entsprechenden <INPUT>-Tags aus dem Formular. Setzen sie dann in gbk.cfg unbedingt die Schalter mit_Stadt=0, mit_Email=0 bzw. mit_URL=0 (s.u.).
Die Perl-Skripten lesen beim Aufruf die Konfigurationsdatei gbk.cfg in dem eben definierten Verzeichnis. Diese Datei enthält alle notwendigen Informationen für das Verhalten und das Layout ihres Gästebuchs.
Syntax der Einträge:
- Eine Zeile enthält höchstens ein Paar BEZEICHNER = WERT
- Leerzeilen, Leerzeichen, Tabs, CRs und FFs werden ignoriert.
- Alles ab # bis zum Zeilenende wird ignoriert.
- In den Einträgen müssen demnach die folgenden Zeichen durch ihre Hex-Codes ersetzt werden:
Leerzeichen durch %20, "=" durch %3D, "#" durch %23 und "%" durch %25.
(Alle Hex-Codes sind übrigens erlaubt.)
Konfiguration:
-
Sie müssen die Datenstruktur und das Speicherverhalten des Gästebuchs beschreiben:
- Der Name ihres Home-Ordners im Hauptverzeichnis des Servers:
home_ord = HOME/ - Der zu HOME/ relative Pfad des Gästebuchs:
gbk_pfad = gbk/gbk.htm - Soll statt gbk.htm der Puffer gbk_puf.htm beschrieben werden (Variante 2), so setzen sie mit_update = 1 [Voreinstellung], andernfalls 0.
Haben sie eben 1 gewählt, so müssen sie den zu HOME/ relativen Pfad des Puffers angeben:
puf_pfad = gbk/gbk_puf.htm
Der Bezeichner Pwd dient zum automatischen Aktualisieren und wird unten beschrieben. - Soll der Logfile beschrieben werden, so setzen sie mit_log = 1, andernfalls 0 [Voreinstellung].
Haben sie eben 1 gewählt, so müssen sie den zu HOME/ relativen Pfad des Logfiles angeben:
log_pfad = gbk/gbk_log.htm
- Der Name ihres Home-Ordners im Hauptverzeichnis des Servers:
-
Styling des Gästebuchs:
-
Sie können eine Maske festlegen, die die Form des Gästebucheintrags bestimmt.
Die Variablen $N[ame], $S[tadt], $L[and], $M[ail], $D[atum] und $K[ommentar] werden - falls vorhanden - durch die Eingaben des Gastes ersetzt.
Der Eintrag kann ein Bildchen (Pin, Button, ...) enthalten. Benutzen sie zur Plazierung die Variable $B[ild].
Die Variablen können von Umgebungen {X...X} eingeschlossen sein. Diese werden nur zusammen mit der zugehörigen Variablen $X ausgegeben.
Alle anderen Zeichen erscheinen wie notiert. Beachten sie die oben erwähnte Ersetzung einiger Zeichen durch ihren Hex-Code. Ein Zeilenende wird mit "\n" erzeugt. Ein Dollarzeichen darf nicht vor den Buchstaben N, S, L, M, D, K und B stehenDie Voreinstellung generiert einen Eintrag wie in gbk.htm abgebildet:
maske =
<p>{B$B\nB}<b>$K</b><br>\n
$N{M%20<$M>M}{S,%20$S{L%20($L)L}S}%20-%20$D</p>
So sieht ein Standard-Eintrag aus!
Name <E-Mail-Adresse>, Stadt (Land) - DatumEin anderer Vorschlag:
maske =
<p><table><tr%20valign%3D"bottom">
<td>{B$BB}</td>
<td><small>$N{M%20<$M>M}<br>
{Saus%20$S{L%20($L)L}S}%20schrieb%20am%20$D:</small></td>
</tr></table>\n
<b><i>$K</i></b></p>
Super Gästebuch! Quack!Donald Duck <dd@barks.com>
aus Entenhausen (USA) schrieb am 30.02.1998: -
Enthält maske die Variable $B, so ist der Pfad des Bildes relativ zum Gästebuch (!) anzugeben. [Voreinstellung: nichts]
pin_pfad = RELPFAD/BILD.gif -
Wollen sie dem Gast erlauben, seinen Eintrag selber mit HTML-Tags zu gestalten, so setzen sie mit_html = 1, andernfalls 0 [Voreinstellung].
-
Wollen sie dem Gast erlauben, seinen Eintrag selber mit Zeilenumbrüchen zu gestalten, so setzen sie mit_br = 1, andernfalls 0 [Voreinstellung].
-
Haben sie mit_br=0 gesetzt, so können sie mit mit_cr = 1 die eingegebenen Zeilenumbrüche erhalten. Wird der Schalter auf 0 gesetzt [Voreinstellung], wird jeder Zeilenumbruch durch ein Leerzeichen ersetzt. Der ganze Eintrag wird dann zu einer Zeile umgeformt.
-
Gibt der Gast eine E-Mail-Adresse an, so wird diese im Absender notiert und kann mit einem mailto-Anker hinterlegt werden. Soll dieses geschehen, setzen sie mit_mlink = 1 [Voreinstellung], andernfalls 0.
-
Soll zwischen den Einträgen ein Strich als Separator gesetzt werden, so notieren sie mit_hr = 1 , andernfalls 0 [Voreinstellung].
-
Soll der jeweils neueste Eintrag zuerst ins Gästebuch eingetragen werden, so schreiben sie abfolge = 1 [Voreinstellung], andernfalls 0, falls der Eintrag ans Ende soll.
-
-
Styling der Fehlermeldungen:
Bei unvollständiger Eingabe und evt. zur Bestätigung des Eintrags werden Meldungen an den Gast zurückgesendet. Um diese Seiten ihrem Gästebuch anzupassen, können die <BODY>-Attribute background, bgcolor, text, link, vlink und alink in der üblichen Weise genutzt werden.
Der Pfad des Hintergrundes ist relativ zu HOME/ zu notieren [Voreinstellung: nichts]:
background = PFAD/BGBILD.gif
Die Farben sind ohne # zu notieren: bgcolor = ffffff [Voreinstellung].Haben sie ein Gästebuch ohne Stadt und Land, E-Mail bzw. URL eingerichtet, so setzen sie die betreffenden Schalter mit_stadt, mit_email oder mit_url auf 0. Es wird dadurch verhindert, dass nach unvollständigen Eingaben in den Fehlermeldungen nach diesen Einträgen gefragt wird. Voreinstellung ist jeweils 1.
Haben sie mit_email=0 gesetzt, wird natürlich mit_mlink bedeutungslos. -
Antwortverhalten:
- Soll dem Gast nach erfolgreichem Eintrag eine Danksagung mit seinem Eintrag angezeigt werden, so setzen sie mit_dank = 1 [Voreinstellung], andernfalls 0, falls direkt zum Gästebuch zurückgekehrt werden soll.
- Es ist ratsam, sich selber per Post den Eintrag zu schicken. Setzen sie dazu mail_info = 1 [Voreinstellung], andernfalls 0.
- Haben sie mail_info=1 gesetzt, so müssen sie ihre E-Mail-Adresse angeben:
mail_adr = IHRE@MAILADRESSE