Lernseite · Frontend, TypoScript und Design
Vom Inhalt zur gestalteten Website: TypoScript, Site Packages und Design
Das Frontend ist das, was Kunden sehen und beurteilen. Als Beraterin oder Berater musst du erklären können, wie TYPO3 aus gepflegten Inhalten eine gestaltete Website macht. Auf dieser Seite begleitest du ein Kundenprojekt vom Site Package über TypoScript bis zum Design System. Danach kannst du Aufwände einschätzen, Fehler einordnen und zwischen fertigem Theme und eigenem Design abwägen.
Das Beispiel: die Ferienregion Seetal
Eine Agentur betreut die Ferienregion Seetal. Die Hauptwebsite bekommt ein eigenes Design, das eine Designerin entwirft. Dazu kommt eine kleine Website für die Gästekarte, die schnell und günstig online gehen soll. Später wollen auch die Orte der Region eigene Websites mit ähnlichem Aufbau. Die Redaktion wünscht sich außerdem ein Backend, in dem sie wenig falsch machen kann.
Wie TYPO3 eine Seite ausgibt
Die Redaktion pflegt Seiten, Inhaltselemente und Datensätze. Diese Inhalte liegen in der Datenbank. Ruft ein Besucher eine Seite auf, baut TYPO3 daraus HTML. Dabei arbeiten zwei Werkzeuge zusammen.
TypoScript ist die Konfigurationssprache für das Frontend. Es legt fest, welches Template gerendert wird, wie Menüs entstehen und wie Inhaltselemente ausgegeben werden. TypoScript ist keine Programmiersprache im engeren Sinn und läuft nicht im Browser. Datenbanktabellen legt es nicht an, das geschieht über die Tabellenkonfiguration TCA und die Datei ext_tables.sql. Benutzer legt man im Backend an.
Fluid ist die Template-Engine von TYPO3. Ein Fluid-Template besteht aus HTML und Fluid-Tags, den ViewHelpern. Sie fügen Inhalte ein, erzeugen Links und Bilder oder prüfen Bedingungen. Fluid gliedert die Ausgabe in Layouts für den Rahmen, Templates für die Seite und Partials für wiederverwendbare Stücke.
Früher schrieb man ganze Seiten mit HTML direkt in TypoScript. Heute ist die Aufteilung klar: TypoScript konfiguriert und liefert Daten, Fluid übernimmt das HTML. Das Objekt PAGEVIEW rendert die Seite mit einem Fluid-Template. Menüs liefert ein DataProcessor wie der MenuProcessor. So bleibt das Markup bei den Frontend-Entwicklern, und TypoScript bleibt trotzdem die Grundlage der Frontend-Konfiguration.
Für das Backend gibt es TSconfig. Es hat dieselbe Syntax wie TypoScript, aber andere Eigenschaften. Damit passt man das Backend für Redakteure an. Mehr dazu weiter unten.
Wo findest du alle Eigenschaften? In der TypoScript-Referenz, auf Englisch „TypoScript Explained“, auf docs.typo3.org. Wähle dort die passende Version, etwa 14.3. Eigenschaften ändern sich oder fallen zwischen Versionen weg.
Das Site Package
Ein Site Package ist eine Extension, die alles für das Aussehen und die Grundkonfiguration einer Website bündelt. Typisch enthält es:
- Eine
composer.jsonund die Definition eines Site Sets mit TypoScript, Settings und Page TSconfig. - Fluid-Templates, Layouts und Partials.
- Öffentliche Assets wie CSS, JavaScript, Schriften und Bilder.
- Oft auch Backend-Layouts, Sprachdateien und eigene Inhaltselemente.
Nicht hinein gehören die Inhalte der Seiten. Sie bleiben in der Datenbank. Auch Zugangsdaten zur Datenbank gehören nicht ins Paket, sondern in die Umgebungskonfiguration des Servers.
Bei Composer-Installationen liegt das Site Package meist als lokales Paket im Ordner packages. Composer bindet es dann wie jede andere Extension ein. Der Ordner fileadmin ist dagegen für Dateien der Redaktion da, nicht für Templates.
Warum ein Site Package statt Templates in der Datenbank? Weil Dateien im Repository liegen. Dort lassen sie sich mit Git versionieren, im Code-Review prüfen und automatisch ausrollen. Dieselben Templates laufen auf Entwicklung, Test und Live identisch. Konfiguration in der Datenbank ist dagegen schwer nachzuverfolgen. Ein Design-Relaunch ändert nur das Paket, die Inhalte bleiben unberührt. Das macht Projekte wartbar und skalierbar.
Einen Startpunkt liefert der Sitepackage Builder auf get.typo3.org. Er erzeugt ein lauffähiges Grundgerüst mit Ordnerstruktur, composer.json, Site Set und Beispiel-Templates. Das eigentliche Design entwirft er nicht, das baut man darauf auf. Das Site Package Tutorial der Dokumentation erklärt die Schritte.
Sicherheit durch Fluid: Fluid maskiert Variablen bei der Ausgabe automatisch als HTML. Eingeschleuster Code erscheint dann als harmloser Text, das schützt vor Cross-Site-Scripting. Wer HTML bewusst unmaskiert ausgibt, etwa mit dem ViewHelper f:format.raw, muss sicher sein, dass der Inhalt vertrauenswürdig oder bereinigt ist.
Site-Konfiguration, Site Sets und Settings
Jede Website in TYPO3 hat eine Site-Konfiguration. Du findest sie im Modul „Sites“, Untermodul „Setup“. Sie legt die Domain fest, die Sprachen, die Fehlerbehandlung, das Routing und die eingebundenen Site Sets. Farben und Schriften stehen dort nicht, die kommen aus dem Site Package.
Site Sets gibt es seit TYPO3 13. Ein Set ist ein Paket aus TypoScript, Settings und Page TSconfig. Eine Site bindet es in ihrer Konfiguration ein. Extensions und Site Packages bringen eigene Sets mit, zum Beispiel „SEO Sitemap“ oder das Set eines Themes. Seit TYPO3 14 kann ein Set auch Route Enhancer mitbringen.
Site Settings sind Einstellungen mit Typ und Standardwert, etwa eine Farbe, ein Logo oder eine Seiten-ID. Ein Set definiert sie, jede Site kann sie überschreiben. Berechtigte Benutzer ändern sie im Modul „Sites“, Untermodul „Settings“, ohne Code anzufassen. In TypoScript, TSconfig und Fluid stehen sie zur Verfügung. In TypoScript nutzt du sie wie Konstanten.
TypoScript lesen: Objekte, Eigenschaften, Funktionen
TypoScript ist zeilenbasiert. Eine Zeile besteht aus einem Pfad, einem Operator und einem Wert. Punkte trennen die Ebenen des Pfads. Das Gleichheitszeichen weist einen Wert zu, Leerzeichen am Anfang und Ende des Werts entfernt TYPO3.
page = PAGE
page.10 = TEXT
page.10.value = Hallo Seetal
page.10.wrap = <p>|</p>
# Gleiche Wirkung, kürzer geschrieben
page.10 {
value = Hallo Seetal
wrap = <p>|</p>
}Drei Begriffe solltest du auseinanderhalten:
- Ein Objekt wird über seinen Typ festgelegt, etwa
PAGE,TEXT,CONTENToderPAGEVIEW. - Eine Eigenschaft konfiguriert ein Objekt, etwa
value,wrapodertypeNum. - Eine Funktion wie
stdWrap,typolinkoderimgResourcebietet wiederverwendbare Verarbeitung. Sie wrappt, ersetzt oder holt Daten und steht an vielen Eigenschaften zur Verfügung.
Geschweifte Klammern verschachteln Pfade, damit du den gemeinsamen Teil nicht in jeder Zeile wiederholst. Die schließende Klammer steht am Anfang einer eigenen Zeile. Alles, was in derselben Zeile nach einer öffnenden oder schließenden geschweiften Klammer folgt, gilt als Kommentar, auch ohne Kommentarzeichen.
Mehrzeilige Werte stehen zwischen runden Klammern. Konstanten darin werden trotzdem ersetzt. Fehlt die schließende runde Klammer, gehört alles bis zum Ende der Datei zum Wert. Dazu zählen auch Kommentare, Bedingungen und Imports. Die folgende Konfiguration wirkt dann einfach nicht mehr, und der Fehler ist schwer zu finden.
Ein Punkt im Namen: Manchmal enthält ein Name selbst einen Punkt, etwa bei FlexForm-Angaben. Dann maskierst du ihn mit einem vorangestellten Backslash. So bleibt es ein einzelner Name und wird keine tiefere Ebene.
page.20 = TEXT
page.20.value (
Willkommen in der Ferienregion.
Schön, dass du da bist.
)
myIdentifier.my\.identifier = einWertKommentare beginnen mit einer Raute oder zwei Schrägstrichen und gelten bis zum Ende der Zeile. Mehrzeilige Kommentare stehen zwischen Schrägstrich-Stern und Stern-Schrägstrich. Wichtig: Nach einer Zuweisung mit Gleichheitszeichen gehören diese Zeichen zum Wert.
Kopieren, Referenzieren, Löschen, Ändern
Neben der Zuweisung kennt TypoScript vier weitere Operatoren.
Kopieren mit dem Kleiner-als-Zeichen kopiert einen Pfad mit Wert und allen Unterpfaden an eine andere Stelle. Die Kopie entsteht genau in dem Moment, in dem der Parser die Zeile liest. Spätere Änderungen am Original wirken nicht auf die Kopie. Das folgt dem Prinzip „Don't repeat yourself“: einmal definieren, mehrfach verwenden.
Referenzieren mit Gleichheitszeichen und Kleiner-als-Zeichen verweist auf das Original, statt es zu kopieren. Ändert man das Original später, ändert sich auch das Ziel. Aber Vorsicht: Die Referenz ist kein allgemeines Werkzeug der Sprache. TYPO3 löst sie erst beim Rendern im Frontend auf, und zwar bei Content-Objekten: überall dort, wo ein Objekt wie TEXT oder COA gerendert wird, dazu bei parseFunc. Bei einfachen Werten wie wrap, in Konstanten und in TSconfig wirkt sie nicht, dort nimmt man die Kopie. Die offizielle TypoScript-Referenz nennt nur den Pfad tt_content und empfiehlt sie dort aus Performancegründen.
lib.a = TEXT
lib.a.value = Eins
lib.b < lib.a
lib.a.value = Zwei
# lib.b.value ist weiter "Eins"
tt_content.text =< lib.contentElementLöschen mit dem Größer-als-Zeichen entfernt einen Pfad samt allen Unterpfaden.
Ändern mit Doppelpunkt und Gleichheitszeichen verändert einen vorhandenen Wert über eine vordefinierte Funktion. So musst du Werte aus Extensions nicht komplett neu schreiben. Die Funktionen heißen prependString, appendString, removeString, replaceString, addToList, removeFromList, uniqueList, reverseList, sortList und getEnv.
page.10 >
foo = ab
foo := appendString(cd)
# foo ist jetzt "abcd"
zahlen = 3,1,2
zahlen := sortList()
# zahlen ist jetzt "1,2,3"
buchstaben = a,b,a
buchstaben := uniqueList()
# buchstaben ist jetzt "a,b"Ohne Parameter sortiert sortList aufsteigend. uniqueList entfernt doppelte Einträge, reverseList dreht die Reihenfolge um.
Bedingungen und Imports
Bedingungen stehen in eckigen Klammern und nutzen die Symfony Expression Language. Ein Beispiel ist die Abfrage, ob ein Frontend-Benutzer angemeldet ist. Mit ELSE in eckigen Klammern gibt es einen Alternativzweig. END und GLOBAL in eckigen Klammern beenden eine Bedingung, beide wirken gleich. Eine Bedingung endet außerdem automatisch am Ende einer Datei oder eines Datensatzes.
Mehrere Kriterien gehören in ein Klammerpaar. Du verknüpfst sie mit and oder zwei kaufmännischen Und-Zeichen, mit or oder zwei senkrechten Strichen. Mit not oder einem Ausrufezeichen verneinst du ein Kriterium.
# Richtig
[frontend.user.isLoggedIn && tree.level > 1]
page.20 = TEXT
page.20.value = Willkommen zurück
[END]
# Falsch: das zweite Kriterium wird still ignoriert
[frontend.user.isLoggedIn] && [tree.level > 1]Weitere Regeln für Bedingungen:
- Bedingungen dürfen nicht innerhalb geschweifter Klammern stehen. Sie gelten immer auf oberster Ebene.
- Eine neue Bedingung beendet die vorherige. Verschachteln geht deshalb nicht in derselben Datei, sondern nur über getrennte Dateien.
- Im Frontend und im Backend gibt es unterschiedliche Variablen. Bedingungen auf angemeldete Frontend-Benutzer sind für das Frontend-TypoScript gedacht. Im Backend ist kein Frontend-Benutzer angemeldet, in TSconfig greift so eine Bedingung deshalb nie.
- Konstanten und Site Settings darfst du in Bedingungen nutzen, zum Beispiel um eine Seiten-ID zentral zu pflegen statt fest im Code.
- Den Operator mit zwei Fragezeichen, der bei Konstanten einen Ersatzwert liefert, gibt es in Bedingungen nicht. Dort nimmst du or.
[traverse(page, "uid") == {$myPageUid}]
page.10.value = Das ist die Angebotsseite
[END]Imports binden weitere Dateien ein. Die Schreibweise ist das Schlüsselwort @import mit einem Pfad in Anführungszeichen. Dafür gelten feste Regeln:
- Pfade beginnen mit EXT und Doppelpunkt oder relativ mit Punkt und Schrägstrich. Ein Pfad mit zwei Punkten zurück ins Elternverzeichnis ist nicht erlaubt.
- Ein Platzhalter ist nur auf Dateiebene erlaubt, nicht auf Verzeichnisebene. Mehrere Dateien lädt TYPO3 in alphabetischer Reihenfolge.
- Verzeichnisse werden nicht rekursiv durchsucht.
- Ein Import darf seit TYPO3 12 innerhalb einer Bedingung stehen. So entstehen bedingte Imports und auf diesem Weg auch verschachtelte Bedingungen.
- Innerhalb geschweifter Klammern ist ein Import nicht erlaubt.
@import 'EXT:seetal_sitepackage/Configuration/TypoScript/setup.typoscript'
[frontend.user.isLoggedIn]
@import './Navigation/*.typoscript'
[END]TypoScript prüfen und absichern
Wo kommt eine Einstellung her, und warum greift sie nicht? Dafür gibt es das Modul „Sites“, Untermodul „TypoScript“. Es hat mehrere Ansichten:
- „Active TypoScript“ zeigt den aufgelösten Baum, so wie er auf der gewählten Seite gilt. Hier kannst du Bedingungen simulieren.
- „Included TypoScript“ zeigt, welche Dateien, Sets und Datensätze eingebunden sind und in welcher Reihenfolge.
Damit findest du schnell, ob eine Einstellung überschrieben wird oder ob eine vergessene runde Klammer den Rest der Datei verschluckt. Page TSconfig prüfst du im entsprechenden Modul auf dieselbe Weise.
Alle diese Module sind nur für Administratoren freigegeben. Der Grund ist Sicherheit. Über TypoScript lassen sich USER-Objekte ansprechen, die PHP-Code ausführen. Wer TypoScript ändern darf, könnte sich damit Admin-Rechte verschaffen. Eine Rechtestufe unterhalb von Admin gibt es dafür deshalb nicht. Im Projekt liegt TypoScript am besten versioniert im Site Package.
Heute bindet man TypoScript meist über das Site Set des Site Package ein. Ältere Projekte nutzen noch TypoScript-Datensätze an der Wurzelseite.
TSconfig: das Backend für Redakteure
TSconfig nutzt die Syntax von TypoScript, wirkt aber im Backend. Es gibt zwei Arten:
- Page TSconfig gilt für einen Bereich des Seitenbaums. Damit setzt du Standardwerte für neue Datensätze, blendest Felder aus, schränkst Auswahllisten und die angebotenen Inhaltselemente ein und konfigurierst den Rich Text Editor.
- User TSconfig gilt für Benutzer und Benutzergruppen, etwa für Optionen und Ansichten.
So sehen Redakteure nur, was sie brauchen. Formulare werden schlanker, und es passieren weniger Fehler.
TCAdefaults.tt_content.header_layout = 2Pflichtfelder legt man übrigens nicht in TSconfig fest, sondern in der Tabellenkonfiguration TCA. Auch die liegt sauber im Site Package.
Fertige Themes: Camino und Bootstrap Package
Nicht jedes Projekt braucht ein komplett eigenes Design. Zwei fertige Themes sind besonders wichtig.
Camino ist das Standard-Theme, das seit der Version 14 mit dem Core ausgeliefert wird. Es ist eine System-Extension, das Composer-Paket heißt typo3/theme-camino. Der Name ist spanisch und heißt „der Weg“. Ziel ist eine funktionierende Website in wenigen Minuten, ohne externe Bibliotheken. Camino bringt Backend-Layouts, eigene Inhaltselemente, vier wählbare Farbschemata, ein austauschbares Logo und Menüs mit. Es eignet sich für einen schnellen Start oder für Demos. Für ein individuelles Design nimmt man ein eigenes Site Package.
Das Bootstrap Package ist eine verbreitete Drittanbieter-Extension, keine System-Extension des Core. Es basiert auf dem CSS-Framework Bootstrap und liefert ein komplettes, responsives Frontend. Dazu kommen viele Inhaltselemente wie Karussell, Akkordeon, Tabs oder Timeline sowie mehrere Backend-Layouts. Sein TypoScript kommt über Site Sets.
Warum ein standardisiertes Framework? Es spart Entwicklungszeit und bietet ein erprobtes, wartbares Grundgerüst. Komponenten und responsives Verhalten sind getestet, das Paket wird aktiv gepflegt. Der Preis: Ohne Anpassung sieht die Website oft ähnlich aus wie andere. Bei Updates des Pakets musst du eigene Anpassungen prüfen.
An die Marke anpassen geht über Einstellungen und Variablen, etwa für Farben. Alle SCSS-Variablen lassen sich über Settings setzen. Templates überschreibt man über eigene Pfade im Site Package.
Wann passt das Bootstrap Package eher nicht? Wenn ein stark individuelles Design mit eigenem Frontend-Framework gefordert ist. Oder wenn das Frontend-Team bewusst ein anderes CSS-Framework nutzt. Dann kostet das Umbiegen oft mehr als ein eigenes Site Package. Responsives Verhalten und viele Standard-Inhaltselemente sprechen dagegen gerade für das Paket.
Barrierefreiheit: Ein Framework schafft eine gute Grundlage, ersetzt aber keine Prüfung des konkreten Projekts. Keine Website ist durch ein Theme automatisch barrierefrei. Wer Farben anpasst, muss weiter die Kontrastanforderungen erfüllen. Nach Anpassungen prüft man Kontraste, Tastaturbedienung und Screenreader erneut.
Design Systems und Komponentenbibliotheken
Ein Design System ist eine Sammlung von Regeln, Komponenten und Vorlagen, die ein einheitliches Erscheinungsbild sicherstellt. Auch wenn viele Menschen an der Website arbeiten, sehen dann alle Seiten gleich aus. Ein bekanntes Beispiel ist Material Design von Google. Typische Bestandteile sind:
- Design-Tokens, also Grundwerte wie Farben, Schriftgrößen und Abstände.
- Dokumentierte Komponenten mit Varianten und Regeln, wann man sie einsetzt.
- Richtlinien für Barrierefreiheit und Tonalität.
Eine Komponentenbibliothek stellt wiederverwendbare Elemente wie Buttons, Teaser oder Formulare einheitlich bereit. Werkzeuge wie Figma oder Storybook helfen bei Pflege und Abstimmung. Die Vorteile:
- Das Erscheinungsbild ist über alle Seiten einheitlich.
- Neue Seiten entstehen schneller aus vorhandenen Bausteinen.
- Eine Änderung an einer Komponente wirkt überall, wo sie eingesetzt ist. Darum muss man sie auch überall prüfen.
Tests bleiben also nötig, und unbegrenzte Gestaltungsfreiheit wäre das Gegenteil eines Design Systems.
In TYPO3 entsprechen Komponenten meist Inhaltselementen und Fluid-Partials im Site Package. Jede Komponente wird möglichst genau einmal umgesetzt und überall verwendet. Redakteure wählen aus festgelegten Varianten, statt frei zu gestalten.
Barrierefreiheit löst man einmal in den Komponenten: Kontraste, sichtbare Fokuszustände und semantische Strukturen. Jede Seite erbt diese Qualität. Das ist viel effizienter, als jede Seite einzeln zu korrigieren. Für Inhalte wie Alternativtexte und sinnvolle Überschriften bleiben die Redakteure verantwortlich.
Zusammenarbeit: Design und Entwicklung müssen eng abgestimmt arbeiten. Sonst fehlen neue Design-Varianten im Code, oder der Code hat Varianten, die das Design nicht kennt. Gemeinsame Regeln, Namen und Abläufe halten beides synchron.
Das Wichtigste in Kürze
- TypoScript ist die Konfigurationssprache des Frontends. TSconfig nutzt dieselbe Syntax für das Backend.
- Heute konfiguriert TypoScript und liefert Daten, Fluid schreibt das HTML und maskiert Ausgaben gegen Cross-Site-Scripting.
- Ein Site Package bündelt Templates, Assets und Konfiguration, versioniert und meist im Ordner packages. Inhalte bleiben in der Datenbank.
- Site Sets bringen TypoScript, Settings und Page TSconfig mit. Settings variieren Farben oder Logos je Site.
- Kopieren erzeugt eine unabhängige Kopie beim Parsen. Die Referenz wirkt erst beim Rendern im Frontend bei Content-Objekten, nicht in Konstanten oder TSconfig.
- Nach einer Zuweisung sind Kommentarzeichen Teil des Werts.
- Alle Kriterien einer Bedingung gehören in ein Klammerpaar. Bedingungen stehen nie in geschweiften Klammern.
- Seit TYPO3 14 gibt es nur noch Imports, die alte INCLUDE_TYPOSCRIPT-Syntax ist entfernt.
- Die TypoScript-Module unter „Sites“ sind nur für Administratoren, weil TypoScript PHP aufrufen kann.
- Camino ist das Core-Theme seit TYPO3 14, das Bootstrap Package ein Drittanbieter-Theme. Fremde Extensions ändert man nie direkt.
- Ein Design System mit Komponentenbibliothek hält das Erscheinungsbild einheitlich und löst Barrierefreiheit zentral.
Begriffe
- Site Package
- Extension mit Templates, Assets und Konfiguration für das Aussehen einer Website.
- Site Set
- Paket aus TypoScript, Settings und Page TSconfig, das eine Site in ihrer Konfiguration einbindet.
- Site Settings
- Einstellungen einer Site mit Typ und Standardwert, im Modul Sites unter Settings bearbeitbar.
- Fluid
- Template-Engine von TYPO3 mit Layouts, Templates, Partials und ViewHelpern.
- TypoScript
- Konfigurationssprache, die Verhalten und Ausgabe des Frontends steuert.
- TSconfig
- Backend-Konfiguration mit TypoScript-Syntax, als Page TSconfig und User TSconfig.
- stdWrap
- Vielseitige TypoScript-Funktion, die Werte wrappt, ersetzt oder Daten holt.
- Camino
- Standard-Theme im Core seit TYPO3 14.
- Bootstrap Package
- Drittanbieter-Theme auf Basis des CSS-Frameworks Bootstrap.
- Design-Token
- Grundwert eines Design Systems wie eine Farbe, eine Schriftgröße oder ein Abstand.
- Komponentenbibliothek
- Sammlung einheitlich umgesetzter, wiederverwendbarer Designelemente.