Feature: #98303 - PSR-14 events for modifying language overlays¶
See forge#98303
Description¶
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
Impact¶
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.