#111326Deprecate LanguageAspect::OVERLAYS_ON
Description
The overlay type LanguageAspect::OVERLAYS_ON (“on”) is never produced by a site configuration: LanguageAspectFactory maps fallbackType “strict” to OVERLAYS_ON_WITH_FLOATING, “fallback” to OVERLAYS_MIXED and “free” to OVERLAYS_OFF. It can only be reached by constructing a LanguageAspect manually.
PageRepository already treats OVERLAYS_ON and OVERLAYS_ON_WITH_FLOATING identically. The only difference is that records in the requested language without a default language counterpart (“floating” records, l10n_parent = 0) are excluded by TypoScript CONTENT and Extbase queries. For CONTENT, this can be controlled per query via “includeRecordsWithoutDefaultTranslation”.
To reduce the number of overlay modes, OVERLAYS_ON is deprecated in favor of OVERLAYS_ON_WITH_FLOATING. Constructing a LanguageAspect with “on” triggers a deprecation notice; the behavior is kept until removal in TYPO3 v16.
This is a first step towards simplifying the language overlay handling (OVERLAYS_MIXED vs. OVERLAYS_ON_WITH_FLOATING, consistent floating record handling between TypoScript and Extbase).
Reviews 2
History 12
-
Gerrit Code Review pushed patch set 1 for main to change 97316 status
NewUnder Review <span data-processor="relativetime" data-value="2026-11-03T11:19:27+00:00" > 11/03/26, 11:19 </span> -
Benni Mack commented and changed status
Under ReviewResolved done0 %100 % <span data-processor="relativetime" data-value="2026-11-04T05:35:14+00:00" > 11/04/26, 05:35 </span>
Applied in changeset commit:15f0deedb297bc53c540e53c976c228fa603d439.