Localization in Extbase

Warning

The information on this page might be outdated!

Localization of Extbase models

Identifiers in localized models

Domain models have a main identifier uid and an additional property _localizedUid.

Depending on whether the overlay type language aspect is enabled (LanguageAspect::OVERLAYS_ON or LanguageAspect::OVERLAYS_MIXED) or disabled (LanguageAspect::OVERLAYS_OFF), the identifier contains different values.

When the overlay language aspect is enabled, then the uid property contains the uid value of the default language record and the uid of the translated record is kept in the _localizedUid.

Context	Record in language 0	Translated record
Database	uid:2	uid:11, l10n_parent:2
Domain object values with Overlay language aspect enabled	uid:2, _localizedUid:2	uid:2, _localizedUid:11
Domain object values with Overlay language aspect disabled	uid:2, _localizedUid:2	uid:11, _localizedUid:11

Hint

If your project uses typo3/cms-workspaces there is yet another additional property, _versionedUid. Refer to the Workspaces documentation for details on workspace overlays.

Translating labels

This chapter covers how Extbase handles records across languages. Translating the labels of an extension — button captions, flash messages, validation errors — is a separate topic: