TypoScript anpassen

In den wenigsten Fällen werden alle Eigenschaften, die das Standard-Template nach der Installation aufweist, exakt Ihren Wünschen entsprechen. Sie werden also diverse Anpassungen vornehmen müssen. Um Ihnen den Einsteig ein wenig zu erleichtern, werde ich die dabei am häufigsten in Betracht kommenden Möglichkeiten hier kurz erklären. Trotzdem ist es erforderlich, dass Sie sich intensiv mit TypoScript auseinandersetzen, um alle Möglichkeiten auszuschöpfen und eigene Vorstellungen, die hier nicht beschrieben sind, zu verwirklichen.

Elemente verändern

Wenn Sie den TSOB öffnen, können Sie das gewünschte Element aufklappen und es erscheint, der erste Zweig dieses Objektes. Diese Zweige sind bei diesem Template meistens weitere Container (COA), die ihrerseits wieder aufgeklappt werden können. Öffnen Sie bitte zum Test einmal header.20 und Sie werden sehen, dass dort zunächst ein Text- (lib.header.20.10) und als zweites ein Menüobjekt (lib.header.20.20) erzeugt wird. Diese Objektpfade, die Sie im TSOB finden, zeigen Ihnen was Sie ändern müssen um die Ausgabe des Elementes auf der Website zu beeinflussen.

Ein Beispiel: Sie möchten den Text im Footer ändern. Öffnen Sie hierzu lib.footer.100 und Sie werden feststellen, dass dieses Objekt unter anderem die Eigenschaft value = Dieses Layout basiert... hat. Es ist also jetzt klar, dass wenn Sie diesen Text ändern möchten, im Setup Ihres TypoScript Templates
lib.footer.100.value = Mein neuer Footertext
stehen muss.

Das überschreibt die Vorgaben des Templates, löscht sie aber nicht. Entfernen Sie die Zeile wieder, wird die Vorgabe sofort wieder wirksam. Wenn Sie also ein bestimmtes Element ändern möchten, aber nicht wissen, was dazu ins TypoScript Setup geschrieben werden muss, sehen Sie einfach im TSOB nach. Nicht nur die Vorgaben des YAML-Templates finden Sie hier, sondern den gesamten TypoScript Objektbaum, also alles was sich in TYPO3 überhaupt verändern lässt.

TypoScript Obejct Browser

Das wichtigste Werkzeug um ein TypoScript Template zu analysieren und zu verstehen ist der TSOB. Ohne ihn ist es nahezu unmöglich nachzuvollziehen, wie ein TS-Template aufgebaut ist. Klicken Sie auf die nebenstehende Abbildung und schauen Sie sich den Objekt-Baum an. Sie werden sehen, dass es eine Reihe von vordefinierten Objekten gibt, unter anderem auch jene, die dieses Template zur Verfügung stellt. Diese wiederum sind aufgeklappt dargestellt und unter lib zu finden. Im Einzelnen sind das:

lib.header - Definiert alle Eigenschaften des Headers, also das was über jeder Seite steht, und die darin enthaltenen Elemente (Grafiken, Suchbox usw.)

lib.nav - Die Tab-Navigation unter dem Header. Sie kann bei Bedarf ausgeschaltet werden.

lib.teaser - Dieses Element ist die Toolbox unter der Tab-Navigation. Rootline, Sprachmenü, Lupen und Datum / Uhrzeit befindet sich dort. Alle Elemente können ein- oder ausgeschaltet werden.

lib.selectorBox - Ein spezielles Element, das per Default nur auf der Startseite dargestellt wird (konfigurierbar). Es ist das Menü, das die in den letzten sieben Tagen geänderten Seiten zeigt.

lib.subMenu - Das Menü auf der linken Seite. Es wird zum Hauptmenü, wenn die Tab-Navigation ausgeschaltet ist. Das Objekt selbst ändert dadurch jedoch seinen Namen nicht.

lib.footer - Der Bereich unter den Inhalts-Spalten, der per Default die Links zu den Autoren des Templates enthält und den Sie, wenn Sie eine Lizenz gekauft haben, mit eigenen Inhalten füllen können.

Die Inhalts-Spalten selbst sehen Sie im TSOB nicht. Diese werden ja nicht von TypoScript erzeugt, sondern von Ihnen im Backend erfasst.