- - - By CrazyStat - - -

CMSimple_XH (1.6.X) Dokumentation



(Version 1.0.7 vom 13.11.2017)

Sie sind hier: Startseite > Architektur > Templates > Grundsätzliche Anforderungen

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:

FunktionStatusBeschreibung
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