Attention

TYPO3 v12 has reached end-of-life as of April 30th 2026 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.

Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here: TYPO3 ELTS.

BeforePageLanguageOverlayEvent

New in version 12.0

This event serves as a replacement for the removed hook $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['t3lib/class.t3lib_page.php']['getPageOverlay'].

The PSR-14 event \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 BeforeRecordLanguageOverlayEvent and AfterRecordLanguageOverlayEvent.

Example

Note

Currently, we do not have an example for this event. If you can provide a useful one, please open an issue with your code snippets or a pull request.

API

class BeforePageLanguageOverlayEvent

Fully qualified name: \TYPO3\CMS\Core\Domain\Event\BeforePageLanguageOverlayEvent

Event which is fired before a single page or a list of pages are about to be translated (or tried to be localized).

getPageInput ( )

Returns: array

setPageInput ( array $pageInput)

param $pageInput: the pageInput

getPageIds ( )

Returns: array

setPageIds ( array $pageIds)

param $pageIds: the pageIds

getLanguageAspect ( )

Returns: TYPO3CMSCoreContextLanguageAspect

setLanguageAspect ( \TYPO3\CMS\Core\Context\LanguageAspect $languageAspect)

param $languageAspect: the languageAspect