Einbindung der Static Templates über das TYPO3-Sitepackage

Dabei nicht durcheinander zu kommen ist beinahe unmöglich. Das Einbinden der Static Templates muss häufig in einer bestimmten Reihenfolge passieren, da die einzelnen Templates aufeinander aufbauen und entsprechend jeweils voneinander abhängig sind.

Ergänzung 01/2025: Seit TYPO3 v13 gibt es das neue "Site Sets"-Feature. Über Site Sets lassen sich TypoScript, Page TSconfig und weitere Settings auf ganz neue Weise in einer Website einbinden. Die Zuweisung eines Site Sets erfolgt über die Site Configuration. Da dort die rootPageId definiert ist, erfolgt die Zuweisung zur Site automatisch. Der Template-Datensatz auf der Rootpage kann somit entfallen, die Static Includes werden nicht mehr benötigt.

Extensions können ebenfalls Site Sets bereitstellen, die ihr in eurer Konfigurationsdatei als Dependency ergänzen könnt. Falls einzelne Extensions noch keine Site Sets anbieten, könnt ihr deren TypoScript weiterhin auf dem unten beschriebenen Weg einbinden.

Wie Site Sets in der Praxis verwendet werden können, zeigt das offizielle TYPO3 Sitepackage Tutorial.

Wir empfehlen euch, neue Projekte direkt mit Site Sets einzurichten. Bestehende Projekte können auch nach dem Upgrade auf TYPO3 v13 jederzeit umgestellt werden.

Wir bei Marketing Factory arbeiten mit dem Versionierungs­system Git. Oft genug arbeiten mehrere Mitarbeiter gleichzeitig an demselben Projekt, aber in verschiedenen Branches.

Würde einer der Mitarbeiter nun eine Extension mit einem Static Template hinzufügen, so müsste jeder weitere Mitarbeiter – bei dem Wechsel in denselben Branch – ebenfalls in seiner lokalen Entwicklungs­umgebung die Static Templates anpassen. Gleiches würde auch passieren, wenn der Branch auf einem Test- oder Abnahmesystem ausgespielt wird und dort zuvor ein anderer Branch ausgespielt war.

Ergo: Unnötiger, mehrfacher Aufwand sowie erhöhter Dokumentationsbedarf.

constants.typoscript

//
// Dependencies
// ------------------------------------------
@import 'EXT:bootstrap_package/Configuration/TypoScript/constants.typoscript'
@import 'EXT:blog/Configuration/TypoScript/Integration/constants.typoscript'
@import 'EXT:picturecredits/Configuration/TypoScript/constants.typoscript'
@import 'EXT:sg_cookie_optin/Configuration/TypoScript/Frontend/constants.typoscript'
@import 'EXT:bw_captcha/Configuration/TypoScript/constants.typoscript'
@import 'EXT:solr/Configuration/TypoScript/Solr/constants.typoscript'


//
// Project setup
// ------------------------------------------
@import 'EXT:project_sitepackage/Configuration/TypoScript/Constants/*.typoscript'

setup.typoscript

//
// Dependencies
// ------------------------------------------
@import 'EXT:bootstrap_package/Configuration/TypoScript/setup.typoscript'
@import 'EXT:blog/Configuration/TypoScript/Integration/setup.typoscript'
@import "EXT:typo3_encore/Configuration/TypoScript/setup.typoscript"
@import 'EXT:picturecredits/Configuration/TypoScript/setup.typoscript'
@import 'EXT:form_element_linked_checkbox/Configuration/TypoScript/setup.typoscript'
@import 'EXT:sg_cookie_optin/Configuration/TypoScript/Frontend/setup.typoscript'
@import 'EXT:bw_captcha/Configuration/TypoScript/setup.typoscript'
@import 'EXT:solr/Configuration/TypoScript/Solr/setup.typoscript'
@import 'EXT:yoast_seo/Configuration/TypoScript/setup.typoscript'


//
// Project setup
// ------------------------------------------
// Elements
@import 'EXT:project_sitepackage/Configuration/TypoScript/Elements/01_Configuration.typoscript'
@import 'EXT:project_sitepackage/Configuration/TypoScript/Elements/02_Plugin.typoscript'
@import 'EXT:project_sitepackage/Configuration/TypoScript/Elements/10_PageTemplate.typoscript'

// Content Elements
@import 'EXT:project_sitepackage/Configuration/TypoScript/ContentElements/Helper/*.typoscript'
@import 'EXT:project_sitepackage/Configuration/TypoScript/ContentElements/*.typoscript'

// Extensions
@import 'EXT:project_sitepackage/Configuration/TypoScript/Extensions/*.typoscript'

Sowohl bei den TypoScript-Constants als auch beim Setup binden wir zuerst alle Extensions ein, die im Projekt benötigt werden. Das können Third-Party-Extensions sein, aber z.B. auch projektspezifische Eigenentwicklungen.

Erst danach folgt die Einbindung der weiteren, individuellen Konfigurationen aus dem Sitepackage:

• das Überschreiben der TS-Konstanten aus Third-Party-Extensions
• projektspezifische Grundkonfigurationen
• Konfigurationen eigener (Inhalts-)-Elemente
• Anpassung oder Ergänzung von Extension-Konfigurationen
• das PAGE-Setup (oder Overrides eines bestehenden PAGE-Objekts, wenn man Lösungen wie das Bootstrap Package verwendet)

Et voilá: Statt eine aufwendige, aufeinander aufbauende Reihenfolge abrattern zu müssen, können sämtliche Static Templates einfach in einem Schritt inkludiert werden.