Inhalt

1. Projekt-Infos
2. Häufig gestellte Fragen (FAQ)
3. Bekannte Fehler

I. Projekt-Infos

II. Häufig gestellte Fragen (FAQ):

1. Was ist Jax Guestbook ? Wozu brauche ich es?
   
   
2. Wie installiere ich Jax Guestbook auf meiner Website (ohne MySQL) ?
   
   
3. Wie kann ich Jax Guestbook mit MySQL benutzen?
   
   
4. Wie viele Einträge kann Jax Guestbook speichern?

1. Was ist Jax Guestbook ? Wozu brauche ich es ?

Jax Guestbook ist ein Skript, mit dem Sie Ihre Homepage mit einem Gästebuch ausstatten können. In einem Gästebuch können die Besucher Ihrer Homepage persönliche Grüsse und Kommentare zu Ihrer Website sowie Verweise zu Ihren eigenen Homepages hinterlassen.

Darüber hinaus bietet Ihnen Jax Guestbook zur Zeit folgende Leistungsmerkmale:

• Unterstützung verschiedener Datenquellen (zur Zeit für MySQL & CSV-Textdatei)
  (MySQL wird unterstützt, ist aber nicht unbedingt erforderlich!)
  
  
• Modernes, ansprechendes Erscheinungsbild ("look & feel")
  
  
• Schriften und Farben sind individuell via Cascading Stylesheets anpassbar
  (Es liegen bereits verschiedene CSS-Vorlagen bei)
  
  
• Sprachunterstützung für mehrere Sprachen
  (bisher existieren Vorlagen für Deutsch und Englisch)
  
  
• Grafik-Smiley-Unterstützung
  (die gängigsten Smilies werden automatisch von Text in Grafik umgewandelt)
  
  
• Statusanzeige für Instant-Messenger-Programme
  (bisher für ICQ)
  
  
• Protokollierung der IP-Adresse zum Schutz gegen mehrfaches Senden
  
  
• Automatische Erkennung und Umwandlung von WWW- und e-mail-Adressen
  
  
• Textfilter gegen schädlichen HTML code / langen Text / derbe Schimpfwörter
  
  
• Komfortables Verwaltungsprogramm
  
  
• e-mail Benachrichtigung bei neuen Einträgen
  
  
• Import und Export bestehender Gästebucheinträge
  (Umwandlung zwischen CSV-Textdatei und MySQL-Datenbank in beide Richtungen möglich)
  
  
• Ausführliche Installationsanleitung
  
  
• Preis: gratis, Lizenz: GPL (General Public License)
  
  
• Unterstützte Platformen: Alle Plattformen, auf denen PHP läuft (Windows, Linux)
  
  
  

2. Wie installiere ich Jax Guestbook auf meiner Website? (ohne MySQL)

Jax Guestbook wurde in der Skriptsprache PHP 4 geschrieben und setzt PHP - eine serverseitige Programmiersprache, mit der man dynamisch erzeugte Webseiten erstellen kann - voraus!

(Fragen Sie ggfs. Ihren Web-Provider nach PHP-Unterstützung!)

Jax Guestbook läuft auch ohne MySQL-Unterstützung!

Verfügen Sie bereits über PHP-Unterstützung, dann tun Sie einfach folgendes:

1. Besorgen Sie sich die aktuellste Version von Jax Guestbook unter http:/www.jtr.de/scripting/php/guestbook/ !
   
   
2. Entpacken Sie das Archiv!
   
   
3. Öffnen Sie mit einem Texteditor die Datei globals.inc.php (im Verzeichnis guestbook) und passen Sie die Einträge Ihren Bedürfnissen an!
   
   Sie können die Einstellungen auch später über das beiliegende Verwaltungsprogramm auf Ihrer Website durchführen. Dieses finden Sie im Verzeichnis admin (relativ zu Ihrem Gästebuchskript) standardmäßig unter dem Namen guestbook.admin.php
   
   Wenn Sie das Gästebuch also beispielsweise im Hauptverzeichnis Ihrer Website unterbringen (/) finden Sie das Verwaltungsprogramm unter http://www.ihredomain.de/guestbook/admin/guestbook.admin.php
   
   
4. Laden Sie das Gästebuch auf Ihre Website!
   
   Nachdem Sie das Skript auf Ihren Webspace hochgeladen haben, stellen Sie die Zugriffsrechte für die beiden CSV-Dateien (standardmäßig "guestbook" und "ips2block") so ein, dass das Skript darauf vollen Zugriff hat!
   
   
5. Vergessen Sie nicht, das Skript auf Ihrer Website zu verlinken! ;-)
   Viel Spaß!

3. Wie kann ich Jax Guestbook mit MySQL benutzen?

Jax Guestbook wurde so entworfen, dass es sowohl einfache Textdateien, als auch MySQL-Datenbanktabellen zur Speicherung der Einträge verwenden kann. Die Verwendung der MySQL-Datenbank ist bei großen Gästebücher mit vielen Einträgen in der Regel die schnellere CSV-Variante...

Verfügen Sie über MySQL-Unterstützung dann tun Sie folgendes:

1. Installieren Sie Jax Guestbook (siehe "Wie installiere ich Jax Guestbook auf meiner Website?")...
   
   
2. Führen Sie das Administrationsprogramm auf der Website aus!
   Das Programm finden Sie im Verzeichnis admin (relativ zu ihrem Gästebuchverzeichnis).
   
   
3. Setzen Sie unter [Einstellungen ändern] Datenquelle auf "MySQL-Datenbank" und tragen Sie die Zugriffsdaten (Server, Benutzerkennung und Passwort) für Ihren MySQL-Server ein !
   
   
4. Starten Sie phpMyAdmin (oder das entsprechende Monitorprogramm für Ihren MySQL-Server) und legen Sie die folgende Tabellenstruktur an. MySQL-Schema:
   
   CREATE TABLE `guestbook` (
   `id` int(4) NOT NULL auto_increment,
   `date` varchar(10) default NULL,
   `time` varchar(8) default NULL,
   `ip` varchar(16) default NULL,
   `name` varchar(30) default NULL,
   `mail` varchar(100) NOT NULL default '',
   `age` char(3) default NULL,
   `location` varchar(30) default NULL,
   `homepage` varchar(100) default NULL,
   `icq` varchar(12) default NULL,
   `message` text NOT NULL,
   PRIMARY KEY (`id`)
   ) TYPE=MyISAM;

   CREATE TABLE `ips2block` (
   `ip` varchar(16) NOT NULL default '0',
   `timestamp` varchar(10) NOT NULL default ''
   ) TYPE=MyISAM;

5. Wenn Sie bereits ein Gästebuch im CSV-Format haben, so können Sie mit der Option "Gästebuch importieren/exportieren" die Daten von der CSV-Datei in die MySQL-Tabellen übertragen...

4. Wie viele Einträge kann Jax Guestbook speichern?

Getestet habe ich das Skript nur mit einer kleinen, realistischen Menge von Gästebucheinträgen (ca.150 Einträge im CSV-Format). Theoretisch müsste das Skript (je nach verfügbarer Rechenzeit/-leistung und Datenquelle) problemlos mehrere 100 Einträge verwalten können. Für größere Gästebücher bietet sich die Verwendung von MySQL als Datenquelle an...

III. Bekannte Fehler

- bisher sind noch keine Fehler bekannt.

Sollten Sie einen Fehler finden, oder haben Sie Fragen oder Verbesserungsvorschläge, zögern Sie bitte nicht, und wenden Sie sich einfach direkt an mich!

mailto: jack@jtr.de

Berlin, 09.09.2001 Jack (tR)