|
GÄSTEBUCH BENUTZEN
Das Gästebuch kann auf der eigenen Homepage ohne Einschränkung
eingebuden und verwendet werden. Dabei sind zwei Arten möglich:
- Gästebuch als eigene Seite ("einfache Variante")
- Gästebuch in eine andere Seite integrieren
Beide Arten werden unterstützt. In beiden Varianten muss das Gästebuch
konfiguriert werden. Wenn PHP Kenntnisse vorhanden sind, kann die
Konfiguration ausgelagert und z.B. mit require eingelesen
werden, darauf wird aber hier nicht näher eingegangen. Die Aufrufparameter
sind in Parameters erklärt.
EINFACHE VARIANTE
Dies ist die einfachere Variante. Das Gästebuch wird als eigenständige
Seite auf der Homepage dargestellt. Die Gästebuch-Klasse XVW_Guestbook
wird einfach in Skript eingebunden und aufgerufen. Das Ergebnis muss
mit echo ausgegeben werden:
| Beispiel: Gästebuch als eigene Seite |
Beispiel:
die Gästebuch-Seite läuft als eigenständige Seite, dies wird durch den
Konfigurations-Parameter is_html = true definiert. Der Aufruf
ist dann:
/***
# Parameter, die die default-Konfiguration des Gästebuchs
# überschreiben.
***/
$gb_gv_configuration = array
( 'mysql_host' => "localhost"
, 'mysql_port' => 3306
, 'mysql_user' => "SCOTT"
, 'mysql_pw' => "TIGER"
, 'mysql_dbname' => "database123"
, 'mysql_init' => "SET NAMES utf8"
, 'tablename' => "table_guestbook"
, 'mail_address' => "ut.void@gmx.de"
, 'mail_cc' => ""
, 'mail_sender' => "guestbook@domain.tld"
, 'mail_static_server' => "http://www.domain.tld"
, 'mail_static_link' => "/guestbook40.php"
, 'mail_static_guestbook' => "Mein Gästebuch"
, 'mail_static_webmaster' => "webmaster@domain.tld"
, 'adm_name' => "test"
, 'adm_pw' => "test"
, 'headline' => "Mein Gästebuch"
, 'headline_add' => "Willkommen im Gästebuch"
, 'is_html' => true
);
/* Hier noch die beiden Mailkonstanten ... */
...
/***
* 1. Aufruf des Gästebuchs
* 2. Ausführung und
* 3. Ausgabe mit echo
* 4. FERTIG!
***/
$gb_guestbook = new XVW_Guestbook( $gb_gv_configuration );
$gb_guestbook->main();
echo $gb_guestbook->getContent();
exit();
/* Nicht vergessen, die Gästebuch-Klasse muss natürlich auch da sein */
class XVW_Guestbook {
...
}
|
INTEGRATION IN EINE ANDERE SEITE
Bei dieser Variante ist das Gästebuch in eine andere PHP-Seite integriert
(Hauptseite). Die Hauptseite übernimmt die Steuerung des Aufrufs und die
Kontrolle der Ausgaben aus dem Gästebuch (z.B. bei CMS-Systemen).
Konfiguraton und Aufruf des Gästebuchs sind im Wesentlichen mit der
"einfachen Variante" identisch.
Nach Aufruf des Gästebuchs kann der Inhalt aber nicht einfach ausgegeben
werden, sondern die wesentlichen Daten des Gästebuchs (CSS-Code,
Javascript-Code und der Inhalt) müssen an die - das Gästebuch umgebende -
Hauptseite übergeben werden.
Die Ausgabe des (Gesamt-)Inhalts erfolgt über die Logik der Hauptseite. Wie
dies im Detail funktioniert muß aus der Dokumentation der umgebenden
Hauptseite ermittelt/nachgesehen werden.
Stellt die Hauptseite keine Funktionen zum Setzen des CSS-Codes bzw. des
Javascript-Codes zur Verfügung ist die Integration des Gästebuch problematisch
oder nicht möglich. Eventuell kann der der CSS-Code bzw. JS-Code "manuell"
in der Hauptseite eingetragen werden. In solchen Fällen wird empfohlen die
"einfache Variante" zu verwenden.
| Beispiel: Gästebuch in eine andere Seite integrieren |
Beispiel:
die Gästebuch-Seite läuft nicht als eigenständige Seite, sondern ist
in eine andere Seite - oder in ein CMS usw. - eingebunden. Wichtig ist das
der Konfigurations-Parameter is_html = false gesetzt wird.
In diesem Beispiel ist $page die Hauptseite. Die Hauptseite
$page stellt Funktionen zum zusätzlichen Setzen von CSS-Code
(addCSS), Javascript-Code (addJS) und des
Inhalts (addContent) zur Verfügung. Die Funktionen müssen nach
dem Aufruf des Gästebuch zusätzlich aufgerufen werden, damit die Daten
(CSS-code, JS-Code und der Inhalt) zur Hauptseite gelangen und über diese
ausgegeben werden.
/***
# Parameter, die die default-Konfiguration des Gästebuchs
# überschreiben.
***/
$gb_gv_configuration = array
( 'mysql_host' => "localhost"
, 'mysql_port' => 3306
, 'mysql_user' => "SCOTT"
, 'mysql_pw' => "TIGER"
, 'mysql_dbname' => "database123"
, 'mysql_init' => "SET NAMES utf8"
, 'tablename' => "table_guestbook"
, 'mail_address' => "ut.void@gmx.de"
, 'mail_cc' => ""
, 'mail_sender' => "guestbook@domain.tld"
, 'mail_static_server' => "http://www.domain.tld"
, 'mail_static_link' => "/guestbook40.php"
, 'mail_static_guestbook' => "Mein Gästebuch"
, 'mail_static_webmaster' => "webmaster@domain.tld"
, 'adm_name' => "test"
, 'adm_pw' => "test"
, 'headline' => "Mein Gästebuch"
, 'headline_add' => "Willkommen im Gästebuch"
, 'is_html' => false
);
/* Hier noch die beiden Mailkonstanten ... */
...
/***
* 1. Aufruf des Gästebuchs und
* 2. Ausführung und
***/
$gb_guestbook = new XVW_Guestbook( $gb_gv_configuration );
$gb_guestbook->main();
/***
* $page ist hier als Stellvertreter für die ("äußere") Hauptseite
* anzusehen. Mit den Funktionen
* - addCSS(..) soll der im Gästebuch verwendete CSS-Code
* an die Hauptseite übergeben werden
* - addJS(..) soll der im Gästebuch verwendete JS-Code an
* die Hauptseite übergeben werden
* - addContent(..) soll der im Gästebuch erzeugte Inhalt
* (der "HTML"-Code) an die Hauptseite übergeben werden
*
* ! KEIN exit() SONDERN return; die Ausführung soll ja nicht beendet
* sondern die Kontrolle zurück an die Hauptseite gegeben werden
***/
global $page;
$page->addCSS( $gb_guestbook->getCSS() );
$page->addJS( $gb_guestbook->getJS() );
$page->addContent( $gb_guestbook->getContent() );
return;
/***
* Nicht vergessen, die Gästebuch-Klasse muss
* natürlich auch da sein
****/
class XVW_Guestbook {
...
}
|
ADMINISTRATION
Das Gästebuch kann Online adminstriert werden. Die Parameter adm_name
und adm_pw müssen gesetzt sein. Der Admin-Zugang kann über den
im "Eintrag hinzufügen" Dialog erreicht werden:
Im Feld EMail ist der Admin-Name und das Admin-Kennwort, getrennt
durch zwei @-Zeichen einzugeben, z.B. test@@test.
Anschliessend ist der "Vorschau" Button zu benutzen. Ist Name und Kennwort
korrekt erscheint die Admin-Oberfläche:
Die Werte können bearbeitet werden. Durch UPDATE werden die
Eintragungen aktualisiert. Mit DELETE wird der Eintrag ohne
weitere Rückfrage entfernt.
|
