Inheritance diagram for TYPO3\CMS\Core\Context\LanguageAspect:

Public Member Functions
	__construct (int $id=0, int $contentId=null, string $overlayType=self::OVERLAYS_ON_WITH_FLOATING, array $fallbackChain=[])

string	getOverlayType ()

int	getId ()

int	getContentId ()

	getFallbackChain ()

bool	doOverlays ()

string	getLegacyLanguageMode ()

string	getLegacyOverlayType ()

int string array	get (string $name)

Public Attributes
const	OVERLAYS_OFF = 'off'

const	OVERLAYS_MIXED = 'mixed'

const	OVERLAYS_ON = 'on'

const	OVERLAYS_ON_WITH_FLOATING = 'includeFloating'

Protected Attributes
int	$id = 0

int	$contentId = 0

array	$fallbackChain = array( )

string	$overlayType

Detailed Description

The Aspect is usually available as "language" property, and can be used to find out the "overlay"/data retrieval strategy.

"id" (languageId, int)

‪formally known as $TSFE->sys_language_uid
‪the requested language of the current page (frontend)
‪used in menus and links to generate "links in language with this ID"

"contentId" (int)

‪formally known as $TSFE->sys_language_content
‪the language of records to be fetched
‪if empty, "languageId" is used.

"fallbackChain"

‪when "fallback" go with
‪depends what "contentId" value should be set
‪defined in config.sys_language_mode (strict/content_fallback:4,5,stop/ignore?)
‪previously known as $TSFE->sys_language_mode
‪defines "contentId" based on "if the current page is available in this language"
- ‪"strict"
- ‪"fallback" if current page is not available, check the fallbackChain" - "fallbackAndIgnore"

"overlayType"

‪defines which way the records should be fetched from ($TSFE->sys_language_contentOL and config.sys_language_overlay)
‪usually you fetch language 0 and -1, then take the "contentId" and "overlay" them
- ‪here you have two choices
  1. ‪"on" if there is no overlay, do not render the default language records ("hideNonTranslated")
  2. ‪"mixed" - if there is no overlay, just keep the default language, possibility to have mixed languages - config.sys_language_overlay = 1
  3. ‪"off" - do not do overlay, only fetch records available in the current "contentId" (see above), and do not care about overlays or fallbacks - fallbacks could be an option here, actually that is placed on top
  4. ‪"includeFloating" - on + includeRecordsWithoutDefaultTranslation

Definition at line 56 of file LanguageAspect.php.

Constructor & Destructor Documentation

◆ __construct()

TYPO3\CMS\Core\Context\LanguageAspect::__construct	(	int	$id = `0`,
		int	$contentId = `null`,
		string	$overlayType = `self::OVERLAYS_ON_WITH_FLOATING`,
		array	$fallbackChain = `[]`
	)

Create the default language

Parameters

int	$id
int \| null	$contentId
string	$overlayType
array	$fallbackChain

Definition at line 87 of file LanguageAspect.php.

References TYPO3\CMS\Core\Context\LanguageAspect\$contentId, TYPO3\CMS\Core\Context\LanguageAspect\$fallbackChain, TYPO3\CMS\Core\Context\LanguageAspect\$id, and TYPO3\CMS\Core\Context\LanguageAspect\$overlayType.

Member Function Documentation

◆ doOverlays()

bool TYPO3\CMS\Core\Context\LanguageAspect::doOverlays ( )

Whether overlays should be done

Returns: ‪bool

Definition at line 138 of file LanguageAspect.php.

References TYPO3\CMS\Core\Context\LanguageAspect\OVERLAYS_OFF.

◆ get()

int string array TYPO3\CMS\Core\Context\LanguageAspect::get ( string $name )

Fetch a property.

Parameters

string $name

Returns: ‪int|string|array

Exceptions

AspectPropertyNotFoundException

Implements TYPO3\CMS\Core\Context\AspectInterface.

Definition at line 188 of file LanguageAspect.php.

References TYPO3\CMS\Core\Context\LanguageAspect\$contentId, TYPO3\CMS\Core\Context\LanguageAspect\$fallbackChain, TYPO3\CMS\Core\Context\LanguageAspect\$id, TYPO3\CMS\Core\Context\LanguageAspect\$overlayType, TYPO3\CMS\Core\Context\LanguageAspect\getLegacyLanguageMode(), and TYPO3\CMS\Core\Context\LanguageAspect\getLegacyOverlayType().

◆ getContentId()

int TYPO3\CMS\Core\Context\LanguageAspect::getContentId ( )

Contains the language UID of the content records that should be overlaid to would be fetched. This is especially useful when a page requested with language=4 should fall back to showing content of language=2 (see fallbackChain)