Datei:              #readme3.pdf
 Autor:              Bernhard Schmautz
 Homepage:           http://schmautz.gmxhome.de/
 Beschreibung:       Installation/Update des Gästebuches
 Änderungsübersicht: 14.01.2007 (Erstellung)
		     15.01.2007 (HTML-Code in den Eingabefeldern ist inaktiv; sonstige Überarbeitung.
			  	 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist eine Neuistallation erforderlich.
				          Die MySQL-Tabelle braucht aber nicht neu installiert zu werden, d.h. gb_install.htm nicht durchführen!)
                     17.01.2007 (Einführung einer Blätterfunktion.
			  	 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_connect.php, gb_id_aendern.php, gb_id_delete.php und gb_start.php erforderlich.
					  Die Datei gb_connect.php wieder anpassen wie unter "Installation" beschrieben.)
                     11.02.2007 (mailto-Verarbeitung berichtigt.
			  	 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
			       		  #readme3.pdf, gb_aendern.php, gb_form_delete.php, gb_id_aendern.php, gb_id_delete.php  und
					  gb_start.php  erforderlich.)
                     14.02.2007 (Intensivprüfung der eMail-Adresse im Eintrags- bzw. Änderungsformular.
			  	 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_aendern.php, gb_connect.php, gb_eingabe.php, gb_eintragen.php,
					  gb_form_aendern.php und gb_start.php erforderlich. Neu sind die Dateien gb_email.php und
					  gb_show_aendern.php. Die Datei gb_connect.php wieder anpassen wie unter "Installation" beschrieben.
					  Die Datei gb_eintragen.php ggf. wieder anpassen wie unter "Installation" beschrieben.)
                     16.02.2007 (Intensivprüfung der Homepage-Adresse im Eintrags- bzw. Änderungsformular.
			  	 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_aendern.php, gb_connect.php, gb_eingabe.php, gb_eintragen.php,
					  gb_form_aendern.php und gb_start.php erforderlich. Neu ist die Datei gb_url.php.
					  Die Datei gb_connect.php wieder anpassen wie unter "Installation" beschrieben.
					  Die Datei gb_eintragen.php ggf. wieder anpassen wie unter "Installation" beschrieben.)
                     17.02.2007 (Einführung einer Vorschaufunktion.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_aendern.php, gb_eingabe.php, gb_eintragen.php, gb_form_aendern.php
					  und gb_start.php erforderlich. Neu ist die Datei gb_vorschau.php.
					  Die Datei gb_eintragen.php ggf. wieder anpassen wie unter "Installation" beschrieben.)
                     19.02.2007 (Wegfall der Datei gb_show_aendern.php.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_aendern.php und gb_start.php erforderlich. Die Datei gb_show_aendern.php entfällt.)
                     04.03.2007 (Eingabefelder für eMail- und Homepage-Adresse von 50 auf 100 erweitert.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_eingabe.php, gb_form_aendern.php, gb_dbmake.php und gb_start.php erforderlich.
					  Neu sind die Dateien gb_update20070304.htm und gb_update20070304.php.
					  Zur Überarbeitung der Gästebuch-Tabelle muss gb_update20070304.htm durchgeführt werden.)
                     07.03.2007 (Überarbeitung der Vorschau.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_start.php und gb_vorschau.php erforderlich.)
                     12.03.2007 (Fehlerbereinigung der Vorschau und bei Eingabe von HTML-Code.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_eingabe.php, gb_eintragen.php, gb_start.php und gb_vorschau.php erforderlich.
					  Die Datei gb_eintragen.php ggf. wieder anpassen wie unter "Installation" beschrieben.)
                     13.03.2007 (Stellenzähler für das Feld "Eintrag".
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_aendern.php, gb_eingabe.php, gb_form_aendern.php und gb_start.php erforderlich.)
                     23.03.2007 (Freigabe Formatierungen UBB-Code fett, kursiv und unterstrichen.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_aendern.php, gb_eingabe.php, gb_eintragen.php, gb_form_aendern.php, gb_start.php
					  und gb_vorschau.php erforderlich.
					  Die Datei gb_eintragen.php ggf. wieder anpassen wie unter "Installation" beschrieben.)
                     02.04.2007 (Einführung Sicherheitscode Captcha.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_connect.php, gb_eingabe.php, gb_eintragen.php und gb_start.php erforderlich.
					  Neu ist die Datei gb_captcha.
					  Die Datei gb_connect.php wieder anpassen wie unter "Installation" beschrieben.
					  Die Datei gb_eintragen.php ggf. wieder anpassen wie unter "Installation" beschrieben.)
                     24.04.2007 (Designänderung.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_eingabe.php, gb_form_aendern.php, gb_form_delete.php, gb_id_aendern.php,
					  gb_id_delete.php, gb_start.php und gb_vorschau.php erforderlich.)
		     01.03.2011 (Überarbeitung Intensivprüfung der Homepage-Adresse.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_start.php und gb_url.php erforderlich.)
                     02.12.2013 (Überarbeitung Umlautverarbeitung.
			         Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist nur ein Austausch der Dateien
					  #readme3.pdf, gb_admin.php, gb_adminmenu.php, gb_aendern.php, gb_connect.php, gb_eingabe.php,
					  gb_eintragen.php, gb_form_aendern.php, gb_form_delete.php, gb_id_aendern.php, gb_id_delete.php,
					  gb_start.php und gb_vorschau.php erforderlich.
					  Die Datei gb_connect.php wieder anpassen wie unter "Installation" beschrieben.
					  Die Datei gb_eintragen.php ggf. wieder anpassen wie unter "Installation" beschrieben.)
                     16.07.2015 (Formatierung der Überschriften mit CSS und nicht mehr mit <h2>;
				 Umschreibung der Umlaute durch sog. "benannte Zeichen/Named Entities" bzw. durch ae, oe, ue;
				 Bereitstellung der readme-Datei im .pdf-Format und nicht mehr im .txt-Format.
				 Achtung: Im Updatefall, also wenn das Gästebuch bereits installiert war, ist ein Austausch der Dateien
				 	  nur dann erforderlich, wenn es Probleme mit den Links unterhalb der Überschriften bzw.
					  mit Umlautdarstellung gibt. Bezüglich der Umlautdarstellung siehe auch unter "Hinweise".)



 Das Zip-File gb.zip enthält folgende Dateien:

          +-bilder			Ordner mit GIF's
          !  gb.gif			Gästebuch-GIF
          !
          #readme3.pdf			Die Beschreibung, die Sie gerade lesen
          !
          gb_admin.php			Admin-Login mit Benutzername/Passwort.
          !
          gb_adminmenu.php		Admin-Menü zur Auswahl, ob Eintrag geändert oder gelöscht werden soll.
          !
          gb_aendern.php		MySQL-Update.
          !
	  gb_captcha.php		Generierung Sicherheitscode Captcha.
	  !
          gb_connect.php		Datenbankeinstellungen, Benutzername/Passwort für den Admin,
	  !				Anzahl der Gästebucheinträge pro Seite und Aufbau der Datenbankverbindung.
	  !				Ein-/ausschalten der Intensivprüfung (Formalprüfung, Mailserver, Existenz) der eMail-Adresse.
	  !				Ein-/ausschalten der Intensivprüfung (Webserver, Existenz) der Homepage-Adresse.
          !
          gb_dbmake.php			MySQL-Create Table und Bestätigung (Aufruf durch gb_install.htm).
          !
          gb_delete.php			MySQL-Delete.
          !
          gb_design.php			Layout des Gästebuches (Hintergrundbild/Farben).
          !
          gb_eingabe.php		Eintragsformular.
          !
          gb_eintragen.php		MySQL-Insert und Eintragsbestätigung.
          !
	  gb_email.php			Intensivprüfung (Formalprüfung, Mailserver, Existenz) der eMail-Adresse.
	  !
          gb_form_aendern.php		Änderungsformular.
          !
          gb_form_delete.php		Löschbestätigung.
          !
          gb_id_aendern.php		Änderungsauswahl.
          !
          gb_id_delete.php		Löschauswahl.
          !
          gb_install.htm		Gästebuch-MySQL-Tabelle anlegen.
          !
          gb_start.php			Startseite des Gästebuches mit Anzeige der vorhandenen Einträge.
	  !
	  gb_update20070304.htm		Update Gästebuch 04.03.2007.
	  !
	  gb_update20070304.php		UpdateGästebuch 04.03.2007 (Aufruf durch gb_update20070304.htm).
	  !
	  gb_url.php			Intensivprüfung (Webserver, Existenz) der Homepage-Adresse.
	  !
	  gb_vorschau.php		Vorschau für einen neuen oder geänderten Eintrag.


 Installation:

          1. Entpacken Zip-File gb.zip in ein beliebiges Verzeichnis des PHP-fähigen Webspaces.
	     Achtung: Bei Updates sind nicht immer alle Dateien, die sich in dem Zip-File befinden, erforderlich.

          2. Die Datei gb_connect.php anpassen, d.h. anstelle von ### die Werte der eigenen MySQL-Datenbank eintragen.
	     Ggf. Benutzername/Passwort für den Admin ändern (Default ist admin/admin).
	     Ggf. Anzahl der Gästebucheinträge pro Seite ändern (Default ist 10).
	     Ggf. Intensivprüfung der eMail-Adresse einschalten (Default ist "aus").
	     Ggf. Intensivprüfung der Homepage-Adresse einschalten (Default ist "aus").
	     Ggf. Sicherheitscode einschalten (Default ist "aus").
	     Anzumerken ist, dass die Intensivprüfungen natürlich länger als die normalen Prüfungen dauern.

          3. In der Datei gb_eintragen.php kann, falls gewünscht, unter "$strEmpfaenger" bei ### eine eMail-Adresse eingetragen werden,
	     unter der man eine Nachricht bei einem Neueintrag erhält.
	     Bitte in diesem Fall den Kommentar bei "mail($strEmpfaenger, $strSubject, $strMailtext)" entfernen.

 	  4. In der Datei gb_design.php kann das Layout des Gästebuches (Hintergrundbild/Farben) angepasst werden.

	  5. Geben Sie den Dateien auf dem Server (wenn es ein Unix-Rechner ist) mit dem chmod-Befehl die Rechte 755.
	     Ein ordentliches FTP-Programm sollte Sie dabei unterstützen.

	  6. Die Datei gb_install.htm aufrufen um die Installation der MySQL-Tabelle zu starten.
	     Nur bei einer Neuinstallation, nicht bei Update!

	  7. Unter dem Punkt "Eintragen" auf der Startseite gb_start.php können Einträge angelegt werden.

	  8. Unter dem Punkt "Admin" auf der Startseite gb_start.php können die Einträge geändert oder gelöscht werden.
	     Benutzername/Passwort für den Admin in der Datei gb_connect.php eintragen (Default ist admin/admin).

	  9. Unter dem Punkt "Download/Update" auf der Startseite gb_start.php kann die Gästebuch-Software ggf. auf den
	     neuesten Stand gebracht werden. Siehe hierzu unter "Update" im nächsten Abschnitt.


 Update:

          Siehe unter "Installation", d.h. bei Updates wird kein Delta bereitgestellt, sondern immer die gesamte Anwendung.

          Sollte sich bei einem Update die MySQL-Tabelle ändern, sind ggf. Sondermaßnahmen erforderlich.

	  Bitte beachten Sie im Updatefall immer die Hinweise in der Änderungsübersicht.

	  Es sind immer alle Updates seit dem zuletzt installierten Softwarestand in chronologischer Reihenfolge durchzuführen.


 Hinweise:

	  Bei diesem Gästebuch handelt es sich um ein einfaches in PHP geschriebenes Gästebuch mit Admin-Funktion.

	  Grundlage für das Gästebuch war DGBuch V1.0 (d.-gbook v1.0) von d.-Coder.

	  Voraussetzungen:
	  - PHP-fähiger Webspace (ab PHP 4)
	  - MySQL-Datenbank
	  - Zur Installation sind Grundkenntnisse in HTML, PHP, MySQL und FTP erforderlich.

	  Die HTML- und PHP-Dateien müssen sich im selben Verzeichnis befinden.
	  Das Gästebuch-GIF muss sich im Unterverzeichnis "bilder" befinden.

	  Die Angabe zur Zeichenkodierung in den HTML-Dateien ist mit "charset=ISO-8859-1" definiert.
	  Bei Umlautproblemen ist es vielleicht besser mit "charset=UTF-8"?

	  Für die Funktionsfähigkeit des Gästebuches übernehme ich keinerlei Gewähr.