Pepperi Knowledge Center

Multilingual configuration - Translation Files

Pepperi supports multi-language customization, allowing users to be presented with the translations of all your field titles based on the language they selected on their tablet.

Please note that this feature is available for certain Pepperi plans only. Please check with your Pepperi representative if your Pepperi plan includes multilingual configuration.

For example:

If your initial Pepperi account was created and setup in German, this means that the field titles in your views and forms will all be in German.

For mobile users who set their tablet language to another language, say French, the hard coded Pepperi app text will be displayed in French (since the app runs in 11 languages - including French) however, the field titles in your views and forms will remain in German.

There is an easy interface that allows you to load CSV files with the translations of the field titles so that they will also be in the tablet's selected language.

This article will explain how to:

1. Add the file templates for the languages you require

2. Export the provided CSV templates containing the field title translations

3. Translate the fields in the CSV template file using UTF-8 encoding

4. Import the template

For your reference sample templates in a few languages are included at the bottom of this article (do not upload these samples to your Pepperi account because the identifier strings differ for each account).

Templates for all languages can be exported from the Pepperi Web Admin following the instructions below.

Important things to note:

1. The import works in "Overwrite" mode. Meaning, if you import a partial list of translated strings, the strings not included will be displayed in the default language. Make sure to upload the entire file every time, even if you did not change part of the strings.

2. If you translate strings for one profile, for example "Rep", they will also display for other profiles, such as "Buyer", "Admin" or any others you may have created. So there is no need to duplicate the lines in the file for multiple profiles.

1. Add the file templates for the languages you require

Go to Settings -> Configuration Files -> Translation Files

Your default language will appear. You can download the template for the default language, by clicking on the Download template link.

To add a new language, click "+ Add new file"

Select the language from the menu.

The language will now appear in the list and the translations can be loaded.

2. Translate the CSV template file using UTF-8 encoding

Select the language you want to export and click on Action -> Export File

A CSV file will be downloaded to your computer.

Open the file in Notepad++ only and edit by editing the fields you want to add/edit the translation for.

Save the file in Notepad++ as a CSV file.

Important: If you open the file in Excel and save as CSV the format of any special characters will not be properly saved and the file you upload will not display well at all in the software. You must work with the file in Notepad++ only.

All the out of the box standard Pepperi fields will already be translated to the language you selected.

Any additional fields you added to your forms or custom fields will need to be translated.

The file contains 3 fields per row separated by commas:

UIControlType.APIName, RoleName, Value

UIControlType.APIName: is the string title (do not change anything in this column)

RoleName: is the Role that the string belongs to. The roles are Rep, Buyer and Admin. The forms can be customized with different field titles for each role, just as in the Pepperi Web Admin. Rep refers to the sales rep user on the tablet, Admin refers to the Pepperi Web Admin and Buyer is the customer using Pepperi Storefront for self-service ordering on a tablet or online.

Value: the translation of the string to the required language

For example this is a row that contains the Price field in the Cart Grid View. It contains the translation for each of the roles Rep, Buyer and Admin. If you translate only for Rep, then Admin and Buyer with their device set to the translated language will see the default language, and not the translated language.

Enter translations for any fields that are still in your default language in the third field -

Note that the string [OA#48061] is an identifier for the Transaction type. Each Transaction and Activity Type you have configured have the fields listed in this format. You need to translate the field for each occurrence across all types.

If you only have one Transaction Type (ie typical Sales Order) then it will only appear one time.

Save the file as a CSV file in Notepad++

4. Import the template

In the Pepperi Web Admin go to Settings -> Configuration Files -> Translation Files and select the language you want to import.

Select Action -> Import and select the file you saved in step 3.

All Admins, Reps and Buyers will now see the translated text. (Pepperi app users will need to synchronize Pepperi on their mobile devices).