UH!BOOK v1.4 2008 © Karin Uhlig modul@kg3.de ALLGEMEINES Dieses Skript stellt eine schlanke Gästebuchlösung bzw. ein kleines Messageboard zur Verfügung. Neue Beiträge werden erst als Vorschau dargestellt, der Administrator kann einzelne Beiträge löschen. Der letzte Beitrag wird zuerst angezeigt, eine Blättern-Funktion ermöglicht das Vorwärts- und Zurückblättern durch alle Beiträge. Die Anzahl der anzuzeigenden Beiträge pro Seite kann angegeben werden. Die Farben und die Schriftart lassen sich einfach anpassen. HTML-Code und Skriptaufrufe in den Eingabefeldern werden nicht ausgeführt, die Mailadresse wird auf Format überprüft. Zum Schutz vor Spam kann ein Captcha verwendet werden. Durch Eingabe einer Admin-Emailadresse wird der Administrator von neuen Einträgen benachrichtigt. Optional kann die Anzeige der Email-Adresse der Besucher verborgen werden (Datenschutz!) HISTORIE 1.1 Feld "Website" hizugefügt 1.2 Spam-Check hizugefügt 1.3 Admin-Email bei neuem Eintrag 1.4 Verbergen der Email (optional) ANLEITUNG GRUNDEINSTELLUNGEN: In der Datei gbuch.php müssen zuerst die Grundeinstellungen vorgenommen werden. ////////////////////////////////////////// // HIER DIE EINSTELLUNGEN VORNEHMEN! // ////////////////////////////////////////// $pfad = 'http://www.domain.xx/meinordner/gbuch.php'; hier muß die komplette URL zum Gästebuch angegeben werden $eintrag = 'brett.txt'; hier wird die Textdatei benannt, in die die Gästebuch-Einträge geschrieben werden sollen. Wenn sie im gleichen Verzeichnis liegt wie gbuch.php, muß kein Ordner angegeben werden, ansonsten muß der relative Pfad angegeben werden (z.B. gbuch/brett.txt). $titel = 'mein Gästebuch'; Die Überschrift wird hier definiert, sie wird auch als TITLE-Angabe verwendet. $schrift = 'Verdana'; Hier wird die Schriftart für die Ausgabe festgelegt $farbe_H = 'rgb(0,64,128)'; $farbe_P = 'rgb(200,0,0)'; Farben der Überschriften und der Texte. Sie werden im Format #CC3300 oder rgb(254,45,60) oder als Wort angegeben. Rot z.B. kann auf 3 Arten definiert werden: 'red' oder '#FF0000' oder 'rgb(255,0,0)'. $zeig = '6'; Hier wird angegeben, wieviele Beiträge pro Seite angezeigt werden sollen. $pwd = 'admin'; Das Paßwort, mit dem Beiträge gelöscht werden können. $check = 'yes'; Wenn der Spamcheck verwendet werden soll, "yes" belassen. "no" schaltet ihn aus. $cptext = 'gbuch/catch.txt'; Relativer Pfad zur Textdatei für den Spamschutz. Diese sollte keinesfalls im Root der Domain (oberste Ebene) liegen, sondern in einem Unterverzeichnis. Kann im gleich Unterverzeichnis liegen wie $eintrag. $path2gif = 'gbuch/'; Relativer Pfad zum Ordner der Gif-Datei für Spamschutz $ttf = 'verdana.ttf'; Relativer Pfad zur Schrift-Datei für Captcha (.ttf) $mailadmin = 'email@domain.com'; Wenn man bei neuen Einträgen benachrichtigt werden möchte, hier die eigene Mailadresse eingeben. Wenn nicht, einfach leer lassen. $showemail = 'no'; Soll die Mailadresse der Besucher im Gästebuch angezeigt werden? 'yes': ja, 'no': nein Bitte darauf achten, daß die Anführungszeichen der Variablennamen nicht gelöscht werden! INSTALLATION gbuch.php sowie brett.txt mit einem FTP-Programm auf den Server hochladen, und zwar in das Verzeichnis / die Verzeichnisse, die oben bei $pfad und $eintrag angegeben wurden. Die Textdatei muß in jedem Fall angelegt werden, auch wenn sie vorerst noch leer ist! ACHTUNG: BEI EINEM UPDATE DIE DATEI brett.txt NICHT MEHR HOCHLADEN!!! brett.txt braucht Lese- und Schreibrechte (CHMOD 666), das Verzeichnis, in dem brett.txt liegt, auf CHMOD 777 setzen. Bei Verwendung des Spamschutzes werden während des Eintragens zwei Dateien angelegt: catch.txt und eine Grafikdatei, die immer neu benannt wird. Beide Dateien MÜSSEN in einem Unterverzeichnis liegen (kann das gleiche sein wie brett.txt), dieses Verzeichnis braucht volle Schreibrechte (CHMOD 777, Einstellen über FTP). Die Dateien selbst müssen nicht angelegt werden. BENUTZUNG Das Skript stellt eine Löschfunktion zur Verfügung, um schnell unerwünschte Beiträge entfernen zu können. Dazu das kleine schwarze "x" rechts oben in jedem Beitrag anklicken, auf die Paßwortabfrage das unter $pwd angegebene Paßwort eingeben. Mit "ok" ist der Beitrag gelöscht. Die Beiträge können natürlich auch editiert werden, indem direkt in der Textdatei geändert wird. Dabei bitte auf das Format der Daten achten, sie werden in der Textdatei wie folgt dargestellt: [Index]##[Datum]##[Name]##[Mailadresse]##[Webseite]##[Beitragstext]## Die Doppelkreuze "##" dienen dabei als Trennzeichen der einzelnen Felder. Zeilenumbrüche (Absätze) im Beitragstext werden im HTML-Format (
) abgespeichert. Die Textdatei mit einem FTP-Programm herunterladen, die Änderungen vornehmen und anschließend hochladen. Nicht vergessen, anschließend die Rechte wieder auf CHMOD 666 zu setzen! Bei Abbruch des Skripts durch Schließen des Browsers wird die aktuelle Grafikdatei vom Spamschutz nicht automatisch gelöscht. Deshalb sollte man von Zeit zu Zeit mit dem FTP-Programm das Spamschutz-Verzeichnis überprüfen und alle GIF-Dateien darin löschen. (Format: txt123.gif, 123 sind variable Ziffern) COPYRIGHT Das Gästebuch-Skript ist Freeware, die Anwendung ist für private und kommerzielle Benutzer uneingeschränkt erlaubt. Das Skript ist geistiges Eigentum des Autors. Der Copyright-Vermerk darf nicht verändert oder gelöscht werden. Änderungen am Quellcode sind gestattet, ich bitte darum, mir Verbesserungsvorschläge oder Erweiterungen unter modul@kg3.de mitzuteilen. Die kommerzielle Weitergabe des Gästebuchs ist weder in der vorliegenden Form noch nach Änderungen am Quellcode erlaubt. HAFTUNGSAUSSCHLUSS Für jegliche Schäden immaterieller oder materieller Art durch Verwendung des vorliegenden Skriptes wird keine Haftung übernommen. Es besteht kein Anspruch auf Gewährleistung, auf Support oder Updates. Bei Fragen oder Unklarheiten schicken Sie bitte eine Mail an modul@kg3.de. Mit dem Download des Skripts werden diese Bedingungen ohne Einschränkung anerkannt.