BeforeLoadedUserTsConfigEvent
The PSR-14 event
\TYPO3\
can be used to add global static user TSconfig
before anything else is loaded. This is especially useful, if user TSconfig is
generated automatically as a string from a PHP function.
It is important to understand that this configuration is considered static and thus should not depend on runtime / request.
Example
EXT:my_extension/Classes/TypoScript/EventListener/MyEventListener.php
<?php
declare(strict_types=1);
namespace MyVendor\MyExtension\TypoScript\EventListener;
use TYPO3\CMS\Core\Attribute\AsEventListener;
use TYPO3\CMS\Core\TypoScript\IncludeTree\Event\BeforeLoadedUserTsConfigEvent;
#[AsEventListener(
identifier: 'my-extension/global-usertsconfig',
)]
final readonly class MyEventListener
{
public function __invoke(BeforeLoadedUserTsConfigEvent $event): void
{
$event->addTsConfig('global = a global setting');
}
}
API
- class BeforeLoadedUserTsConfigEvent
-
- Fully qualified name
-
\TYPO3\
CMS\ Core\ Typo Script\ Include Tree\ Event\ Before Loaded User Ts Config Event
Extensions can add global user TSconfig right before they are loaded from other sources like the global user.tsconfig file.
Note: The added config should not depend on runtime / request. This is considered static config and thus should be identical on every request.