Template
Aus CavoxCms Wiki
Template-Dateien (Zu finden im Verzeichnis tpls des jeweiligen Modules, in Designverzeichnissen, und weiteren Orten) werden mit der Smarty-Template-Engine ausgeführt. Diese wurde allerdings mit vielen weiteren Funktionen erweitert. Templates können mittels Sprachdateien auch so erstellt werden, dass sie einfach in andere Sprachen übersetzt werden können.
Speicherort
Wenn im Code ein neues Template erstellt wird (z.B. mit new cView("file") ), dann sucht das System in folgender Reihenfolge nach dem Template:
- Verwendung in der Administration
- Es wird direkt im Modul-Verzeichnis gesucht: modules/modul/tpls/file.html
- Bei Views: Ist modules/modul/tpls/file.admin.html vorhanden, wird dieser bevorzugt (vor modules/modul/tpls/file.html)
- Verwendung im Frontend
- Zuerst wird im aktuellen Design gesucht: design/tpls/modul/file.html
- Dann wird im Modul-Verzeichnis gesucht: modules/modul/tpls/file.html
In der gleichen Reihenfolge wird dann auch noch die Sprachdatei (TODO: ist nicht so) (siehe auch Lokalisierung) zum Template gesucht und in der Variabel {$lang} im Template zur Verfügung gestellt.
Templates im Design anpassen
Da Templates zuerst im Design-Verzeichnis gesucht werden, kann man sie einfach "überladen" (OOP). Will man das Template eines Modules seinen ganz speziellen Wünschen anpassen, dann erstellt man im Design einfach das Verzeichnis tpls und darin ein Verzeichnis mit dem Modulnamen. Danach kopiert man das Template vom Modul ins Design, an die gleiche Stelle, wie im Modul und kann es dann - unabhängig vom Modul - anpassen.
