Interface languages
What it does
Keel's menus, buttons and messages come in English, Croatian and German. Content stays in the languages it is written in. These options decide which interface languages users can pick, and which one they get before they pick. Admins can set the same two things in Customize → Language; once saved there, that choice wins over these options.
Default
All three languages. Until a user picks one, Keel follows the language of their Pimcore account.
Options
| Key | Default | What it does |
|---|---|---|
languages.available | [en, hr, de] | Languages users can pick: any of en, hr, de |
languages.default | none | Language until a user picks one. Empty (~): the user's Pimcore account language. Must be one of available. |
Example
keel:
languages:
available: [en, hr]
default: hr
default: de with available: [en, hr] stops cache:clear with keel.languages.default: "de" is not one of available (en, hr).
Which language a user gets
The first of these that is in available (Customize's list when an admin saved one there, else languages.available):
- The language the user picked (saved with the user)
- The default chosen in Customize → Language, else
languages.default - The language of the user's Pimcore account
- The first language of
available
A change of languages.default reaches every user who has not picked a language. If the language a user picked is no longer in available, Keel goes on down this list.
The Language page
Users pick their language under Setup → Language, which opens My view at the Look group. The choice lists the offered languages and warns that the whole admin panel will refresh. With only one language in available, there is nothing to pick.
The choice is saved with the user, so it follows them to any browser. Reset to team default goes back to the project default below. The older Keel pages in the classic Pimcore admin keep a separate Language page that saves the same choice. The beta has no language choice in My view.
keel:setup texts in the console are English only. Pimcore notifications from assignments follow each recipient's Pimcore language.
What admins change in Customize
Customize → Language (Customize): the default for everyone (Each person's
Pimcore language or one language) and which languages people can choose. Nothing is stored there until an admin
changes it; until then these keel.yaml options decide. Reset to automatic in Customize hands it back to
keel.yaml. Each user still picks their own language in My view.