Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

EZP-29961: Add preferred language value to User Preferences #525

Merged
merged 3 commits into from Feb 7, 2019
Merged

EZP-29961: Add preferred language value to User Preferences #525

Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6844886
EZP-29961: Add preferred language value to User Preferences
Feb 6, 2019
fd1d5dc
Fix after review
Feb 6, 2019
74da8a6
Update docs/guide/internationalization.md
MagdalenaZuba Feb 7, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
24 changes: 21 additions & 3 deletions docs/guide/internationalization.md
View file
Open in desktop
Expand Up @@ -268,20 +268,38 @@ You can also assign a Default content availability flag to Content Types (availa

Note that if a language is not provided in the list of prioritized languages and it is not the Content item's first language, the URL alias for this content in this language will not be generated.

## Translating the UI of eZ Platform
## Back Office languages

### Installing new UI translations

If you want to install a new language in your project, install the corresponding package.

For example, if you want to translate your application into French, run:

`composer require ezplatform-i18n/ezplatform-i18n-fr_fr`
`composer require ezplatform-i18n/ezplatform-i18n-fr_fr`

and then clear the cache.

Now you can reload your eZ Platform back end which will be translated in French (if your browser is configured to `fr_FR`.)

##### UI translation
!!! tip

If you do not want to add a bundle with Back Office translation, you can manually add the necessary xliff files.
Add the language in an array under `ezsettings.default.user_preferences.additional_translations`, for example:
DominikaK marked this conversation as resolved.
Show resolved Hide resolved

`ezsettings.default.user_preferences.additional_translations: ['pl_PL', 'fr_FR']`

Then, run `composer run post-update-cmd` and clear the cache.

##### Contributing Back Office translations

To learn how to contribute to a translation, see [Contributing translations](../community_resources/translations.md).

### Choosing language of the Back Office

Once you have language packages installed, you can switch the language of the Back Office
in the User Settings menu.

Otherwise, the language will be selected based on the browser language.
If you do not have a language defined in the browser, the language will be selected
based on `parameters.locale_fallback` in `default_parameters.yml`