..  include:: /Includes.rst.txt
..  index:: Events; ModifyTypoScriptConfigEvent
..  _ModifyTypoScriptConfigEvent:

===========================
ModifyTypoScriptConfigEvent
===========================

..  versionadded:: 13.0
    This event has been introduced to serve as a direct replacement for the removed
    :php:`$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['tslib/class.tslib_fe.php']['configArrayPostProc']`
    hook.

The PSR-14 event :php:`\TYPO3\CMS\Frontend\Event\ModifyTypoScriptConfigEvent`
allows listeners to adjust and react on TypoScript :ref:`config <t3tsref:config>`.

This event is dispatched *before* final TypoScript :typoscript:`config` is
written to the cache, and *not* when a page can be successfully retrieved from
the cache, which is typically the case in "page is fully cached" scenarios.

This incoming :php:`$configTree` has already been merged with the determined
PAGE :typoscript:`page.config` TypoScript of the requested "type" /
:typoscript:`typeNum` and the global TypoScript setup :typoscript:`config`.

The result of this event is available as a
:ref:`request attribute <typo3-request-attribute-frontend-typoscript>`:

..  code-block:: php

    $request->getAttribute('frontend.typoscript')->getConfigArray()

..  caution::
    Registered listener can *set* a modified setup config
    :abbr:`AST (Abstract Syntax Tree)`. Note the TypoScript AST structure is
    still marked **internal** within TYPO3 v13 and may change later, using the
    event to **write** different :typoscript:`config` data is thus still a bit
    risky.

Example
=======

..  include:: /_includes/EventsContributeNote.rst.txt

API
===

..  include:: /CodeSnippets/Events/Frontend/ModifyTypoScriptConfigEvent.rst.txt