Templates / Layout

Gästebuchlayout anpassen

Das Gästebuchlayout basiert vollständig auf Templates und kann daher vollständig an die eigenen Bedürfnisse angepasst werden. Verwendet wird hier das freie PHP Templatesystem Smarty von http://www.smarty.net. Eine Vollständige Dokumentation des Templatesystems kann dort eingesehen werden. Die Layouts können entweder direkt im Verzeichnis /scarbook/admin/templates/ oder in der Administration unter dem Menüpunkt "Templates" bearbeitet werden.

Gästebucheinträge: entrys.html
Neuer Eintrag: new_entry.html
Mail an Admin: mail_admin.txt
Mail an Besucher: mail_guest.txt
Mail nach Webmasterkommentierung: mail_comment.txt
Layout bei abgeschaltetem ScarBook: offline.html

Administrationslayout anpassen

Die Layouts der Administration befinden sich im Verzeichnis /scarbook/admin/templates_acp/. Sie können nur direkt in diesem Verzeichnis geändert werden. Das Entfernen des Copyrighthinweises ist auch hier nur mit gültiger Lizenz gestattet!

Templatefunktionen

Mit den Templatefunktionen können verschiedenen Funktionen des ScarBooks in vereinfachter oder auch nachträglicher Form genutzt werden. Speziell die Felddefinitionen können wahlweise auch fast vollständig über die Templatefunktionen realisiert werden. Weitere Funktionen des Tempaltesystems können Online auf http://www.smarty.net nachgelesen werden.

Zeilenumbruch (sgb_nl2br)

Alle Zeielnumbrüche werden im Text durch den HTML-Code <br> ersetzt und dadurch Sichtbar gemacht.

{$sgb_field.text|sgb_nl2br}

HTML umwandeln (sgb_htmlreplace)

HTML-Code wird umgewandelt und verliehrt so seine Wirkung, kann aber unschöne Nebeneffekte (wie das überschreiten der maximalen Wortlänge) bewirken. Siehe auch "mehrere Template Funktionen anwenden"

{$sgb_field.text|sgb_htmlreplace}

HTML entfernen (sgb_htmldelete)

HTML-Code wird aus dem Text entfernt.

{$sgb_field.text|sgb_htmldelete}

Wortlänge begrenzen (sgb_textwrap)

Begrenzt die Wortlänge in einem Text. Ist ein Wort länger als die angegebene Zeichenanzahl, wird ein <wbr> eingefügt und führt zum Zeilenumbruch (wenn notwendig). Die im Beispiel angegebene 20 steht für die maximale Wortlänge.

Hinweis
Sollte ein Link, ... länger als die Angabe sein, kann es vorkommen das auch in diesen Angaben ein <wbr> eingefügt wird.

{$sgb_field.text|sgb_textwrap:20}

BadWords (sgb_badwords)

Mit dieser Funktion werden die in der Administration angegebenen "bösen Worte" durch einen alternativen Text ersetzt. Diese Funktion sollte primär bei der Eingabe von neuen Einträgen verwendet werden (also in den Felddefinitionen aktiviert werden).

{$sgb_field.text|sgb_badwords}

BBCode (sgb_bbcode)

BBCode wird verarbeitet und durch den entsprechenden HTML-Code ersetzt. Wenn mehrere Templatefunktionen hintereinander aufgerufen werden muss dieser Befehl NACH sgb_htmldelete und sgb_htmlreplace angegeben werden.

{$sgb_field.text|sgb_bbcode}

Smilies (sgb_smilies)

Smilie-Code wird durch die Grafiken ersetzt.

{$sgb_field.text|sgb_smilies}

Admin-Del-Link (sgb_admindellink)

Erzeugt den Querystring der direkt in der Administration zur Löschseite führt.

http://examples.scar4u.de/scarbook/admin/index.php?{$sgb_field.id|sgb_admindellink}

Guest-Del-Link (sgb_userdellink)

Erzeugt den Querystring für den Guest-Del-Link.

{$smarty.server.PHP_SELF}?{$e.id|sgb_userdellink}

Leerzeichen (sgb_space)

Wenn in einem Eingabefeld keine Eingabe erfolgt ist, kommt es in Leeren Bereichen oft zu fehlerhaften Darstellungen. Diese Funktion gibt setzt für leere Eingabefelder ein geschütztes HTML-Leerzeichen nbsp;.

{$sgb_field.text|sgb_space}

Gesamten Text codieren (sgb_encodetext)

Codiert den gesamten Text in einer (Im Quellcode) unlesbaren Form. Damit kann man es Suchmachinen und Spamrobotern "erschweren" die Seiten zu lesen. Mit dieser Funktion kann aber keine 100%-ige Sicherheit garantiert werden! Der Text ist auch weiterhin innerhalb des Browsers problemlos lesbar.

{$sgb_field.text|sgb_encodetext}

Emails im Text codieren (sgb_encodeemail)

Im Text werden gefundene Emails durch codierten Text ersetzt, um die Lesbarkeit für Suchmachinen und Spamrobotern zu "erschweren". Mit dieser Funktion kann aber keine 100%-ige Sicherheit garantiert werden! Der Text ist auch weiterhin innerhalb des Browsers problemlos lesbar.

{$sgb_field.text|sgb_encodeemail}

Weitere Möglichkeiten Emails zu verschlüsseln, findet man unter:
http://www.smarty.net/manual/en/language.function.mailto.php

Mehrere Template Funktionen anwenden

Die einzelnen Funktionen können auch nacheinander durch | getrennt angegeben werden. Dabei werden die Funktionen von links nach rechts abgearbeitet.

{$sgb_field.text|sgb_smilies|sgb_badwords|sgb_wordwrap:20}