Site Sets in TYPO3 v13 verstehen und nutzen
Mit TYPO3 v13.1 hat das CMS ein neues Feature eingeführt, das für Entwickler und Integratoren gleichermaßen spannend ist: Site Sets. Sie bringen Struktur, Wiederverwendbarkeit und Klarheit in die Konfiguration deiner TYPO3-Projekte – und sind ein kleiner Gamechanger, wenn es um nachhaltige und skalierbare Site-Verwaltung geht.
In diesem Beitrag zeigen wir dir, was Site Sets sind, welche Vorteile sie bieten, wie du sie einrichtest und wie du bestehende Konfigurationen migrieren kannst.
Was sind Site Sets?
Ein Site Set ist ein modularer Konfigurationsbaustein, der in einer Extension oder einem Site Package abgelegt wird. Es kann enthalten:
- TypoScript (Konstanten und Setup)
- Page TSconfig
- Site-spezifische Einstellungen
- Standardwerte für Extensions
Ziel ist es, Konfigurationen zentral, standardisiert und wiederverwendbar zu gestalten. Statt Konfiguration in sys_template-Records oder verstreuten Includes zu pflegen, werden alle wichtigen Einstellungen in einem strukturierten Verzeichnis organisiert – als Teil eines sogenannten Sets.
Seit wann gibt es Site Sets?
Site Sets wurden mit TYPO3 v13.1 eingeführt. Sie sind also noch relativ neu, aber bereits ein offizieller Bestandteil der TYPO3 Core API. Die Entstehungsgeschichte und Hintergründe lassen sich in folgendem Video nachvollziehen. Das Video zeigt einen Vortrag von Benjamin Franzke auf den TYPO3 Developer Days 2024.
Dieses Video wird über eine externe Plattform (YouTube) gehostet. Das Laden bedarf der Zustimmung unserer Datenschutzbestimmungen.
Warum Site Sets? – Die Vorteile auf einen Blick
1. Wiederverwendbarkeit
Ein Site Set kann in mehreren Projekten oder Sites eingebunden werden. Besonders in Agenturen mit ähnlichen Projekttypen ist das ein großer Vorteil.
2. Klare Trennung & Struktur
Alle Konfigurationsbestandteile werden in einem Verzeichnis gesammelt – keine Suche mehr in TypoScript-Includes oder TSconfig-Schnipseln.
3. Native Composer-Kompatibilität
Site Sets funktionieren hervorragend in Composer-basierten Projekten. Du kannst Konfiguration versionieren, deployen und über Repositories teilen. Es sind keine Einträge mehr in der Datenbank notwendig um TypoScript einzubinden.
4. Erweiterungsfreundlich
Auch Drittanbieter-Extensions (z. B. News-Extension oder cs_seo) können Site Sets bereitstellen, die automatisch aktivierbar sind.
5. Übersichtliches Backend
Integratoren können Site Sets im Backend über den Bereich Site Management → Sites → Reiter „General“ einfach aktivieren.
So richtest du ein Site Set ein
1. Dateistruktur anlegen
In deiner Extension oder deinem Site Package legst du unter Configuration/Sets/ einen Ordner für dein Set an:
Configuration/Sets/MySet/
Mindestens benötigt wird eine config.yaml mit folgenden Inhalten:
name: vendor/my-set label: "My first site set"
Optional kannst du weitere Dateien hinzufügen:
- settings.yaml – Site Settings
- constants.typoscript – TypoScript Konstanten
- setup.typoscript – TypoScript Setup
- page.tsconfig – Page TSconfig
Tipp: Achte auf die genauen Dateinamen, damit TYPO3 sie automatisch erkennt.
3. Site Set aktivieren
Es gibt zwei Wege, ein Site Set einer Website zuzuweisen:
➤ Im Backend (GUI):
- Gehe zu Site Management → Sites
- Öffne deine Site-Konfiguration
- Im Reiter General kannst du ein oder mehrere Site Sets als Abhängigkeiten definieren (s. Screenshot)
➤ Direkt in der config.yaml der Site:
Du kannst Sets auch direkt per YAML in der Site-Konfiguration als Dependencies eintragen:
rootPageId: 1 base: 'https://example.com/' languages: ... dependencies: - vendor/my-set
Wenn du das Site Sets im Backend aktivierst, passiert dasselbe. Die Konfiguration auf Dateiebene ist besonders praktisch für Deployment-Szenarien oder wenn du Site-Konfigurationen versionierst.
Site Sets mit Dependencies
Site Sets unterstützen das Einbinden anderer Sets über sogenannte Dependencies. Damit kannst du Sets voneinander abhängig machen – beispielsweise, wenn du ein gemeinsames Grundlayout in mehreren Sets verwenden möchtest.
Beispiel (config.yaml eines Sets):
name: vendor/blog label: "Blog-Set" dependencies: - vendor/base
TYPO3 lädt dann zuerst das vendor/base-Set, bevor es vendor/blog lädt – inklusive TypoScript, TSconfig und Co.
Achtung bei gemischten Setups (sys_template + Site Sets)
Wenn du Site Sets parallel zu einem klassischen sys_template-Setup nutzt, gibt es eine wichtige Besonderheit:
Stelle sicher, dass im
sys_template-Datensatz die Option „Clear“ für TypoScript nicht aktiviert ist.
Standardmäßig ist diese Checkbox aktiviert – und sorgt dafür, dass die TypoScript-Konfiguration aus Site Sets überschrieben (bzw. gelöscht) wird.
Richtig:
- „Clear constants“ und „Clear setup“ deaktivieren
- Dann bleibt die Konfiguration aus den Site Sets erhalten
Migration bestehender Konfigurationen
Wenn du bisher TypoScript und TSconfig klassisch über sys_template eingebunden hast oder eine eigene Basistemplate-Extension pflegst, kannst du schrittweise migrieren:
Ist-Zustand analysieren: Welche Includes und Konfigurationen sind aktiv?
Site Set anlegen: Lege die oben beschriebene Struktur an.
Konfiguration übertragen: Ziehe TypoScript & Page TSconfig in die passenden Dateien.
Testen: Aktiviere das Set im Backend und prüfe die Funktionsweise.
Aufräumen: Entferne alte Includes und Templates, die nun redundant sind.
Bestehendes TypoScript einbinden
Wenn du bestehendes TypoScript oder Page TSconfig weiterhin verwenden möchtest, kannst du es direkt in einem Site Set referenzieren:
@import 'EXT:my_ext/Configuration/TypoScript/*.typoscript'
Das macht es einfach, vorhandene Strukturen in das neue Konzept zu überführen.
Fazit: Der Weg zu einer modernen TYPO3-Konfiguration
Mit Site Sets bietet TYPO3 v13 ein elegantes, modulares Konzept für die Verwaltung von Site-spezifischen Konfigurationen. Du sparst Zeit, reduzierst Komplexität und ermöglichst eine klarere Projektstruktur – besonders bei der Entwicklung von Site Packages oder in Multi-Site-Umgebungen.
Jetzt ist der ideale Zeitpunkt, Site Sets in deinen Projekten auszuprobieren, schließlich ist es nicht mehr lange bis schon TYPO3 14 LTS erscheint. Es lohnt sich.
Hast du bereits Erfahrungen mit Site Sets gesammelt? Teile es gerne in den Kommentaren.
