Issue Task Under Review

#111413Deprecate language key "default" in TypoScript _LOCAL_LANG

Benni Mack 11/11/26, 15:22 updated 11/11/26, 15:39

Description

The source labels of all language files (XLIFF files without language prefix, e.g. locallang.xlf) are English. Their language code is “en”, like “de” or “fr” for translations. The language key “default” is only a historical alias for these source labels and should be phased out of all places where integrators and extension authors define languages. Backend users (#108783) and the preferred browser language detection already use “en”.

This task covers the user-land side:

  • Deprecate TypoScript _LOCAL_LANG.default in favour of _LOCAL_LANG.en. Labels for “en” override labels for English and additionally act as last-resort fallback for all other languages (the role “default” had so far). “default” keeps working until v16.0 and triggers a deprecation.
  • Treat the site language setting typo3Language: default (deprecated since v12.3) as “en”.
  • EXT:form email finishers offer and store “en” instead of “default” as translation language.
  • Styleguide generates sites with typo3Language “en”.
  • Remove the obsolete “default” check in ResetPasswordController, as Locales::getPreferredClientLanguage() never returns “default” anymore.

The internal use of “default” (loading the base label files under the “default” key in LocalizationFactory, LabelFileResolver, LanguageService, lowlevel) will be handled in a separate task. Removing the “default” to “en” mapping in Locale is planned for v16.

Reviews 1

History 01