#111336Deprecate legacy language mode and overlay type of LanguageAspect
Description
LanguageAspect contains two compatibility methods from TYPO3 v9, when the language aspect replaced the TypoScript options config.sys_language_mode and config.sys_language_overlay:
- LanguageAspect::getLegacyLanguageMode() (also available as property “legacyLanguageMode”)
- LanguageAspect::getLegacyOverlayType() (also available as property “legacyOverlayType”)
getLegacyOverlayType() has no usage in Core anymore.
getLegacyLanguageMode() is only used in PageInformationFactory::settingLanguage() to decide how to resolve the content language of a page that is not translated. The language aspect there is always created by LanguageAspectFactory::createFromSiteLanguage(), whose fallback chain is never empty and never “off” (it always ends with “pageNotFound”, or is [0] for unknown fallback types). The method therefore always returns “content_fallback” for site languages, and the “strict” and default branches of the switch in PageInformationFactory cannot be reached.
The unreachable branches should be removed, and both legacy methods (and the related properties) deprecated, to simplify the language handling.
Reviews 1
History 12
-
Gerrit Code Review pushed patch set 1 for main to change 97407 status
NewUnder Review <span data-processor="relativetime" data-value="2026-11-06T21:34:13+00:00" > 11/06/26, 21:34 </span> -
Benni Mack commented and changed status
Under ReviewResolved done0 %100 % <span data-processor="relativetime" data-value="2026-11-07T21:35:10+00:00" > 11/07/26, 21:35 </span>
Applied in changeset commit:99e58fa5e4633b9507650b158dc4096c492f4408.