Dies ist der vierte Teil der Serie “Einführung in TypoScript”. Während wir uns in dem ersten Artikel mit dem prinzipiellen Aufbau von TypoScript beschäftigt haben, haben wir uns im zweiten Teil angeschaut, wie wie den Inhalt aus der Datenbank auslesen und darstellen können. Der dritte Teil beschäftigte sich mit dem Thema “Menüs“.

Heute wollen wir uns das schweizer Messer in TypoScript anschauen: “stdWrap“. Mein Leitspruch ist hier immer “Wenn nix mehr geht, geht stdWrap”.

Doch, wo und wozu kann ich stdWrap gebrauchen?

Schauen wir uns dazu ein Beispiel aus unserem ersten Teil nochmal an:

1 meineSeite = PAGE
2 meineSeite.bodyTag = <body>
3 meineSeite.10 = TEXT
4 meineSeite.10.value = Hallo Welt

Hier haben wir eine weiße Seite erzeugt, auf der “Hallo Welt” steht. Wir haben uns dazu die Klasse “TEXT” in der TypoScript-Referenz genauer angesehen.

Eigentlich scheint dies eine recht arme Klasse zu sein. Sie besitzt nur die Eigenschaft “value”. In Wirklichkeit kann sie aber viel mehr. Wir sehen nämlich in der zweiten Zeile der Tabelle die unscheinbaren Worte “stdWrap properties”. Dies bedeutet, dass wir alle Eigenschaften von stdWrap für ein Objekt der Klasse “TEXT” definieren können!

Was kann ich damit anfangen?

Wir wollen als Beispiel versuchen, auf unsere Seite das Änderungsdatum der Seite anstatt “Hallo Welt” ausgeben zu lassen.

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

In Zeile 4 benutzen wie die Eigenschaft “field”, um ein Feld der aktuellen Seite aus der Datenbank auszulesen. In diesem Fall nehmen wir das Feld “SYS_LASTCHANGED” – dieses enthält das Änderungsdatum der Seite.

Das Datum wird nun im Unix-Timestamp-Format ausgegeben. Da dies für Besucher nicht gerade gut lesbar ist, wollen wir das noch etwas formatieren:

1 meineSeite = PAGE
2 meineSeite.bodyTag = <body>
3 meineSeite.10 = TEXT
4 meineSeite.10.field = SYS_LASTCHANGED
5 meine Seite.10.date = d.m.Y

In Zeile 5 benutzen wir nun die Eigenschaft “date” um das Datum in dem Format tt.mm.jjjj ausgeben zu lassen.

Schließlich wollen wir noch ein “Datum:” vor dem Datum stehen haben:

1 meineSeite = PAGE
2 meineSeite.bodyTag = <body>
3 meineSeite.10 = TEXT
4 meineSeite.10.field = SYS_LASTCHANGED
5 meineSeite.10.date = d.m.Y
6 meineSeite.10.wrap = Datum: |

In Zeile 6 benutzen wir die Eigenschaft “wrap” um das Objekt “meineSeite.10″ von dem Wort “Datum:” umfassen zu lassen. Das “|” stellt dabei das Objekt dar. Umfassen heißt also vor dem Datum ein “Datum:” und nach dem Datum nichts.

Ein paar weitere Beispiele für den Einsatz von stdWrap findet Ihr auch in älteren Artikeln. Z.B. hier relativ weit unten, wo der Seitentitel ausgelesen und im HTML-Header dargestellt wird, oder auch hier, wo ich erkläre, wie man SEO-geeignete Einstellungen in TypoScript vornehmen kann.

Damit ist die Einführung in stdWrap beendet. Im nächsten Artikel beschäftigen wir uns dann mit “optionSplit”.

Popularity: 7%