Templates anlegen

Templates können grundsätzlich Seiten- oder Content-Templates sein. Ein Seiten-Template definiert das Raster einer Seite. Content-Templates sind nötig, um einer Seite Content hinzu fügen zu können. Die Templates werden vom Entwickler per FTP in das entsprechende Verzeichnis hochgeladen und dann im Backend in das System importiert.

Templates sind in Gruppen organisiert. Innerhalb der Navigation ist es so zum Beispiel möglich, einer Menügruppe eine Templategruppe zuzuordnen. In dem Fall werden alle Templates der betreffenden Menügruppe aus dieser Templategruppe geladen. Um das Projekt übersichtlicher zu strukturieren ist es möglich, beim Anlegen der Templategruppen Unterverzeichnisse zu nutzen. Innerhalb einer Templategruppe werden Content-Bereiche definiert. Sie unterteilen Page-Templates in einzelne Sektionen und sind nötig, um einem Template später Content hinzufügen zu können.

Templategruppen einrichten

1.Im Backend eine neue Templategruppe anlegen und optional das Verzeichnis angeben falls sich die Templates in einem Unterverzeichnis befinden.2.Für jedes Page-Template muss mindestens ein Content-Bereich definiert werden, damit dem Template später Content zugeordnet werden kann. Das geschieht duch Click auf das entsprechende Icon in der Übersicht der Templategruppen.

Feldname
Beschreibung
NameName der Templategruppe
UnterverzeichnisOptionales Unterverzeichnis
DefaultDie Default-Templategruppe wird immer dann verwendet wenn einer Menügruppe (Navigation und Content) keine Templategruppe explizit zugewiesen wurde
Master ThemeDas Feld dient nur der Information und zeigt aus welchem Verzeichnis die Templates geladen werden (wird nur angezeigt falls das Projekt ein optionales Theme verwendet)

Templates sind in einzelne Content-Bereiche unterteilt (diese könnten z.B. eine Bühne, ein Bereich für Artikel und eine Marginalspalte sein). Ohne die Definition und Zuordnung von Content-Bereichen lässt sich im Backend kein Content für dieses Template anlegen.

Content-Bereiche anlegen

1.Content-Bereiche werden im Backend durch Click auf das entsprechende Icon in der Übersicht der Templategruppen angelegt2.Einen neuen Content-Bereich anlegen und einen Identifier (zur Abfrage innerhalb des Template-Files) plus Namen vergeben.

Feldname
Beschreibung
IdentIdentifier der innerhalb der Templates genutzt wird, um einen Bereich zu definieren
NameName der bei der Auswahl der Bereiche im Backend angezeigt wird

Unterhalb der Templategruppen werden die Templates angelegt. Grundsätzlich wird zwischen drei Arten von Templates unterschieden: STANDARD, CONTAINER und CONTENT. Das Standard-Setup lädt eine Seite und den im Backend definierten Content. Die Nutzung von Containern erlaubt es, ein Seiten-Raster (z.B. Header, Body, Navi) anzulegen und innerhalb des Rasters unterschiedliche Seiten-Layouts zu laden. Content-Templates sind notwendig, um den Content einer Seite über das Backend zu ändern. Weitere Informationen dazu finden sich im Developer's Guide. Die in den Templategruppen definierten Bereiche werden hier dem Template zugewiesen.

Standard-Template Setup

1.Die Template-Datei muss vom Entwickler per FTP in das Template-Verzeichnis dieser Gruppe (s.o.) hochgeladen werden. Es ist wichtig, dass der Dateiname das korrekte Prefix erhält.2.Anschließend wird das Template in das Backend importiert und die unten beschriebenen Felder ausgefüllt.3.In der Übersicht gibt es noch die Möglichkeit, ein Seiten-Template als DEFAULT für diese Templategruppe zu definieren. Diese Template wird immer dann verwendet wenn vom Anwender für einen Menü-Eintrag kein Template ausgewählt wurde.

Feldname
Beschreibung
TypDer Template-Typ, im Normalfall ein STANDARD-Template. Im Developer's Guide finden sich weitere Informationen zur Nutzung und zum Aufbau von Templates< STANDARD >
Das Standard-Template ist der Normalfall und stellt ein gewöhnliches Seiten-Template dar. Alle anderen Template-Typen werden weiter unter beschrieben.
BereichAuswahl der Bereiche über die dieses Template verfügt, z.B. einen Content-Bereich und eine Marginalspalte.
NameDer Name der bei der Auswahl der Templates angezeigt wird.
TemplateDie Template-Datei die vorher per FTP im Template-Verzeichnis abgelegt wurde. Achtung: Ist der Dateiname mit einem Sternchen* gekennzeichnet, so befindert sich die Datei NUR in dem Verzeichnis das als Preview-Theme gewählt wurde und steht somit nur im Preview-Mode zur Verfügung. Zur Anzeige im Live-Modus müsste es anderenfalls auch in das entsprechende Verzeichnis unterhalb des Live-Themes auf dem Server kopiert werden.
Dynamische URLDie Nutzung dynamischer URLs ist in einem eigenen Abschnitt beschrieben.
(Usage)Zeigt an wie oft dieses Template derzeit in Benutzung ist
(Default)Auswahl des Default-Templates erfolgt in der Übersicht der Template-Gruppe. Wird kein Template gewählt wird per Default die Datei html_page.php benutzt.


Templates vom Typ Container besitzen ein übergeordnetes Template, ein Raster in dem der Header und ggf. Body und Navigation definiert werden. So lassen sich verschiedene Layouts für einzelne Seiten definieren, ohne das Seitenraster jedes Mal anlegen und pflegen zu müssen. Ein weiteres Anwendungsbeispiel sind One-Page Websites bei denen der gesamte Content einer Seite unter der gleichen URL mit unterschiedlichen Anker-Tags abrufbar ist.

Container Setup

1.Mit einem Text-Editor ein Content-Template anlegen und unter einem sinnvollen Namen speichern. Hier ist es wichtig, das richtige Prefix zu wählen, also z.B. html_ für HTML-Dateien.2.Anschließend wird das Template in das Backend importiert und die unten beschriebenen Felder ausgefüllt.3.Die Bereiche wählen, über die dieses Template verfügen soll. Das Anlegen der Content-Bereiche geschieht innerhalb der Template-Gruppe (s.o.)4.In der Übersicht gibt es noch die Möglichkeit, ein Seiten-Template als DEFAULT für diese Templategruppe zu definieren. Diese Template wird immer dann verwendet wenn vom Anwender für einen Menü-Eintrag kein Template ausgewählt wurde.

Feldname
Beschreibung
Typ< CONTAINER >
Für dieses Tempalte wird ein weiteres Template benötigt, welches das Seiten-Raster enthält.
BereichAuswahl der Bereiche über die dieses Template verfügt, z.B. einen Content-Bereich und eine Marginalspalte.
NameDer Name der bei der Auswahl der Templates angezeigt wird.
TemplateDie Template-Datei die vorher per FTP im Template-Verzeichnis abgelegt wurde. Achtung: Ist der Dateiname mit einem Sternchen* gekennzeichnet, so befindert sich die Datei NUR in dem Verzeichnis das als Preview-Theme gewählt wurde und steht somit nur im Preview-Mode zur Verfügung. Zur Anzeige im Live-Modus müsste es anderenfalls auch in das entsprechende Verzeichnis unterhalb des Live-Themes auf dem Server kopiert werden.
ParentDer Name des Templates welches das Seiten-Raster enthält. Aus dem Parent-Template heraus wird dann dieses Template geladen.
Dynamische URLDie Nutzung dynamischer URLs ist in einem eigenen Abschnitt beschrieben.
(Usage)Zeigt an wie oft dieses Template derzeit in Benutzung ist
(Default)Auswahl des Default-Templates erfolgt in der Übersicht der Template-Gruppe. Wird kein Template gewählt wird per Default die Datei html_page.php benutzt.


Content-Templates sind erforderlich, um den Content einer Seite über das Backend pflegen zu können. Das Template kann entweder die Standard-Datenfelder nutzen oder es kann für den Zugriff auf eigene SQL-Tabellen konfiguriert werden.

Content-Templates anlegen

1.Die Template-Datei per FTP in das Template-Verzeichnis dieser Gruppe (s.o.) hochladen. Es ist wichtig, dass der Dateiname das korrekte Prefix erhält.2.Im Backend das Template anlegen und die unten beschriebenen Felder ausfüllen. Besonders zu beachten sind dabei die Felder zur Datenanbindung die im folgenden Abschnitt genauer beschrieben werden.

Feldname
Beschreibung
Typ< CONTENT >
Template zur Anzeige des Seiten-Contents
BereichAuswahl des Bereichs in dem dieses Content-Element angezeigt werden soll.
NameDer Name der bei der Auswahl der Templates angezeigt wird.
TemplateDie Template-Datei die vorher per FTP im Template-Verzeichnis abgelegt wurde.
Daten< OHNE >
Template besitzt keine Daten die im Backend änderbar sind
< DEFAULT >
Es stehen eine Reihe von Standard-Datenfeldern zur Verfügung, die im folgenden Schritt ausgewählt werden. Der Import einer Datentabelle ist nicht nötig, um mit dem Template arbeiten zu können.
< Tabellenname >
Das Template wird an eine importierte Datentabelle angebunden
Filter< SHOW ALL >
Diese Option steht nur zur Verfügung wenn im Daten-Feld eine Tabelle gewählt wurde. In dem Fall lädt das Template alle Datensätze dieser Tabelle.
< SINGLE RECORD >
Das Template lädt einen einzigen Datensatz.
< MULTIPLE RECORDS >
Diese Option steht nur zur Verfügung wenn im Daten-Feld DEFAULT gewählt wurde. In diesem Fall verfügt das Template über mehrere Datensätze (z.B. die Bilder einer Galerie). Der Unterschied zu SELECT PARENT liegt darin, dass das Template hier die Default-Datenfelder verwendet.
< SELECT PARENT >
Diese Option steht nur zur Verfügung wenn im Daten-Feld eine Tabelle gewählt wurde. Es werden alle Datensätze geladen, die zum gewählten Datensatz der Parent-Tabelle gehören (z.B. alle Bilder einer Galerie). Der Unterschied zu MULTIPLE RECORDS liegt darin, dass das Template hier auf einer eigenen Datenquelle/ Tabelle basiert.
DatenfelderAuswahl der Datenfelder über die das Template verfügen soll. Steht nur für Templates mit DEFAULT-Daten zur Verfügung.
WählbarDiese Option steht nur zur Verfügung wenn im Daten-Feld eine Tabelle gewählt wurde. Wird diese Option gewählt so lässt sich ein Datensatz der Tabelle mehrfach verwenden, d.h. ein Datensatz kann im gleichen Template auf mehreren Unterseiten angezeigt werden. Bei Änderungen muss dieser Datensatz dann nur ein einziges Mal bearbeitet werden. So lassen sich Redundanzen und Mehrarbeit verhindern.

Views sind Ansichten oder Eigenschaften eines Templates. Diese werden im Content-Bereich ausgewählt und können bei der Programmierung des Templates aufgegriffen werden (z.B. könnte ein View 'yellow' heißen und im Programm-Code des Templates wird der Hintergrund gelb gefärbt). Bei der späteren Verwendung können Seiten-Templates mehrere Ansichten gleichzeitig besitzen, Content-Templates nur eine zur Zeit.

VIEWS verwenden

1.Die Ansichten eines Templates werden im Template-Bereich des Backends angelegt2.Es muss eine Klasse (zur Verwendung im Programmcode) und ein Name (zur Auswahl im Backend) vergeben werden.3.Im Programmcode des Templates wird der View mit der entsprechenden API Methode abgefragt und verarbeitet.

Feldname
Beschreibung
ClassEin frei wählbarer Klassen-Name für diese Ansicht/ Eigenschaft
NameDer Name der bei der Auswahl im Backend angezeigt wird