Issue Task Resolved

#111326Deprecate LanguageAspect::OVERLAYS_ON

Benni Mack 11/03/26, 08:00 updated 11/04/26, 05:35

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

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