5.5.1 Grundsätzliches und (System-) Anforderungen
Alle CMSimple_XH Templates müssen mindestens eine der beiden Markupsprachen unterstützen:
- H für HTML 4.01 Transitional bzw. HTML 5
- X für XHTML 1.0 Transitional
- XH für Plugins die für beide Markupsprachen valide sind.
Bevor die Seiten der CMS Installation mit Inhalten gefüllt werden, sollte in der CMS Konfiguration entschieden (und eingetragen) werden, welche Markup-Sprache (html 4.01 transitional bzw. HTML 5 oder xhtml 1.0 transitional) benutzt werden soll, da CMSimple_XH beide Markup-Sprachen unterstützt.
Wenn die Templates den Vorgaben und Qualitätskriterien von CMSimple_XH nicht entsprechen, dann werden sie zwar nicht mehr den international anerkannten Webstandards entsprechen, aber vermutlich nicht abstürzen.
Im Selfhtml-wiki befindet sich ein Tutorial, indem die moderne HTML-Seitenstruktur mit den neuen HTML5-Elementen beschrieben wird: http://wiki.selfhtml.org/wiki/HTML/Tutorials/HTML5-Grundstruktur
Templates (oder Plugins) die im CMSimple_XH Wiki, oder im Anhang (Kapitel 6.1.5 (Referenzliste zu vorhandenen Templateanbietern)) dieser Bedienungsleitung gelistet sind, verhalten sich entsprechend der Einstellung von xhtml_endtags in der CMSimple Konfiguration automatisch standardkonform.
Bei den nicht in diesen Quellen aufgelisteten Templates sollte darauf geachtet werden, dass die DTD (Doctype Deklaration) des Templates mit den Einstellungen für "xhtml_endtags:" mit der von Ihnen eingesetzten Konfiguration übereinstimmen und alle den entsprechenden Standard installierten Plugins unterstützen.
Installation und Aufbau von Templates
- CMSimple_XH-Templates werden üblicherweise als ZIP-Dateien zum Download angeboten, die nach dem Download auf den lokalen Rechner entpackt werden.
- Ein CMSimple_XH-Template bestehen in seiner minimalen Ausführung üblicherweise aus der template.htm, stylesheet.css und einem images/ Ordner, die in einem Ordner mit dem Namen des Templates gespeichert sind.
- Auf dem Webserver gibt es im CMSimple_XH-Installationsverzeichnis den Ordner "templates", der für jedes Template einen Ordner mit dem Namen des Templates enthält. In diesen Ordner "templates" wird das neue Template kopiert und steht nach dem Login im Adminbereich zur Nutzung zur Verfügung.
- Für die Onlinebearbeitung des Templates unter CMSimple_XH müssen die Dateieigenschaften von template.htm und stylesheet.css auf beschreibbar gesetzt werden.
Verwendbare Template tags im Template:
Im folgenden Beispiel wird die Einbindung der (versteckten) CMSimple_XH Seite News01 als Newsbox an der Stelle im Template mit Hilfe des Template tags gezeigt, an der dieser Code im Template steht:
<?php echo newsbox('News01');?>
Die folgende (komprimierte) Auflistung von Funktionen müssen bzw. können im Template verwendet werden:
Funktion | Status | Beschreibung |
---|---|---|
content() | erforderlich | Inhalt der Seite(n). |
editmenu() | erforderlich | Erzeugt bis CMSimple_XH 1.5 im Admin-Modus das Admin-Menü und wird in neueren Template nicht benötigt. |
guestbooklink() | Historie | Erzeugte bis CMSimple_XH 1.0 einen Link für das Gästebuch und ist seit CMSimple_XH 1.5.4 definitiv "veraltert" und sollte nicht mehr genutzt werden. |
head() | erforderlich | Erzeugt Tags zu Stylesheet, Meta-Daten und Seiten-Titel. |
languagemenu() | empfohlen | Liefert Links für mehrsprachige Seiten. |
lastupdate() | empfohlen | Liefert Zeit/Datum der letzten Änderung. |
legallink() | empfohlen | Erzeugt einen Link zu den Copyright- und Lizenzinformationen. Ab CMSimple_XH 1.5.8 |
li($c,'menulevel') | optional | Erzeugt Menü inkl. Untermenüs. |
locator() | optional | Erzeugt den Locator (Breadcrumbs). |
loginlink() | empfohlen | Zeigt den 'Login'-Link an (sofern nicht angemeldet). |
mailformlink() | optional | Erzeugt den Link zum Kontaktformular, wenn unter "Einstellungen" => "CMS" => "E-Mail-Formular" eine Mailadresse eingetragen ist. |
nextpage() | optional | Erzeugt einen Link zur nächsten Seite. |
onload() | erforderlich | Erforderlich im Body-Tag für die Funktionen des Editors. |
pagename() | optional | Zeigt den Inhalt der Konfigurationsvariable $cf['site']['title']. Diese Variable wird aus der Sprachvariable $tx['site']['title'] erzeugt. Wenn der Titel für eine bestimmte Seite per meta_tags Plugin verändert wird, wird für diese Seite der geänderte Titel angezeigt. |
previouspage() | optional | Erzeugt einen Link zur vorherigen Seite. |
printlink() | optional | Erzeugt einen Link für die Druckansicht. |
searchbox() | optional | Erzeugt das Suchfeld. |
sitemaplink() | optional | Liefert einen Link zur Sitemap. |
sitename() | optional | Zeigt den Inhalt der Sprachvariable $tx['site']['title']. |
submenu() | optional | Erzeugt Links zu Unterseiten (sofern vorhanden). |
toc() | erforderlich | Erzeugt das Menü. |
top() | optional | Erzeugt einen Link zum Anfang der Seite (#TOP). |
(Quelle: http://www.cmsimple-xh.org/dev-doc/php/XH/_cmsimple---tplfuncs.php.html)
Definition des Standards im Template
Die aktuelle Einstellung des CMSimple_XH Standards (html- oder xhtml-Code) ist im Adminbereich unter "Einstellungen" => "CMS" => "XHTML:" => "konform" hinterlegt.
Bei einer leeren Checkbox wird html-Quelltext erzeugt und bei aktivierter Checkbox erzeugt der TinyMCE xhtml-Quelltext.
Im Template wird als allererstes (ganz oben) der Dokumententyp festgelegt, der dem Browser mitteilt, nach welchem Standard er Ihre Seite anzeigen soll.
Doctype html 4.01 transitional:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
Doctype xhtml 1.0 transitional:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
Dynamische Erzeugung des Doctypes für CMSimple_XH:
<?php
if ($cf['xhtml']['endtags'] == 'true') {
echo '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">'."\n".
'<html xmlns="http://www.w3.org/1999/xhtml">'."\n";
} else {
echo '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">'."\n".'<html>'."\n";}
?>
Mit diesem Code im Template wird die DTD dynamisch, entsprechend der Einstellung unter "XHTML:" => "konform", in die Website eingefügt. Diese Templates unterstützen also beide Markup Sprachen oder Dokumententypen.
Eine ausführlichere Beschreibung befindet sich im Kapitel 5.10.2 ("Architektur" => "Konventionen für (X)HTML" => "Doctype Declaration").
Weiterführende Informationen zu den Code Konventionen von Templates befinden sich im WiKi
http://www.cmsimple-xh.org/wiki/doku.php/de:code_conventions
« vorige Seite | Seitenanfang | nächste Seite » |