In den Einführungsartikeln zum Thema TypoScript haben wir die Sprachreferenz TSRef kennen gelernt. Doch wie muss man diese lesen, um mit ihr arbeiten zu können? Dieser Artikel soll uns dabei helfen.

Die TSRef ist kein Buch, dass man von vorne nach hinten durchließt, sondern eine Referenz zum nachschlagen.

Nehmen wir ein uns bekanntes Beispiel und arbeiten die TSRef danach ab:

1 lib.meinMenu = HMENU
2 lib.meinMenu.wrap = <ul> | </ul>
3 lib.meinMenu.1 = TMENU
4 lib.meinMenu.1.NO = 1
5 lib.meinMenu.1.NO.wrapItemAndSub = <li> | </li>

In Zeile 1 wird ein Objekt erzeugt, dem die Klassen “HMENU” zugeordnet wird. Wir werfen also einen Blick in das Kapitel “HMENU“. In der Tabelle dieses Kapitels sehen wir nun, welche Eigenschaften wir für “HMENU” definieren können. Dies bedeutet, wir können folgendes schreiben:

1 lib.meinMenu = HMENU
2 lib.meinMenu.entryLevel =
3 lib.meinMenu.minItems =

… und so weiter. Doch was kann ich nun nach dem “=” eingeben? Dies verrät uns die zweite Spalte “Data type”. Für “entryLevel” und “minItems” steht hier jeweils “int”. Um nun herauszufinden, was “int” bedeutet, öffnen wir das Kapitel “Datatype Reference“. In der Tabelle suchen wir nun nach “int”und finden dort die Erklärung, dass integer-Zahlen möglich sind.

Schauen wir uns ein weiteres Beispiel an:

1 meineSeite = PAGE
2 meineSeite.bodyTag = <body>
3 meineSeite.10 = TEXT
4 meineSeite.10.field = SYS_LASTCHANGED

In Zeile 3 weisen wir einem Objekt die Klasse “TEXT” zu. In der Tabelle ist zu erkennen, dass neben der Eigenschaft “value” noch weitere möglich sind (“stdWrap properties”). Wir wechseln also in das Kapitel “stdWrap“. Dort ist die in unserem Beispiel verwendete Eigenschaft “field” erklärt. Sie ist vom Datentyp “fieldname” (Korrekter weise sollte der Datentyp “getText” hier stehen).

Wir schlagen also das Kapitel “Datatype Reference” auf und suchen nach “getText”. Wir sehen, dass wir für “.field” unter anderem ein Datenbankfeld “SYS_LASTCHANGED” auslesenkönnen.

Ich hoffe, ich konnte deutlich machen, wie man mit der TSRef arbeitet, um z.B. ein bestehendes TypoScript-Beispiel zu erklären. Will man selber TypoScript schreiben, funktioniert das auf die gleiche Weise. Ich suche mir eine Klasse heraus, die das kann, was ich möchte (z.B. die Klasse “TMENU”) und sehe, welche Eigenschaften mir zur Verfügung stehen. Für jede Eigenschaft kann ich dann im Kapitel “Datatype Reference” nachschlagen, was ist nach dem “=” eingeben kann.

Popularity: 1%