Templatesystem: Unterschied zwischen den Versionen

Aus sourceDESK Wiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: „Wir verwenden als Template-System die freie Software [http://www.smarty.net/ Smarty], für eine vollständige Befehlsreferenz verwenden Sie bitte die dortige […“)
 
 
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 7: Zeile 7:
 
Sie können ein Datum mit dem in den Lokalisierungs-Einstellungen ausgewählten Format versehen. Dazu verwenden Sie in Smarty den folgenden Code:
 
Sie können ein Datum mit dem in den Lokalisierungs-Einstellungen ausgewählten Format versehen. Dazu verwenden Sie in Smarty den folgenden Code:
  
<source>
+
<source lang="smarty">
 
{dfo d=0 m=1 s=0 t="-"}
 
{dfo d=0 m=1 s=0 t="-"}
 
</source>
 
</source>
Zeile 32: Zeile 32:
 
Sie können eine Zahl mit dem in den Lokalisierungs-Einstellungen ausgewählten Format versehen. Dazu verwenden Sie in Smarty den folgenden Code:
 
Sie können eine Zahl mit dem in den Lokalisierungs-Einstellungen ausgewählten Format versehen. Dazu verwenden Sie in Smarty den folgenden Code:
  
<source>
+
<source lang="smarty">
 
{nfo i=1}
 
{nfo i=1}
 
</source>
 
</source>
  
 
Der angegebene Parameter '''i''' muss die zu formatierende Zahl enthalten. Es wird immer eine formatierte Zahl mit zwei Nachkommastellen zurückgegeben.
 
Der angegebene Parameter '''i''' muss die zu formatierende Zahl enthalten. Es wird immer eine formatierte Zahl mit zwei Nachkommastellen zurückgegeben.
 +
 +
== Betrag formatieren ==
 +
Sie können einen Betrag (dieser muss vorher mit '''nfo''' formatiert werden) mit folgendem Code in Smarty formatieren:
 +
 +
<source lang="smarty">
 +
{infix n="1,23" c="base"}
 +
</source>
 +
 +
Der angegebene Parameter '''n''' muss den zu formatierenden Betrag enthalten. Der Parameter '''c''' legt die Währung fest und kann die Werte "base" (Basiswährung), "choosed" (derzeit gewählte Währung) und jeden eingerichteten Währungscode annehmen.
 +
 +
== Produkt-Infos ==
 +
Sie können an beliebiger Stelle Infos zu einem Produkt ausgeben lassen. Dazu verwenden Sie folgenden Smarty-Code:
 +
 +
<source lang="smarty">
 +
{product h="1" c="1" p="456"}
 +
</source>
 +
 +
Der boolesche Parameter '''h''' gibt an, ob der Header für das Produkt angezeigt werden soll, mit dem booleschen Parameter '''c''' legen Sie fest, ob eine Währungsauswahl gezeigt werden soll. '''p''' müssen Sie mit der ID des Produkts füllen.
 +
 +
== Produkte einer Kategorie ==
 +
Sie können an beliebiger Stelle die Produkte einer Produkt-Kategorie ausgeben lassen. Dazu verwenden Sie folgenden Smarty-Code:
 +
 +
<source lang="smarty">
 +
{group h="1" c="1" g="456"}
 +
</source>
 +
 +
Der boolesche Parameter '''h''' gibt an, ob der Header für die Gruppe angezeigt werden soll, mit dem booleschen Parameter '''c''' legen Sie fest, ob eine Währungsauswahl gezeigt werden soll. '''p''' müssen Sie mit der ID der Gruppe füllen.
 +
 +
== CSRF-System ==
 +
sourceDESK nutzt [[CSRF-Token]], um Angriffe zu blockieren. Den Token erhalten Sie in Templatedateien mit '''{ct}''', mit '''{cf}''' erhalten Sie ein passendes HTML-Hidden-Form-Element.

Aktuelle Version vom 5. Oktober 2018, 13:18 Uhr

Wir verwenden als Template-System die freie Software Smarty, für eine vollständige Befehlsreferenz verwenden Sie bitte die dortige Dokumentation.

Template-Dateien

Die Template-Dateien liegen normalerweise in dem Verzeichnis templates im Hauptverzeichnis Ihrer Installation. Es ist möglich, dass Themes einzelne Template-Dateien überschrieben, diese finden Sie dann in themes/THEME-NAME/templates - wenn dort eine Datei mit gleichem Namen liegt wie eine im Standard-Verzeichnis, wird diese bevorzugt. Die wichtigste Datei ist die layout.tpl, sie definiert das Grundlayout des Templates und inkludiert die aktuelle Seite.

Datum formatieren

Sie können ein Datum mit dem in den Lokalisierungs-Einstellungen ausgewählten Format versehen. Dazu verwenden Sie in Smarty den folgenden Code:

{dfo d=0 m=1 s=0 t="-"}

Die angegebenen Parameter enthalten in diesem Beispiel die Standardwerte.

d

Hier kann ein UNIX-Timestamp oder ein durch PHP lesbares Datum (z.B. 01.01.2015 10:00) angegeben werden.

m

Dieser Parameter gibt an, ob Stunde und Minute angezeigt werden sollen (0/1).

s

Dieser Parameter gibt an, ob die Sekunde angezeigt werden sollen (0/1). Wenn der Parameter von m 0 ist, wird diese Einstellung ignoriert.

t

Mit diesem Trennzeichen wird das Datum von der Zeit getrennt. Vor und nach dem Trennzeichen wird automatisch ein Leerzeichen eingefügt. Wenn t leer ist bzw. nur aus Leerzeichen/Tabs, wird nur ein Leerzeichen zur Trennung verwendet.

Zahl formatieren

Sie können eine Zahl mit dem in den Lokalisierungs-Einstellungen ausgewählten Format versehen. Dazu verwenden Sie in Smarty den folgenden Code:

{nfo i=1}

Der angegebene Parameter i muss die zu formatierende Zahl enthalten. Es wird immer eine formatierte Zahl mit zwei Nachkommastellen zurückgegeben.

Betrag formatieren

Sie können einen Betrag (dieser muss vorher mit nfo formatiert werden) mit folgendem Code in Smarty formatieren:

{infix n="1,23" c="base"}

Der angegebene Parameter n muss den zu formatierenden Betrag enthalten. Der Parameter c legt die Währung fest und kann die Werte "base" (Basiswährung), "choosed" (derzeit gewählte Währung) und jeden eingerichteten Währungscode annehmen.

Produkt-Infos

Sie können an beliebiger Stelle Infos zu einem Produkt ausgeben lassen. Dazu verwenden Sie folgenden Smarty-Code:

{product h="1" c="1" p="456"}

Der boolesche Parameter h gibt an, ob der Header für das Produkt angezeigt werden soll, mit dem booleschen Parameter c legen Sie fest, ob eine Währungsauswahl gezeigt werden soll. p müssen Sie mit der ID des Produkts füllen.

Produkte einer Kategorie

Sie können an beliebiger Stelle die Produkte einer Produkt-Kategorie ausgeben lassen. Dazu verwenden Sie folgenden Smarty-Code:

{group h="1" c="1" g="456"}

Der boolesche Parameter h gibt an, ob der Header für die Gruppe angezeigt werden soll, mit dem booleschen Parameter c legen Sie fest, ob eine Währungsauswahl gezeigt werden soll. p müssen Sie mit der ID der Gruppe füllen.

CSRF-System

sourceDESK nutzt CSRF-Token, um Angriffe zu blockieren. Den Token erhalten Sie in Templatedateien mit {ct}, mit {cf} erhalten Sie ein passendes HTML-Hidden-Form-Element.