Feature: #98303 - PSR-14 events for modifying language overlays

See forge#98303


Three new PSR-14 events have been introduced which serve as a more powerful and flexible alternative for the now removed $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_page.php']['getRecordOverlay'] and $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_page.php']['getPageOverlay'] hooks.

The new PSR-14 events allow listeners to modify corresponding information, before and after TYPO3 tries to overlay a language version of any kind of record. "Language Overlaying" is a Core concept of TYPO3 to find a suitable translation for a record and merged together with the base record.

  • \TYPO3\CMS\Core\Domain\Event\BeforeRecordLanguageOverlayEvent
  • \TYPO3\CMS\Core\Domain\Event\AfterRecordLanguageOverlayEvent
  • \TYPO3\CMS\Core\Domain\Event\BeforePageLanguageOverlayEvent


The event \TYPO3\CMS\Core\Domain\Event\BeforeRecordLanguageOverlayEvent can be used to modify information (such as the LanguageAspect or the actual incoming record from the database) before the database is queried.

The event \TYPO3\CMS\Core\Domain\Event\AfterRecordLanguageOverlayEvent can be used to modify the actual translated record (if found) to add additional information or do custom processing of the record.

\TYPO3\CMS\Core\Domain\Event\BeforePageLanguageOverlayEvent is a special event which is fired when TYPO3 is about to do the language overlay of one or multiple pages, which could be one full record, or multiple page IDs. This event is fired only for pages and in-between the events above.