De:TSrefConstants
This page is document in progress. TypoScript (Liste TypoScript)
Constants
Konstanten werden im "Constants"-Feld des TypoScript Templates definiert. Die Syntax für Konstanten entspricht der normalen TypoScript Syntax.
Das Objekt bzw. die Eigenschaft "file" wird immer als Datentyp "resource", also als Datei-Referenz, interpretiert.
NOTE: Toplevel "object" TSConstantEditor cannot be used. It's reserved for configuration of the ConstantEditor module (Changed from beta4)
Es ist sinnvoll, Systemweite Definitionen wie Farben, Schriften, Größenangaben und auch Dateiangaben über die Konstanten zu setzen, da dadurch es möglich ist einen Wert der an vielen Stellen verwendet wird, aber überall gleich gesetzt werden soll, zentral zu verwalten.
# Beispiel:
# Angabe im "Constants"-Feld:
# Zentrale Hintergrundfarbe
firma.bgColor = red
# Wichtig: zwischen Groß- und Kleinschreibung wird auch bei den Konstanten unterschieden
firma.bgcolor = yellow
firma {
schrift = arial
vordergrundfarbe = blue
}
helloworld = Hello World!
Bei der Definition von Konstanten ist ganz normal wie bei TypoScript zu beachten, dass die Definition Groß- und Kleinschreibweise unterscheidet.
Konstanten einfügen
Konstanten werden in das template-Setup durch eine einfache str_replace Operation eingefügt.
Die Konstanten werden im Setup in einer geschweiften Klammer mit einem führenden $ angegeben.
# Die Konstanten werden im TypoScript Setup wie folgt referenziert:
{$helloworld}
{$firma.bgColor}
{$firma.schrift}
# Beispiel: page = PAGE page.bodyTag = <body bgColor="{$firma.bgColor}"> page.10 = HTML page.10.value = <h1>{$helloworld}</h1>
Nur definierte Konstanten werden ersetzt, andernfalls wird die Zeichenkette {$...} wie ganz normaler Text verwendet.
Konstanten in eingebundenen Templates werden ebenfalls ersetzt. Die Reihenfolge der Einbindung entscheidet darüber, welcher Inhalt eingefügt wird.
Es ist sinnvoll Konstanten systematisch zu benennen und verwenden.
