Dieser Abschnitt der Dokumentation befasst sich mit der Erstellung eigener Templates. Um mal etwas vorweg zu nehmen: Wenn Sie ein eigenes Template erstellen wollen, dann sollten Sie Erfahrung in HTML sowie CSS mitbringen. Wenn Sie nur die Farben oder die Tabellenbreiten eines Templates an Ihre Bedürfnisse anpassen wollen, dann genügt es wenn Sie sich ein wenig durch diese Dokumentation arbeiten.

ACHTUNG: Wenn Sie größere Änderungen am Template durchführen, dann tun Sie das an einer Kopie des Original Templates, dass sie in einem eigenen Ordner speichern. So laufen Sie nicht Gefahr durch ein Update des Gästebuches Ihre Änderungen ungewollt zu überschreiben. Hinweise zu Änderungen am Template finden Sie in den Versionsunterschieden.

Ein Template ist eine Designvorlage, meist in HTML geschrieben, die Platzhalter enthält um dort den Inhalt einzufügen, der von einem Programm wie z.B. in diesem Fall einem Gästebuch generiert wird.

Im Fall des MGB sehen diese Platzhalter so aus:

{PLATZHALTER}

Sie beginnen mit einer geschweiften Klammer, der Text ist GROSS geschrieben, Leerzeichen werden durch Unterstriche (_) dargestellt und sie enden auch wieder mit einer geschweiften Klammer. Diese Platzhalter kommen an die Stelle im Template, wo sie durch den Inhalt ersetzt werden sollen. Beispielsweise wird der Platzhalter

{TITLE}

in der mgbModern/main/index_body.tpl durch den Titel des Gästebuches ersetzt.

Die Dateiendung *.tpl bedeutet nichts anderes als „Template“ und enthält HTML. Die Datei heisst nur anders. Man kann sie mit einem ganz normalen Texteditor wie Notepad oder Notepad2 öffnen.

Das Template ist in verschiedene Bereiche aufgebaut. Ich erkläre es mal anhand der mitgelieferten Vorlage “mgbModern“. Sie befindet sich im Ordner “templates“ im Hauptverzeichnis des Gästebuches. Es gibt vier Unterordner:

-- admin
  - activate.tpl
  - admin.tpl
  - deactivate.tpl
  - delete.tpl
  - edit.tpl
  - edit_single.tpl
  - edit_user.tpl
  - edit_user_adduser.tpl
  - edit_user_single.tpl
  - login.tpl
  - login_ok.tpl
  - lostpassword.tpl
  - lostpassword_sent.tpl
  - navigation.tpl
  - settings.tpl
  - version.tpl
 |-- general_admin
    - copyright.tpl
    - errormessage.tpl
    - footer.tpl
    - header.tpl
    - scrolling_function.tpl
-- css
 |-- black
    - style.css
 |-- blue
    - style.css
 |-- ...
-- general
  - captcha.tpl
  - copyright.tpl
  - errormessage.tpl
  - footer.tpl
  - header.tpl
  - scrolling_function.tpl
-- js
  - overlib.js
-- main
  - email_body.tpl
  - email_body_success.tpl
  - index_body.tpl
  - index_entry.tpl
  - index_entry_aim.tpl
  - index_entry_city.tpl
  - index_entry_comment.tpl
  - index_entry_email.tpl
  - index_entry_hp.tpl
  - index_entry_icq.tpl
  - index_entry_message.tpl
  - index_entry_msn.tpl
  - newentry_bbcodes.tpl
  - newentry_body.tpl
  - newentry_body_entry_success.tpl
  - newentry_smileys.tpl
  - newentry_user_notification.tpl
  - newentry_user_show_email.tpl
- readme.txt
- settings.php

1. admin = Enthält die Vorlagen für die Administration.
   • general_admin = Enthält Vorlagen für Dateien die überall in der Administration zu finden sind. Copyright Anzeige etc.
2. css = Enthält die Cascading Style Sheet Dateien, mit denen die Farben u.s.w. festgelegt werden.
   • black = Das CSS für die schwarze Version.
   • blue = Das CSS für die blaue Version.
   • …
3. general = Enthält Vorlagen für Dateien die überall auf den Hauptseiten zu finden sind. Copyright Anzeige etc.
4. js = JavaScript für die „overLIB“ Bibliothek.
5. main = Enthält alle Dateien die ein normaler Benutzer zu sehen bekommt.

Die Dateien selbst haben immer einen spezifischen Dateinamen. So gehören z.B. zur index.php alle Dateien die mit index beginnen. Es folgt ein Unterstrich und dann die Bezeichnung welchen Teil die Datei enthält. body ist z.B. das Grundgerüst mit HEADER und FOOTER, und bindet andere *.tpl Dateien ein. index_entry.tpl stellt nur einen einzigen Eintrag dar. index_entry_comment.tpl den Kommentar für einen Eintrag. Es ist nötig dies in verschiedene Dateien aufzuteilen, da diese Teile ja dynamisch eingebunden werden, wenn diese Information verfügbar ist. Beispiel:

index_body.tpl enthält den Platzhalter {TEMPLATE_ENTRIES}. Dieser wird ersetzt durch die Datei index_entry.tpl. Diese wiederum enthält den Platzhalter {TEMPLATE_ENTRY_COMMENT} der durch die index_entry_comment.tpl ersetzt wird. Wenn kein Kommentar verfügbar ist, dann wird der Platzhalter {TEMPLATE_ENTRY_COMMENT} einfach durch einen leeren String ersetzt, und es erscheint kein Kommentar unter dem Eintrag.

Um die Farben oder die Tabellenbreiten des Templates zu verändern, ist es nötig die benutzte CSS Datei zu bearbeiten. Eine CSS Datei enthält verschiedene Angaben, zu verschiedenen Klassen, die im Template benutzt werden. Eine Klasse wird im allgemeinen so definiert:

span.title {
	font-family: 'lucida console', verdana, arial, helvetica, sans-serif;
	font-size: 14px;
	color: #7F7F7F; }

Somit wird jeder Text der in einem <span> Tag mit der Klasse title

<span class="title">

erscheint, mit der Schriftart Lucida Console (falls verfügbar, wenn nicht wird die nächste in der Reihe genommen: verdana), der Schriftgröße 14 und der HTML Farbe #7F7F7F dargestellt.

Hier die wichtigsten CSS Attribute:

Ich empfehle die Seite http://www.css4you.de/. Dort wird sehr ausführlich erklärt was die einzelnen Attribute bedeuten, und was man damit alles anstellen kann. Sehr zu empfehlen ist der CSS Workshop für blutige Anfänger.

Hier eine „kleine“ Liste der wichtigsten verfügbaren Farben, um seinem Template die richtigen Farben zu geben. Vielen lieben Dank an http://mahopa.de/ für die freundliche Bereitstellung! :)