The Pepperi native apps (iOS and Android), and web app are translated to the following languages:
- Chinese
- Dutch
- French
- German
- Italian
- Japanese
- Polish
- Portuguese
- Spanish
In addition to these languages Pepperi supports multi-language customization, allowing users to be presented with the translations of all your field titles and other texts from Pepperi configuration based on the language they selected on their phone/tablet device. Even if the language of the device is not one of the languages our app is translated to, you may upload your own translation of field titles and other texts in any language you require.
Please note that this feature is available for Pepperi Ultimate plan only. To enable it, please contact your Pepperi Success Manager.
NOTE: "Enable Localization" flag must be enabled in order for the Translation files to take effect.
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 profile that the string belongs to. The default profiles are Rep, Buyer and Admin, and any other profiles that you have created. The forms can be customized with different field titles for each profile, 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.
NOTE: Profiles see the translation of the profile they are "Based on"
If you have additional profiles that are based on "Rep" for example, then you can translate the string for Rep only, and delete the other lines of that string for the additional profiles, and they will all see the "Rep" profile translation.
For more info on Profiles see Assign functionality and configurations by user Profiles
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.
[OA#48601]OrderCartGrid.UnitPriceAfterDiscount,Rep,Unit Price After Discount
[OA#48601]OrderCartGrid.UnitPriceAfterDiscount,Buyer,Unit Price After Discount
[OA#48601]OrderCartGrid.UnitPriceAfterDiscount,Admin,Unit Price After Discount
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).
0 comments
Please sign in to leave a comment.