Anwendungsbeispiele von TypoScript sind etwa das Erstellen von Navigationen, HTML-Blöcken, Seitentiteln, Header-Tags und mehr. Im Bakehouse sind bereits viele TypoScript-Anweisungen vorbereitet. Diese können im TypoScript-Editor editiert, erweitert bzw. überschrieben werden.
TypoScript kann im Bakehouse nur bearbeitet werden, wenn der Benutzer über Administratorenrechte verfügt.
Die TypoScript-Konfiguration einer page Seite wird über das docucontextmenu Kontextmenü in der navigation Seitenstruktur geöffnet. Der Menüpunkt typo3 „TypoScript“ öffnet die TypoScript-Konfigurationsdatei.
Ist für eine Seite noch kein TypoScript angelegt, erfolgt dies über docupointer „Klicken Sie hier, um ein Erweiterungs-Template zu erstellen“.
TypoScript-Shortcut: Die TypoScript-Konfiguration erreicht man als angemeldeter User auch mit der ^-Taste, sofern kein Bakehouse-Fenster oder -Panel geöffnet ist.
Jede Unterseite in der navigation Seitenstruktur des Projekts kann über TypoScript verfügen. Dabei gilt: TypoScript vererbt sich auf untergeordnete Seiten weiter.
Da für gewöhnlich große Teile der TypoScript-Konfiguration global für das gesamte Projekt gelten sollen, befindet sich ein Großteil des TypoScripts auf der page Root-Seite (zumeist „Home“). Ein gängiger Anwendungsfall wäre etwa die Einbindung eines Tracking-Code-Snippets.
Soll ein TypoScript-Anweisung nur für einen bestimmten Teil des Projekts gelten, wird diese direkt auf der betreffenden page Unterseite festgelegt. Auch hier gilt: Der Code vererbt sich auf etwaige untergeordnete Hierarchien weiter.
Untenstehend werden die wichtigsten Details erläutert, um den Aufbau und die Funktionsweise von TypoScript und die vorinstallierten TypoScript-Parameter in deinem Bakehouse-Projekt zu verstehen. Die in weiterer Folge erläuterten Beispiele ersetzen aber in keinem Fall die umfassende TypoScript-Dokumentation des TYPO3-Projects und wir empfehlen eine eingängige Auseinandersetzung mit ebendieser!
TypoScript ist case-sensitive. Es muss also auf Groß- und Kleinschreibung geachtet werden. meinElement und meinelement werden vom System als unterschiedliche Strings interpretiert.
Der Punkt . wird verwendet, um Objekte und Eigenschaften voneinander zu trennen, wodurch in weiterer Folge eine Hierarchie entsteht.
TypoScript unterscheidet eine Auswahl an vordefinierten Content-Object-Typen.
Im folgendem Beispiel wird eine Library erstellt, die HTML-Code enthält:
Die Anweisung lib definiert eine Library. Der mit Punkt angehängte Text meinText legt den Namen der erstellten Library fest. Über diesen Namen wird der Code aufgerufen.
Wird nun in einer zweiten Zeile die Anweisung lib.meinText mit dem Attribut value erweitert, kann so der Inhalt der Library definiert werden.
Die Autovervollständigung des TypoScript-Editors schlägt verfügbare und bereits definierte Attribute vor. Die Autovervollständigung wird durch den Shortcut Strg + Leertaste aktiviert.
TypoScript wird Zeile für Zeile abgearbeitet. Soll eine Zeile nicht interpretiert werden, ist es möglich, diese mit # auszukommentieren. Dies wird oft und gerne für Kommentare verwendet, um den Code lesbarer zu machen.
TypoScript lässt sich mit geschwungenen Klammern verschachteln, die folgenden Beispiele führen zum selben Ergebnis:
Sämtliche vorinstallierte Content-Elemente im Bakehouse sind mit TypoScript konfiguriert. Eigenschaften von Content-Elementen können projektspezifisch überschrieben werden und auf die Bedürfnisse einer einzelnen Bakehouse-Installation angepasst werden.
Beispiel: Das Bakehouse Content-Element Trenner ist standardmäßig ausgeblendet. Folgender TypoScript-Code überschreibt die Standardkonfiguration und blendet das Content-Element in der Bakehouse-Werkzeugleiste ein:
Erklärung: Beim Bakehouse handelt es sich um ein plugin mit dem Namen tx_bh. Mit settings werden die Einstellungen aufgerufen. Das Bakehouse verfügt über contentElements. Eines davon trägt den Namen bhTrenner. Das Attribut hidden bestimmt, ob ein Element in der Bakehouse-Werkzeugleiste dargestellt wird oder nicht (1 für „true“ und 0 für „false“).
Mit dem Löschoperator > wird ein an einer vorhergehenden Stelle definiertes TypoScript-Objekt gelöscht:
Das Zeichen < wird angewendet, um einen Objektpfad in einen anderen zu kopieren. Das gesamte Objekt wird kopiert – sowohl der Wert als auch die Eigenschaften. Alle alten Objekte und Werte werden an dieser Position überschrieben.
Neben dem Erstellen, Konfigurieren und Verwalten der Objekte, können im TypoScript auch Bedingungen erstellt werden. Folgendes Beispiel zeigt den grundsätzlichen Aufbau einer Bedingung im TypoScript:
Liste der wichtigsten Bedingungen:
Folgende Schritte empfiehlt das Bakehouse-Team jedem neuen Bakehouse-Entwickler: