TypoScript-Syntax

Die TypoScript Syntax

Dies ist eine kurze Zusammenstellung der wichtigsten Syntaxregeln für TypoScript. Weitere und genauere Informationen findet man in der TSRef.

{} Ausklammern von TypoScript

Anstatt immer wieder etwas wie page.10.marks.MARKER... zu schreiben können TypoScript-Objekte mit geschweiften Klammern ausgeklammert werden. Dies macht vor allem den Code übersichtlicher.

Aus den Zeilen:

würde dann:

# und /* ... */ Kommentare

Kommentare in einer Zeile werden mit # eingeleitet und sollten immer in einer eigenen Zeile stehen, da TypoScript nicht wie andere Programmiersprachen mit Markierungen wie bei z.B. PHP:

für String-Begrenzung "" und Zeilenende ";" arbeitet. Dies gilt auch für mehrzeilige Kommentare, die mit /* eingeleitet und mit */ beendet werden.

= und () Wertzuweisungen

Mit dem Operator "=" wird einer Eigenschaft ein Wert zugewiesen. Der Wert kann in dieser Schreibweise nicht über mehrere Zeilen gehen.

Will man einen Wert über mehrere Zeilen im TypoScript eintragen, kann man die runden Klammern einsetzen. Die Zeilen werden dann genauso im HTML-Quelltext ausgegeben, wie sie im TypoScript angegeben wurden.

> Löschen eines Objektes oder einer Eigenschaft

Man kann Objekte oder Eigenschaften löschen, die zuvor im TypoScript definiert wurden. Sinnvoll ist dies vor allem in Conditions oder um Werte zu überschreiben, die durch das Statische Template "css_styled_content" hinzugefügt wurden. So bleibt man dann bei einem Update dieser Extension davor bewahrt, dass alle eigenen Änderungen überschrieben werden.

Beispiel, in dem erst page.10 definiert wird und dann wieder gelöscht wird:

page.10 = TEXT
page.10.value = Hallo Welt!
page.10 >

< Kopieren eines Objektes

Kopieren geht zum einen über den kompletten Pfad oder, wenn man ausgeklammert hat, auch mit einer relativen Pfadangabe. Im zweitem Fall geht man vom ausgeklammerten Objekt aus und schreibt einen Punkt davor.

Beispiele:

=< Referenzieren eines Objektes

Anstatt einer Kopie wird nur ein Verweis gemacht. Somit ändern sich gegebenenfalls immer alle Refererenzen, unabhängig von der Position im TypoScript.

:= Änderung zur Laufzeit von Werten (TYPO3 Version 4.0+)

Dynamische Änderung von Werten. Ermöglicht es, Strings oder kommaseparierte Listen zu erweitern oder Werte daraus zu entfernen.

Folgende Funktionen sind bereits vorhanden:

• prependString()
  Ein String wird vor den vorhandenenen String angefügt.
• appendString()
  Ein String wird hinter den vorhandenenen String angefügt.
• removeString()
  Ein String wird aus dem vorhandenenen String herausgelöscht.
• replaceString()
  Ein String wird in dem vorhandenenen String ersetzt.
• addToList()
  Fügt einer kommaseparierten Liste weitere Werte hinzu
• removeFromList()
  Löscht aus einer kommaseparierten Liste bestimmte Werte

[] Conditions

Eckige Klammern leiten eine Condition ein oder beenden diese. Mit Conditions kann das TypoScript zur Laufzeit modifiziert werden, wenn bestimmte Vorraussetzungen erfüllt sind. (z.B. Ist der Website Benutzer eingeloggt, Verwendet dieser den IE oder einen anderen Browser, ...)