Back Office Translations overview

Edit on GitHub

The Back Office Translations feature introduces a way to translate the Administration interface (Zed) into different languages in a per-user manner. In terms of hierarchy, only the user with administrative rights who has access to User Control section of Zed, can manage the feature. For example, a team of developers might include a French and a German. In this case, the Shop Administrator might set up French and German Zed translations for their accounts accordingly, and those translations wouldn’t interfere with each other.

There are two ways to assign a language to a user account: from the Create new User page of the User Control>User section or from the Edit User page of User Control>User section if the user is already created. Once the account language is changed, the respective user will see that their interface is translated into the corresponding language upon their next login.

Translations are added by means of uploading .csv extension files to the folders of the target modules - data/translation/Zed/{ModuleName}/{locale_code}.csv

File name examples can be found below:

  • en_US.csv
  • en_UK.csv
  • de_DE.csv
  • fr_FR.csv

Once a new translation file is uploaded, regenerate translation cache to reflect the changes by running the following commands:

translator:clean-cache
translator:generate-cache

Each file should consist of key and translation columns without headers. Example:

Add Group Gruppe hinzufügen
Add new Role Neue Rolle hinzufügen
Add Rule Regel hinzufügen
If a translation is missing, the corresponding key is displayed instead.

Unlike Glossary section of Zed which is used for managing Front-end(Yves) translations, there is no interface for managing Zed translations currently. All the translations are managed by updating corresponding .csv files directly. Similarly to uploading translation files, you need to regenerate translation cache to reflect the changes after updating them. Use the commands to do that.

Newly created and all the existing modules are shipped with German translation by default. If you want to add a different language, you can follow the instructions from the Back Office translations feature integration guide.

The scheme below illustrates relations between Translator, UserExtension, User, UserLocale and UserLocaleGui modules:

image