Issue Task Resolved

#111336Deprecate legacy language mode and overlay type of LanguageAspect

Benni Mack 11/04/26, 06:10 updated 11/07/26, 21:35

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

  1. Benni Mack commented and changed status Under Review Resolved done 0 % 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.