Main Links Oben mindestbreite Main Rechts Oben
mindestbreite


GÄSTEBUCH BENUTZEN

Das Gästebuch kann auf der eigenen Homepage ohne Einschränkung eingebuden und verwendet werden. Dabei sind zwei Arten möglich:

  1. Gästebuch als eigene Seite ("einfache Variante")
  2. 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: guestbook_admin

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: guestbook_admin2
Die Werte können bearbeitet werden. Durch UPDATE werden die Eintragungen aktualisiert. Mit DELETE wird der Eintrag ohne weitere Rückfrage entfernt.



mindestbreite
Main Links Unten mindestbreite Main Rechts Unten