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
- 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 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.
Templates (oder Plugins) die im CMSimple_XH Wiki, oder im Anhang (Kapitel 6.3 (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');?>
|
Funktion |
Status |
Beschreibung |
|
editmenu() |
erforderlich |
Erzeugt im Admin-Modus das Admin-Menü. |
|
content() |
erforderlich |
Inhalt der Seite(n). |
|
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. |
|
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 Locator (Breadcrumbs). |
|
newsbox() |
zusätzlich |
Zeigt den 'Login'-Link an (sofern nicht angemeldet). |
|
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']. |
|
previouspage() |
optional |
Erzeugt einen Link zur vorherigen Seite. |
|
printlink() |
optional |
Erzeugt einen Link für die Druckansicht. |
|
searchbox() |
optional |
Erzeugt das Suchfeld. |
|
sitename() |
optional |
Zeigt den Inhalt der Sprachvariable $tx['site']['title']. |
|
sitemaplink() |
optional |
Liefert einen Link zur Sitemap. |
|
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/wiki/doku.php/de:template_tags)
Definition des Standards im Template
Die aktuelle Einstellung des CMSimple_XH Standards (html- oder xhtml-Code) ist im Adminbereich unter "Einstellungen" => "Editieren Konfiguration" (alternativ "CMS") => "xhtml_endtags:" hinterlegt.
Bei einem leeren Eingabefeld wird html-Quelltext erzeugt und bei einem Eintrag "true" erzeugt der FCKeditor 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_endtags:", 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 » |