Erinnern Sie sich noch an die Zeiten, in denen Sie sys_template-Datensätze durchsuchen, TypoScript manuell importieren und mehrere @import-Anweisungen verwalten mussten? Mit TYPO3 v13 hat das Core-Team Site Sets eingeführt, ein Hauptmerkmal dieser Version, um die Konfiguration auf Website-Ebene zu vereinheitlichen und zu modernisieren.
Site Sets vereinfachen die Einrichtung, verbessern das Abhängigkeitsmanagement und sorgen für übersichtlichere TYPO3-Projekte. Ergänzend zu diesem modernen Konfigurationsansatz kann die AI Foundation für TYPO3 eine gemeinsame Grundlage für AI-Anbieter, Tools, Kontexte und Berechtigungen bereitstellen.
In diesem Artikel werden wir die Grundlagen und Hauptfunktionen von Site Sets untersuchen, wie sie hinter den Kulissen funktionieren und warum sie mehr sind als nur eine Möglichkeit, TypoScript einzubinden.
Wir werden auch Beispiele für jeden Schritt liefern: von der Erstellung eines benutzerdefinierten Sets, der Definition Ihrer Einstellungen und dem automatischen Laden von TypoScript bis hin zur abschließenden Konfiguration mit minimalem Datenbank-Wirrwarr.
Site Sets sind in TYPO3 v13 LTS verfügbar und so konzipiert, dass sie mit bestehenden Konfigurationsansätzen koexistieren, wodurch Teams sie schrittweise während eines TYPO3 Upgrade von früheren TYPO3-LTS-Versionen einführen können.
Kurzantwort: Was sind TYPO3 Site Sets?
Ein TYPO3 Site Set ist ein wiederverwendbares Paket mit Site-Konfiguration im Ordner Configuration/Sets/ einer Extension. Es besteht aus einer config.yaml und optionalen Dateien für TypoScript, Page TSconfig und Settings. Eine Site aktiviert es, indem sie das Set in ihrer config.yaml unter dependencies einträgt. Site Sets gibt es seit TYPO3 v13.1; sie funktionieren in v13.4 LTS und v14 LTS.
Wichtigste Erkenntnisse
- Nur die config.yaml ist Pflicht; setup.typoscript, constants.typoscript, page.tsconfig, settings.definitions.yaml und settings.yaml sind optional.
- Abhängigkeiten werden rekursiv aufgelöst, sortiert und dedupliziert. Die Include-Reihenfolge pflegen Sie nicht mehr von Hand.
- Settings aus der settings.definitions.yaml erscheinen im Settings-Editor des Backends und stehen in TypoScript als Konstanten bereit.
- Eine Site mit Sets braucht keinen sys_template-Datensatz. Vorhandene Datensätze werden weiterhin geladen, und zwar nach dem TypoScript der Site.
- TYPO3 v14 ergänzt Route Enhancer in Sets (v14.1) und verlegt den Settings-Editor nach Sites > Setup.
Gültig für: TYPO3 v13.4 LTS und v14.3 LTS, geprüft anhand der offiziellen Dokumentation auf docs.typo3.org.
Aktualisiert: November 2026
Was sind Site Sets?
Site Sets sind zusammensetzbare Teile der Konfiguration, die in TYPO3 v13 (ab Version 13.1) eingeführt wurden. Sie kapseln verschiedene Teile der Konfiguration einer Site, TYPOScript, TSconfig, Einstellungsdefinitionen, referenzfähige Inhaltsblöcke und mehr, in einer einzigen logischen Einheit.
Anstatt die Konfigurationen über statische Includes, ext_localconf.php oder sys_template-Datensätze zu verstreuen, können Sie mit Site Sets alles ordentlich bündeln:
- Sie können diese Konfigurationen ganz einfach auf mehrere TYPO3 sites anwenden.
- Wiederverwendung der gleichen Sets in verschiedenen Projekten oder verschiedenen Untergruppen eines einzelnen Projekts.
- Abhängigkeiten werden automatisch gehandhabt, so dass Sie mehrere Site Sets übereinander legen können, ohne sich Gedanken über Konflikte bei der Ladereihenfolge zu machen.
Was Site-Sets sind und was sie nicht sind
- Sind: Site-spezifische Konfigurationsbündel, die verwandtes TypoScript, TSconfig und Einstellungen gruppieren.
- Sind nicht: Ein Ersatz für TYPO3 Extensions, TYPO3 Templates oder Geschäftslogik auf Anwendungsebene.
- Sind optional: Site-Sets sind in TYPO3 v13 nicht obligatorisch und können schrittweise zusammen mit bestehenden Konfigurationsansätzen übernommen werden.
Warum statische Templates durch Site Sets ersetzen?
In früheren TYPO3 Versionen bestand das Hinzufügen neuer Funktionen oft aus mehreren Schritten: Erstellen von statischen TypoScript-Includes, Verweisen auf diese in Ihrem Seiten- oder site-Template oder manuelles Aufrufen von @import in TypoScript-Dateien.
Dieser Ansatz konnte unübersichtlich werden, wenn mehrere Extensions beteiligt waren, was zu Verwirrung bei der Lade-Reihenfolge und Duplikationen führte.
Mit Site Sets:
- Keine statischen TypoScript mehr:
Die klassische Methode, TypoScript in sys_template Datensätzen zu speichern, kann in vielen gängigen Szenarien vermieden werden, da die Konfiguration nun in einer strukturierten, site-spezifischen Weise geliefert werden kann. - Kein manuelles @import mehr:
Die Lade-Reihenfolge kann durch Site Set-Abhängigkeiten gehandhabt werden, wodurch der Bedarf entfällt, @import Anweisungen manuell zu verwalten. - Kein globales TSconfig mehr:
Page TSconfig kann nun pro site geliefert werden, wodurch Multi-Site-Setups leichter verwaltet werden können, ohne auf globale Konfigurationen angewiesen zu sein.
1. Sauberere Konfiguration
Die Zeiten, in denen TypoScript in sys_template Datensätzen gespeichert wurde und mit @import Komplexitäten zu kämpfen war, sind vorbei. Site Sets vereinheitlichen alles in gut definierten Verzeichnissen.
2. Weniger Datenbank-Chaos
Einstellungen, die früher an mehreren Stellen gespeichert wurden, sind nun in dateibasierten YAML-Konfigurationen zusammengefasst, was die Versionskontrolle erleichtert.
3. Automatische Reihenfolge & Deduplication
Wenn mehrere Sets dasselbe TypoScript-Snippet benötigen, werden Abhängigkeiten von TYPO3 intelligent geschichtet, ohne Konflikte oder doppelte Code-Blöcke.
Was TYPO3 garantiert und was nicht
- Garantiert: Deklarierte Site Set-Abhängigkeiten werden in einer definierten Reihenfolge geladen.
- Nicht garantiert: TYPO3 löst keine semantischen oder logischen Konflikte zwischen Konfigurationen.
- Wichtig: Deduplication bezieht sich auf das Laden von Abhängigkeiten, nicht auf Geschäftslogik oder sich überschneidende TypoScript-Definitionen.
4. Editor-freundlich
Ein neuer Site Settings Editor in TYPO3 (eingeführt mit Version 13.3, Feature #104794) ermöglicht es Redakteuren, Einstellungen über das Backend anzupassen, wodurch die Notwendigkeit entfällt, in YAML-Dateien oder die Datenbank einzutauchen.
Site Sets oder klassische statische Templates: Was ist der Unterschied?
Site Sets liefern Konfiguration aus Dateien pro Site, statische Templates werden dagegen in einem sys_template-Datensatz in der Datenbank aktiviert. Beides funktioniert weiterhin in TYPO3 v13 und v14; die TypoScript-Referenz 14.3 empfiehlt Sets ab v13.
| Methode | Funktioniert in | Geeignet für | Einschränkung |
| Site Set (Configuration/Sets + Site-Abhängigkeiten) | ab v13.1, v13.4 LTS, v14 | Neue Projekte, Multi-Site-Setups, wiederverwendbare Site-Pakete | In v12 nicht verfügbar; ext_typoscript_setup.typoscript wird nicht geladen |
| Statisches Include in einem sys_template-Datensatz (addStaticFile) | v12, v13, v14 | Bestehende Projekte, Extensions, die auch v12 unterstützen müssen | Liegt in der Datenbank; die Reihenfolge wird je Datensatz von Hand festgelegt |
| @import in TypoScript-Dateien | v12, v13, v14 | Aufteilen von Dateien innerhalb eines Sets oder Pakets | Nicht für Abhängigkeiten zwischen Sets oder Extensions verwenden |
| ext_typoscript_setup.typoscript | v12, v13, v14 (Sites mit sys_template-Datensätzen) | Älteres globales TypoScript | Wird ignoriert, wenn die Site ihr TypoScript aus Sets bezieht |
Faustregel: Nutzen Sie in v13 und v14 ein Site Set. Ein statisches Include ist nur nötig, wenn eine Extension weiterhin v12 unterstützen muss.
Welche Dateien enthält ein Site Set?
Ein Site Set ist ein Ordner unterhalb von Configuration/Sets/ in einer Extension. Nur die config.yaml ist Pflicht: Sie enthält Name, Label und Abhängigkeiten des Sets. Optionale Dateien daneben laden TypoScript, Page TSconfig und Settings automatisch (TYPO3 Explained: Site sets).
1. config.yaml - Der Kern Ihres Site Sets
# EXT:your_extension/Configuration/Sets/YourSet/config.yaml
name: your-vendor/your-set
label: Your Set
# Provide references to other sets you want to include
dependencies:
- namespace/teaser
- namespace/slider
- namespace/myelement - name: Ein eindeutiger Bezeichner für Ihr Set.
- Bezeichnung: Der von Menschen lesbare Name für Ihr Set.
- Abhängigkeiten: Andere Sets, von denen Ihr Set abhängt. TYPO3 lädt diese zuerst, um sicherzustellen, dass die gesamte Konfiguration in der richtigen Reihenfolge verfügbar ist.
2. settings.definitions.yaml - Definieren von editierbaren Einstellungen
Wenn Ihr Set vom Benutzer editierbare Einstellungen enthalten muss (z. B. die Standardanzahl der Elemente in einem Karussell), können Sie diese in settings.definitions.yaml deklarieren.
# EXT:your_extension/Configuration/Sets/YourSet/settings.definitions.yaml
settings:
foo.bar.baz:
label: 'Your example set settings'
description: 'You need to add description'
type: int
default: 5 3. settings.yaml – Werte für Ihr Set oder seine Abhängigkeiten setzen
Die settings.yaml ändert die Werte von Settings, die Ihr Set oder eine seiner Abhängigkeiten definiert; sie definiert selbst keine Settings. Im Beispiel stammt styles.content.defaultHeaderType aus dem Set von Fluid Styled Content (Typ int, Standardwert 2), daher braucht Ihr Set typo3/fluid-styled-content als Abhängigkeit. Seit TYPO3 13.4.x ist das empfohlene Format eine flache Map mit Punkt-Schlüsseln; verschachtelte Bäume werden weiterhin gelesen (Important #106894).
# EXT:your_extension/Configuration/Sets/YourSet/settings.yaml
# Überschreibt ein Setting aus dem Set typo3/fluid-styled-content
styles.content.defaultHeaderType: 1 Wenn Sie die Einstellungen auf diese Weise organisieren, bleibt Ihr Set flexibel. Andere Erweiterungen oder Projekte können Ihr Set später übernehmen, ohne alles an mehreren Stellen neu definieren zu müssen.
Was NICHT in ein Site Set aufgenommen werden sollte
- Temporäre Überschreibungen, die für kurzfristige Änderungen vorgesehen sind
- Seiten-spezifische oder einmalige Projekt-Hacks
- Experimentelle oder instabile Konfigurationen, die sich häufig ändern können
Wie erstellen und aktivieren Sie ein Site Set?
Legen Sie in Ihrer Extension oder Ihrem Sitepackage einen Ordner unterhalb von Configuration/Sets/ an, erstellen Sie darin eine config.yaml mit Name und Label, ergänzen Sie optionale Settings- und TypoScript-Dateien und tragen Sie den Set-Namen unter dependencies in die config.yaml der Site ein. Die sechs Schritte unten zeigen jede Datei.
1. Definieren Sie Ihr Set (config.yaml)
# EXT:your_extension/Configuration/Sets/YourSet/config.yaml
name: your-vendor/your-set
label: 'Your Set'
dependencies:
- namespace/teaser
- namespace/myelement - name: Identifiziert Ihr Set eindeutig
- etikett: Anzeige-Name im TYPO3 Backend
- abhängigkeiten: Sets, die zuerst geladen werden müssen
# EXT:your_extension/Configuration/Sets/YourSet/settings.definitions.yaml
settings:
yourVendor.yourSet.maxSliderItems:
label: 'Maximum Slider Items'
description: 'Sets how many items can appear in the slider'
type: int
default: 5
yourVendor.yourSet.enableAdvancedMode:
label: 'Enable Advanced Mode'
description: 'Toggles additional features for power users'
type: bool
default: false # EXT:your_extension/Configuration/Sets/YourSet/settings.yaml
yourVendor.yourSet.maxSliderItems: 3
yourVendor.yourSet.enableAdvancedMode: true # EXT:your_extension/Configuration/Sets/YourSet/setup.typoscript
page = PAGE
page.10 = TEXT
page.10.value = This is loaded via My Site Set # EXT:your_extension/Configuration/Sets/YourSet/page.tsconfig
TCEFORM.tt_content {
imageorient.disabled = 1
} # config/sites/your-site/config.yaml
base: 'https://your-domain.com/'
rootPageId: 1
dependencies:
- your-vendor/your-set Minimales Beispiel: ein vollständiges Site Set
Das folgende Beispiel ist ein vollständiges, minimales Set in einem Site-Paket. Es definiert eine editierbare Einstellung, nutzt sie in TypoScript und aktiviert das Set für eine Site. Dateinamen und Schlüssel folgen dem Kapitel Site Sets in TYPO3 Explained 14.3 und gelten in v13.4 genauso.
Ordnerstruktur
my_sitepackage/
└─ Configuration/
└─ Sets/
└─ SitePackage/
├─ config.yaml # required
├─ settings.definitions.yaml # optional: editable settings
├─ setup.typoscript # optional: TypoScript setup
└─ page.tsconfig # optional: page TSconfig
config/sites/main/
├─ config.yaml # site configuration
└─ settings.yaml # values saved by the settings editor # EXT:my_sitepackage/Configuration/Sets/SitePackage/config.yaml
name: my-vendor/my-sitepackage
label: 'My site package'
dependencies:
- typo3/fluid-styled-content
# EXT:my_sitepackage/Configuration/Sets/SitePackage/settings.definitions.yaml
categories:
MySitePackage:
label: 'My site package'
settings:
MySitePackage.footerText:
label: 'Footer text'
category: MySitePackage
type: string
default: 'Powered by TYPO3' setup.typoscript: die Einstellung als Konstante nutzen
Site Settings stehen in TypoScript mit der Konstanten-Syntax bereit, in PAGEVIEW-Templates als {settings} (Site Package Tutorial).
# EXT:my_sitepackage/Configuration/Sets/SitePackage/setup.typoscript
page = PAGE
page.10 = TEXT
page.10.value = {$MySitePackage.footerText} # config/sites/main/config.yaml
base: 'https://example.com/'
rootPageId: 1
dependencies:
- my-vendor/my-sitepackage
# config/sites/main/settings.yaml (map format, written by the settings editor)
MySitePackage.footerText: 'Example GmbH' Leeren Sie die Caches und führen Sie vendor/bin/typo3 site:sets:list (Composer-Modus) oder typo3/sysext/core/bin/typo3 site:sets:list (Classic-Modus) aus, um zu prüfen, ob TYPO3 das Set findet. Die Root-Seite braucht keinen sys_template-Datensatz, weil die Site das TypoScript selbst liefert. Das Frontend gibt nun „Example GmbH“ aus, und ein Administrator kann den Wert im Settings-Editor ändern.
Als fertige Referenz dient das Multipurpose-Template T3Karma, ein TYPO3 Template mit Site Sets: Seine Version 14.0.0 (April 2026) hat die Theme-Konfiguration in Site Sets verlagert.
Kostenloser Leitfaden: Upgrade-Leitfaden für TYPO3
Der Umstieg von statischen Includes auf Site Sets erfolgt meist im Zuge eines Upgrades auf v13 oder v14. Der kostenlose Upgrade-Leitfaden plant dieses Upgrade in vier Phasen, inklusive Excel-Arbeitsblatt für Ihre Extension-Liste.
Kein statisches Einschließen von TypoScript, @import, Page TSconfig mehr
TypoScript Abhängigkeiten können nun über Site Set-Abhängigkeiten eingebunden werden, was eine strukturierte Alternative zu älteren Ansätzen wie static_file_include oder manuellen @import-Anweisungen bietet. Die Konfiguration wird auf site-Ebene aufgelöst, wodurch der Bedarf entfällt, die Einschluss-Reihenfolge manuell über Templates oder Extensions zu verwalten.
Wie lädt ein Site Set TypoScript?
Legen Sie setup.typoscript und constants.typoscript neben die config.yaml, dann lädt TYPO3 sie automatisch für jede Site, die das Set als Abhängigkeit hat. Sie werden ähnlich wie ein statisches Include in die TypoScript-Kette der Site eingefügt, und Site-Settings überschreiben Set-Konstanten immer (Feature #103439). Der Ordner sieht dann so aus:
EXT:your_extension/Configuration/Sets/YourSet/
│ ├─ config.yaml
│ ├─ setup.typoscript # Auto-loaded as TypoScript Setup
│ ├─ constants.typoscript # Auto-loaded as TypoScript Constants
│ └─ page.tsconfig # Auto-loaded as Page TSconfig Durch die Verwendung dieser Struktur kann TypoScript bereitgestellt werden, ohne auf manuelle @import Anweisungen oder die Option „Static TypoScript einbinden“ in sys_template Datensätzen angewiesen zu sein. Der Einschluss wird als Teil der Site Set Konfiguration auf site-Ebene behandelt.
Wie lädt ein Site Set Page TSconfig?
Ähnlich wie TypoScript wird Page TSconfig auf site-Ebene angewendet. Durch das Platzieren einer page.tsconfig Datei neben Ihrer config.yaml erben alle Seiten, die zu dieser site gehören, diese TSconfig-Einstellungen.
Dies ermöglicht eine fein abgestufte Kontrolle auf site-Ebene und reduziert den Bedarf an globalem TSconfig-Einschluss oder manueller Registrierung in ext_localconf.php.
Wie bearbeiten Sie Site-Einstellungen im Backend?
Mit TYPO3 v13.3 wurde ein neues Modul für den Site Settings Editor eingeführt. Redakteure und Integratoren können nun die Einstellungen pro Site direkt aus dem TYPO3 Backend verwalten, anstatt YAML Dateien manuell zu bearbeiten.
- Zentralisierte Verwaltung: In TYPO3 v13 finden Sie alle Site-spezifischen Einstellungen unter „Site Management > Settings“. In TYPO3 v14 heißt Site Management „Sites“, und der Settings-Editor ist Teil von „Sites > Setup“ (Feature #107628).
- Kategorie Organisation: Einstellungen können in Kategorien gruppiert werden, die in settings.definitions.yaml deklariert werden.
- Minimaler Change Footprint: Nur Werte, die von den Set-Standardwerten abweichen, werden in config/sites/<site>/settings.yaml geschrieben. In v13.3 stand das Modul nur Administratoren zur Verfügung (Feature #104794).
Wenn Sie z.B. ein benutzerdefiniertes Set mit der folgenden settings.definitions.yaml haben:
# EXT:my_extension/Configuration/Sets/MySet/settings.definitions.yaml
categories:
myCategory:
label: 'My Category'
settings:
my.example.setting:
label: 'My example setting'
category: myCategory
type: string
default: ''
my.seoRelevantSetting:
label: 'My SEO relevant setting'
category: seo
type: int
default: 5 Im Editor für die Website-Einstellungen finden Sie einen neuen Abschnitt mit der Bezeichnung "Meine Kategorie", in dem Sie den Standardwert von my.example.setting außer Kraft setzen können.
Verantwortungsaufteilung: Entwickler vs. Editor
- Entwickler: Definiert das Einstellungs-Schema, Datentypen, Standardwerte und Kategorien in settings.definitions.yaml.
- Editor: Überschreibt erlaubte Werte über den Site Settings Editor im TYPO3-Backend.
- Speicherung: Definitionen leben in YAML-Dateien, während überschreibene Werte separat gespeichert und nur bei Änderungen beibehalten werden.
Was ändert sich bei Site Sets in TYPO3 v14?
Site Sets funktionieren in TYPO3 v14 grundsätzlich wie in v13; neu sind vor allem Route Enhancer in Sets und geänderte Namen von Backend-Modulen. Stand November 2026 nennt get.typo3.org TYPO3 v14.3 als LTS-Version für neue Projekte und v13.4 LTS mit kostenlosem Support bis zum 31. Dezember 2027; beide laufen mit PHP 8.2 bis 8.5.
- Route Enhancer in Sets (v14.1): Ein Set kann neben der config.yaml eine route-enhancers.yaml mitbringen. Die Enhancer werden in der Reihenfolge der Abhängigkeiten geladen, die Site-Konfiguration hat weiterhin Vorrang (Feature #107837). Unser TYPO3 Routing Leitfaden für v13 und v14 erklärt Route Enhancer im Detail.
- Neue Modulnamen (v14.0): Aus Site Management wird Sites, und das frühere Modul Settings ist Teil von Sites > Setup (Feature #107628).
- settings.yaml als Map (13.4.x und v14): Der Settings-Editor schreibt flache Schlüssel wie
foo.bar: 'value'. Verschachtelte Strukturen werden weiterhin gelesen, Sets sollten aber das Map-Format nutzen (Important #106894).
Alles weitere zu v14 finden Sie in unseren TYPO3 v14 Release Notes und dem Upgrade-Leitfaden.
Erweiterte Anwendungsfälle
Extensions im Stil eines Frameworks
Eine Extension kann mit mehreren Sets (z. B. "basic", "pro", "enterprise") geliefert werden, die jeweils unterschiedliche Konfigurationen aufweisen. Site-Administratoren wählen aus, welches Set der Komplexität ihrer Site entspricht.
Konsistenz für mehrere Sites
Wenn Sie mehrere Sites mit gemeinsamen Funktionen betreiben, können Sie sicherstellen, dass sie alle dasselbe Basisset erben, während Sie site-spezifische Anpassungen in separaten settings.yaml oder sogar über den Site Settings Editor vornehmen.
Schrittweise Migration
Bei bestehenden TYPO3 Installationen können Sie ältere TypoScript-Sets nach und nach migrieren. Beginnen Sie mit einem einzigen Set, verschieben Sie Ihre bestehenden @import oder statischen Includes in setup.typoscript und constants.typoscript und entfernen Sie alte Referenzen aus sys_template , sobald diese stabil sind.
Wann eine schrittweise Migration nicht empfohlen wird
Projekte mit stark experimentellen Konfigurationen, häufigen kurzfristigen Überschreibungen oder instabilen Extension-Setups könnten davon profitieren, die Migration zu verschieben, bis die Konfiguration stabilisiert ist.
Wie migrieren Sie von statischen Templates zu Site Sets?
Migrieren Sie eine Site nach der anderen: Bauen Sie den sys_template-Datensatz als Site Set nach, vergleichen Sie die Ausgabe und entfernen Sie dann den Datensatz. Quellen: das Changelog zu v13.1 und die TypoScript-Referenz 14.3.
- Listen Sie auf, was der sys_template-Datensatz der Root-Seite enthält: statische Includes, Konstanten, Setup und jedes @import.
- Führen Sie
site:sets:listaus, um zu sehen, welche installierten Extensions bereits Sets mitbringen, zum Beispiel typo3/fluid-styled-content. - Legen Sie in Ihrem Site-Paket ein Set an und tragen Sie diese Extension-Sets statt der statischen Includes unter dependencies ein.
- Verschieben Sie Setup und Konstanten in setup.typoscript und constants.typoscript des Sets. Behalten Sie @import nur für Dateien im selben Paket.
- Definieren Sie für Konstanten, die Redakteure ändern sollen, eine gleichnamige Einstellung in der settings.definitions.yaml; Site Settings haben Vorrang vor den Konstanten des Sets.
- Verschieben Sie Page TSconfig in die page.tsconfig des Sets und alles aus ext_typoscript_setup.typoscript in die setup.typoscript.
- Tragen Sie das Set in die Abhängigkeiten der Site ein, in der config.yaml oder im Backend (v13: Site Management > Sites, v14: Sites > Setup).
- Vergleichen Sie die Frontend-Ausgabe und entfernen Sie dann den alten sys_template-Datensatz. Bleibt er bestehen, wird er nach dem TypoScript der Site angewendet und kann es überschreiben.
Häufige Fehler und Fehlersuche
Die meisten Probleme mit Site Sets betreffen Benennung, fehlende Setting-Definitionen oder den Geltungsbereich von Templates. Prüfen Sie zuerst Folgendes:
- Das Set wird nicht aufgelistet: Prüfen Sie, ob die Extension installiert ist, ob name im Format vendor/name eindeutig ist und ob das Set nicht mit
hidden: trueoder der User-TSconfig-Optionoptions.sites.hideSetsausgeblendet wird. - Ein Wert in der settings.yaml hat keine Wirkung: Die Einstellung braucht eine Definition in der settings.definitions.yaml des Sets oder einer seiner Abhängigkeiten.
- Settings sind in einem Content-Element-Template leer: {settings} steht in PAGEVIEW-Templates zur Verfügung; FLUIDTEMPLATE-basierte Templates brauchen einen Data Processor.
Welche Vorteile bringen Site Sets in der Praxis?
In der Praxis betreffen Site Sets hauptsächlich, wie die Konfiguration strukturiert und verwaltet wird, anstatt neue Frontend- oder redaktionelle Funktionen einzuführen.
- Zeitersparnis: Die Konfiguration wird auf site-Ebene gruppiert, wodurch der Bedarf entfällt, Einstellungen über mehrere Templates oder Einschlussmechanismen hinweg nachzuverfolgen.
- Konsistenz: Gemeinsame Konfigurationen können über mehrere sites hinweg wiederverwendet werden, was den Teams hilft, dieselben strukturellen Standards in Multi-Site-Umgebungen anzuwenden.
- Reduzierter globaler Bereich: TypoScript, Page TSconfig und Einstellungen sind pro site definiert, was hilft, unbeabsichtigte Nebeneffekte in komplexen Installationen zu begrenzen.
- Editor-Interaktion: Wo Einstellungen absichtlich freigegeben werden, können Editoren Werte über das Backend anpassen, ohne Konfigurationsdateien zu bearbeiten.
- Laufende Kompatibilität: Site Sets richten sich nach der Konfigurationsrichtung, die in TYPO3 v13 eingeführt wurde, und ermöglichen es Projekten, aktuellen Core-Konventionen zu folgen, ohne auf ältere Muster angewiesen zu sein. Statische Includes in sys_template-Datensätzen funktionieren in v13 und v14 weiterhin, die TypoScript-Referenz empfiehlt für v13 und neuer aber Sets.
Schlussfolgerung
Site Sets führen eine strukturierte Möglichkeit ein, die site-spezifische Konfiguration in TYPO3 v13 zu verwalten, indem TypoScript, Page TSconfig und Einstellungen in klar definierte, site-spezifische Einheiten gruppiert werden.
Sie verringern die Abhängigkeit von verstreuten Konfigurationsdatensätzen und machen Abhängigkeiten zwischen Konfigurationsebenen expliziter. Für Teams, die mit Multi-Site-Setups, geteilten Konfigurationen oder langfristig laufenden TYPO3-Projekten arbeiten, bieten Site Sets eine konsistente Grundlage, die mit dem in TYPO3 v13 eingeführten Konfigurationsmodell übereinstimmt.
Gleichzeitig sind sie so konzipiert, dass sie mit bestehenden Ansätzen koexistieren, wodurch eine schrittweise Einführung möglich ist, ohne eine sofortige Refaktorisierung zu erzwingen.
Wie bei anderen TYPO3-Konfigurationsmechanismen hängt ihr Wert davon ab, wie bewusst sie eingesetzt werden. Wenn Site Sets durchdacht angewendet werden, können sie helfen, die Konfiguration wartbar und transparent zu halten, während sich Projekte weiterentwickeln.
Das Upgrade planen, das Site Sets mitbringt
Site Sets setzen TYPO3 v13 oder v14 voraus. Der kostenlose Upgrade-Leitfaden für TYPO3 begleitet Sie von der Bestandsaufnahme bis zum Go-live, mit Arbeitsblatt für Ihre Extensions.
FAQs
Nein. Site Sets sind in TYPO3 v13 optional und koexistieren mit bestehenden Konfigurationsmethoden. Projekte können weiterhin sys_template, statisches TypoScript oder Extension-basierte Konfiguration verwenden und Site Sets schrittweise einführen, wenn und wo sie sinnvoll sind.
Nein. Site Sets ersetzen nicht TypoScript. Sie bieten eine strukturierte Möglichkeit, TypoScript auf site-Ebene bereitzustellen und einzugrenzen, aber TypoScript selbst bleibt die Konfigurationssprache für Rendering und Verhalten.
Ja. Eine TYPO3-Site kann von mehreren Site Sets abhängen. TYPO3 löst sie basierend auf deklarierten Abhängigkeiten und der Lade-Reihenfolge auf, wodurch eine geschichtete Konfiguration ohne manuelles Einschluss-Management ermöglicht wird.
Einstellungsdefinitionen werden in YAML-Dateien innerhalb des Site Sets gespeichert. Nur überschreibene Werte werden separat gespeichert, wodurch die Konfiguration größtenteils dateibasiert und versionskontrolliert bleibt.
Ja. Site Sets sind Teil von TYPO3 v13 LTS und für den langfristigen Einsatz konzipiert. Sie sollen eine stabile Konfigurationsverwaltung über kleinere Updates im v13 LTS-Lifecycle hinweg unterstützen.
Nicht unbedingt. Site Sets sind besonders nützlich für Extensions, die site-spezifische Konfigurationen oder wiederverwendbare Integrationslogik bereitstellen. Extensions, die sich ausschließlich auf Backend-Funktionalitäten oder isolierte Features konzentrieren, benötigen sie möglicherweise nicht.
Souveräne TYPO3 KI: AI Foundation ist kostenlos und Open Source, sechs KI-Erweiterungen bauen darauf auf.
TYPO3 KI entdecken
Wolfgang Weber
Brand & Communication LeadWolfgang Weber gestaltet TYPO3 mit Leidenschaft und Fachwissen. Als TYPO3-Enthusiast beim T3Planet Shop hat er an TYPO3-Projekten mitgewirkt, die Websites schneller und sicherer machen. Abseits von TYPO3 findet man ihn wahrscheinlich beim Erkunden lokaler Cafés oder beim Fußball.
More From Author