Dies ist eine alte Version des Dokuments!
Bei den Markups geht es um die Platzhalter, die BlackCat CMS mit Leben füllt. Neben den grundlegenden Platzhaltern für Seiteninhalt, Menü, Kopf- und Fußdateien (also CSS, META, Javascripts) existieren eine Reihe weiterer, die dem Designer flexible Möglichkeiten an die Hand geben, um die Darstellung zu steuern.
Der Seitenkopf ist der Teil, der im <head>
-Bereich einer Seite benötigt wird. Dieser beinhaltet neben dem Seitentitel (<title>
), Schlüsselworten (keywords
) und Beschreibung (description
) auch weitere META-Tags, einzubindende CSS- und JavaScript-Dateien sowie ggfs. browserspezifische Angaben.
BlackCat CMS hält hierfür ein einziges Markup bereit, das alles Nötige erledigt:
{get_page_headers()}
Referenzen:
http://docs.blackcat-cms.org/benutzerhandbuch/Headerersetzen.html
https://github.com/webbird/BlackCatCMS/wiki/get_page_headers (Englisch)
Analog zum Seitenkopf existiert ein Markup, um JavaScripts in den Seitenfuß (in der Regel vor dem schließenden </body>
) einzufügen.
{get_page_footers()}
Referenzen:
https://github.com/webbird/BlackCatCMS/wiki/get_page_footers (Englisch)
Das Wichtigste an einer Seite ist natürlich der Inhalt. Um diesen an der entsprechenden Stelle im Template zu platzieren, wird der Platzhalter
{page_content()}
verwendet. Hier werden nun alle Sektionen - also die Module, die mit einer Seite verknüpft sind - hintereinander weg ausgegeben. Die Reihenfolge bestimmt man im Backend.
Ein Template kann mehrere Bereiche haben, an denen Inhalte ausgegeben werden, z.B. einen Hauptbereich in der Mitte und einen weiteren am rechten oder linken Rand, um etwa einen RSS-Feed einzubinden oder eine Liste der aktuellsten Neuigkeiten anzuzeigen. Um dies entsprechend steuern zu können, kann in den Klammern des Platzhalters eine Zahl angegeben werden, die der Nummer des Blocks entspricht. Welche Blöcke es gibt und welche Nummern sie haben, bestimmt die Datei info.php
des Templates.
TODO: Weiterführende Links
Dank des Markup {get_page_headers()}
müssen Seitentitel & Co. nicht mehr einzeln in den Seitenkopf eingetragen werden. Aber vielleicht braucht man sie auch mal an anderer Stelle. Daher existieren folgende Markups (weiterhin, aus Sicht von Website Baker):