CMS - Workbench | DE


Templating and Coding for CMS (WordPress, Bludit, Automad, Typesetter, GetSimple, Pico and more)


Smarty Strukturtemplate

Dieser Template-Ansatz mit dem Smarty-Framework verfolgt einen eher generischen Ansatz und reduziert damit die Programmlogik.

Ziel dieses Ansatzes ist es die Template-Engine gleichförmig, homogen zu gestalten und komplexe Programmlogik zu entfernen. Die Arbeit der Template-Engine Smarty wird dabei auf immer wiederkehrende gleichartige Module verteilt.

Im wesentlichen wird die eigentliche Arbeit des Templateparsers Smarty auf die fünf Module aufgeteilt.

index.php
render.php
template.html
post.txt
config.conf

Der Ansatz ist wie folgt: jeder Post wird in ein eigenes Verzeichnis abgelegt, das den Namen des Beitrags trägt. In jedem dieser verschiedenen Verzeichnisse liegen immer die gleichen Module:

index.php
config.conf
post.txt

Die Datei index.php bindet die eigentliche Smarty-Umgebung ein. Die Datei config.conf enthält Zusatzdaten - derzeit die Navigation zum übergeordneten Verzeichnis. Zu guter letzt, nimmt post.txt den Inhalt des Beitrags auf. Die Module besitzen immer den gleichen Inhalt, lediglich post.txt enthält unterschiedliche Beitragstexte - logisch.

Der Vorteil

Sie können den Content beliebig tief mit thematischen Unterordnern oder Kategorien schachteln, Sie müssen lediglich dafür sorgen, das der per URL gerufene Ordner diese drei Module enthält. Sie können demzufolge neue Ordner anlegen und kopieren diese Module einfach aus einem anderen Vorlage-Ordner dort hinen.

index.php

Die Datei index.php dient dazu das Script render.php zu laden und eine Path-Variable zu setzen. Das Script selbst ist recht übersichtlich:

001  <?php
002     $path = "";
003     include $path.'render/render.php';
004     // $path= dient dazu, das z.B. der CSS-Style aus jeder Ordnerstruktur 
005     // geladen werden kann.
006  ?>

Die Variable $path wird vom render.php genutzt, um in den Templates den Pfad hoch zur root festzulegen, damit diese auch die CSS-Styles laden können. Folglich ist die Variable $path auf der Startseite leer, im ersten Unterordner "../", im zweiten Unterordner "../../", im dritten Unterordner "../../../" usw.

Das ist im übrigen die einzige Anpassung die Sie vornehmen müssen, damit dieses Template-Modell funktioniert.

config.conf

Die Konfigurationsdatei nimmt Zusatzinformationen zum Post auf, die zunächst nichts mit dem Text zu tun haben, derzeit ist es die Navigation zum übergeordneten Verzeichnis.

navigation = "<a href="http://cmsworkbench.de/index.php">« zurück</a>"

Jede diese config.conf enthält diese HTML-Angabe und springt in der Verzeichnisstruktur eine Ebene nach oben. Der Inhalt der Templatevariablen wird in das Template gesetzt.

post.txt

Die Datei post.txt nimmt den eigentlichen Beitragstext auf und hat die folgende Struktur:

Titel des Beitrags
~~~
beitragsbild.jpg
~~~
Den Anleser hier eintragen
~~~
Der Haupt-Text Ihres Beitrags... beliebig viel Text.
~~~
Name der zu ladenden Template-Datei
~~~
Kategorie
~~~
Name des Autor
~~~
2020-06-01
~~~
Schlagwort-1,Schlagwort-2, ...
~~~
Meta-Beschreibung

Der Beitragstext ist mit Delimittern ~~~ versehen, damit render.php die einzelnen Sektionen später an die richtigen Stellen des Templates kopieren kann.

render.php

Der Renderer dieser Template-Engine ist klassisch aufgebaut und enthält keinerlei Logik. Er sorgt dafür, das der Inhalt der Datei post.txt in die passenden Templatevariablen kopiert wird.

001  <?php
002      require_once($path.'libs/Smarty.class.php');  // $path-Variable + Verzeichnis
003      $smarty               = new Smarty();
004      $smarty->template_dir = $path.'templates';    // $path-Variable + Verzeichnis
005      $smarty->compile_dir  = $path.'templates_c';  // $path-Variable + Verzeichnis
006      $smarty->config_dir   = '.';                  // immer das Config-File im aktuellen Verzeichnis suchen
007    
008      $smarty->configLoad('config.conf');           // config.conf des aktuellen Verzeichnis laden
009      $navigation = $smarty->getConfigVars('navigation');
010
011      $fileContent = file_get_contents ("post.txt");
012      $textBausteine = explode("~~~", $fileContent);
013
014      $smarty->assign('path',            trim($path)); // $path-Variable auch in das Template damit CSS geladen wird
015      $smarty->assign('title',           trim($textBausteine[0]));
016      $smarty->assign('teaser',          trim($textBausteine[1]));
017      $smarty->assign('headline',        trim($textBausteine[2]));
018      $smarty->assign('content',         trim($textBausteine[3]));
019      $smarty->assign('template',        trim($textBausteine[4]));
020      $smarty->assign('categorie',       trim($textBausteine[5]));
021      $smarty->assign('author',          trim($textBausteine[6]));
022      $smarty->assign('date',            trim($textBausteine[7]));
023      $smarty->assign('metakeywords',    trim($textBausteine[8]));
024      $smarty->assign('metadescription', trim($textBausteine[9]));
025      $smarty->assign('status',          trim($textBausteine[10]));
026      $smarty->assign('navigation',      trim($navigation));
027
028      $smarty->display(trim($textBausteine[4]));
029  ?>

Sie können bereits die Variable $path erkennen, die eine Pfadangabe zum übergeordneten Verzeichnis darstellt. Diese ist erforderlich, damit der Parser immer seine benötigten Verzeichnisse, wie templates, finden kann.

template-*.html

Zum Schluss fehlt noch das Template selbst, das Smarty für die Darstellung nutzen soll. Alle Templates werden aus dem Verzeichnis templates bezogen (ich drucke den Code hier nicht ab, da bekannt sein sollte wie die Smarty-Templates funktionieren).

Wie bereits im Beitrag erwähnt, der Ansatz ist simpel, denn alles wird mit gleichartigen Modulen identisch verarbeitet. Landingpages und Beiträge sind technisch betrachtet daher gleich, lediglich Landingpages enthalten statt des Beitragstextes ein individuelles Menü-Layout das Sie slebst mit Bootstrap-Mitteln frei anlegen können - schauen Sie sich bitte das Beispiel im Download genau an).

22.11.2020 • Smarty • Parser


Oliver Lohse - Ich bin diplomierter Wirtschafts-Informatiker und Organisations-Programmierer in verschiedenen Sprachen bzw. Markup-Dialekten, z.B.: Java, JEE, COBOL, PHP, Python, MySQL, HTML, CSS, ANSI C, Lisp, Rexx, JavaScript, Scheme, ActionScript 2.0, Maschinensprache, Assembler und JCL. Seit mehr als 22 Jahren arbeite ich in einem grossen Softwareunternehmen in Niedersachsen. Sie sehen auf dieser Seite mein eigens für Bludit CMS entwickeltes Theme "Reaktor-Block IV".

Kontakt: Κontakt@Οliver-Lohse.de


Empfehlungen:



JS-Mini-CMS

Der große Vorteil dieses JS Template-Parsers ist, er benötigt keinen Server oder eine Datenbank und läuft auf allen Endgeräten mit Web-Browser.

mehr...

PHP Template Engine 2

Ein sehr logik-armer PHP Template-Parser der sogar in der Lage ist beliebig komplexe Ordnerstrukturen abzubilden.

mehr...

PHP Template Engine 3

Ein sehr logik-armer PHP Template-Parser der sogar in der Lage ist beliebig komplexe Ordnerstrukturen abzubilden.

mehr...

PHP Template-Engine 1

Ein sehr logik-armer PHP Template-Parser der sogar in der Lage ist beliebig komplexe Ordnerstrukturen abzubilden.

mehr...

SimplePHP

SimplePHP ist eine leicht beherrschbare Template-Engine ohne externe Abhängigkeiten.

mehr...



CMS Workbench

Hilfreiche Tipps, Tricks, Codings und Codeschnipsel, die im Rahmen der Entwicklung, Weiterentwicklung und Templatings zum Thema CMS immer wieder benötigt werden - aus verschiedenen Sprachdialekten wie Java, JavaScript, PHP, Python und anderen.