zum Hauptinhalt springen

Vorlagen (templates)

Sämtliche HTML-Vorlagen befinden sich im Webspace unter "media/layout/template". Wenn Sie Vorlagen anpassen möchten, sollten Sie nie die Originaldatei ändern, sondern eine Kopie erstellen und dem Namen einen aussagekräftigen Zusatz verpassen. Ansonsten würden ihre Änderungen beim nächsten System Update überschrieben werden.

Folgende Platzhalter können generell in Vorlagen (auch in E-Mail Vorlagen) verwendet werden:

  • pageUrl::*
  • fileUrl::*
  • lang::*
  • func::*
  • currentUrl
  • csrf_token

bei pageUrl (Link auf eine interne Seite) und fileUrl (Link auf das Original einer Datei) ersetzen Sie den Stern durch die ID des Datensatzes. Sie finden die Kennung (ID) von Seiten und Medien in der Überschrift über der Eingabemaske beim Bearbeiten des betreffenden Datensatzes.
Bei "lang" handelt es sich um einen Übersetzungstext. Hier setzen Sie statt dem Stern den Variablennamen aus dem Menüpunkt "Übersetzungen" ein.
Der gesamte Ausdruck muss dabei von doppelten Prozentzeichen eingeschlossen werden, also z.B. pageUrl::25, um die URL der Seite mit der ID 25 einzufügen.
Manche Vorlagen enthalten auch noch weitere Platzhaltertypen, die vom Inhaltselement dynamisch ersetzt werden.
PHP Funktionsaufrufe können über func eingebunden werden. Welche Parameter an die Funktion übergeben werden, ist im jeweiligen Template zusammen mit einem Beispiel dokumentiert.

Mittels currentUrl kann man die Url der aktuellen Seite einbinden.

csrf_token wird durch den Wert des Sicherheitstokens der aktuellen Sitzung ersetzt und dient in Formularvorlagen dazu, sicher zu stellen, dass das Formular nicht über einen CSRF Betrugsversuch versendet wurde.

Vorlagen
Vorlagen (templates)

Beispiel: individuelles Loginformular

elLogin.html
Vorlage elLogin.html (Loginformular)

Zunächst kopiert man die Datei "elLogin.html" in den Ordner "custom". Dort kann man den Inhalt anpassen. Sobald mehr als eine Vorlagendatei existiert, die mit "elLogin" beginnt, erscheint in der Eingabemaske von Elementen des Typs "Login" ein Auswahlfeld für die Vorlage. Wenn Sie also mehr als eine individuell angepasste Variante benötigen, nennen Sie die nächste Kopie z.B. "elLogin-2.html" und sie wird ebenfalls erkannt.