codappix/typo3-page-specific-typoscript

Loads TypoScript files from file system, based on current Page

v1.0.0 2025-06-25 07:50 UTC

Requires

• php: ^8.1 || ^8.2 || ^8.3 || ^8.4
• typo3/cms-core: ^12.4 || ^13.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• typo3/testing-framework: ^8.2

GPL-2.0-or-later

• Daniel Siepmann

README

Hooks into TYPO3 system to load TypoScript files based on current TYPO3 page.

Why

There are a lot of legacy TYPO3 sites. Those often have multiple sys_template records, loading TypoScript on specific pages.

This prevents tools like fractor to migrate the TypoScript.

Also many developers consider it best practice to not maintain TypoScript or Page TSconfig within the database. Instead it should be in the file system, allowing version control and deployment.

Usage

Once installed, the extension will check the following locations, within any active TYPO3 extension and include found files if any:

TypoScript Setup: Configuration/TypoScript/PageSpecific/<pageUid>/setup.typoscript
TypoScript Constants: Configuration/TypoScript/PageSpecific/<pageUid>/constants.typoscript
Page TSconfig: Configuration/TSconfig/PageSpecific/<pageUid>/Setup.tsconfig

TODO

1. Implement use case for User TSconfig.