Interface localization

SimpleOne supports multilanguage localization. You can add the language you need and translate interface elements accordingly. In the out-of-the-box SimpleOne solution two languages are available: Russian and English.

You can localize the following elements:

• interface elements
• messages set
• choice options
• static interface elements.

You can upload it into the system, set up links between the localized version and the original version.

Adding a language

To add a new language, please follow the steps below:

1. Navigate to System Localization → Languages.
2. Click New and fill in the fields.
   • In the Language field, specify the language code of localization. You can write no more than two symbols. Then fill in the Name field. 
3. Click Save or Save and Exit.

Now you can refer to this Language (sys_language) table to build your localization. The language will also appear in Preferences Menu.

Localizing interface elements

You can localize fields of the Translated Text type in two ways:

• by creating a record in System Translations table
• by switching the system language.

To add new translations, please complete the steps below:

1. Open the record for which you want to add a translation.
2. Navigate to the Related Lists area.
3. In the Translations tab, click New and fill in the fields.
4. Click Save or Save and Exit to apply changes. 

Translated text form fields

To localize elements by switching the system language, please perform the following steps:

1. Open the record you need to translate.
2. In the Settings menu, change the language of the system to the localized one. 
3. Enter a new translation.
   • If the system language is English, you should type the new value in English. 
4. Click Save or Save and Exit to apply changes.

To check if the translation is saved correctly, scroll down to the Related Lists area, and open the Translations tab.

Choice list translation 

The localization of choice list option differ from the localization of any field of the Translated Text. To localize a choice list, please complete the steps below:

1. Navigate to System Settings → Choice Options.
2. Click New and fill in the fields.
3. Click Save or Save and Exit to apply changes.

Translated choice option form fields

Repeat these steps for other choice options.

Localizing static interface elements 

To localize static interface elements, such as welcome messages, informational or warning messages, some other kinds of messages, and also Condition operators, you will need two tables:

• the Source Messages (source_message) table – contains original messages in English.
• the Messages (message) table – contains localized messages in the user's languages (Russian, Hindi, etc).

source_message 

message 

These two tables are bound by ID. It means that every message in the Source Messages table has a unique ID, and its translated version in the Messages table has the same ID.

For example, the "Login" record in the Source Messages table has ID 15596431050000002, as well as the "Логин" record has in the Messages table.

To add new translations of the message via Source Messages, please complete the steps below:

1. Navigate to System Localization → Source Messages.
2. Open the necessary record. 
3. Open the Messages tab in the Related Lists area.
4. Click New and fill in the fields. 
5. Click Save or Save and Exit.

You can also see the translated variants of any message in the Messages table. 

To localize a message, please take the following steps:

1. Navigate to System Localization → Messages.
2. Click New and fill in the fields. In the field Source Messages you should specify the exact message you want to localize.
3. Click Save or Save and Exit.

Localization API

In SimpleOne, we have the SimpleMessage API class with the getMessage() message in it, which is taking in an original message from the Source Message (source_message) table and returns a message in the user's language that is set as default in the system. To learn more, please refer to the SimpleMessage article.

Also, you can use the s_i18n client-side class that intended to work with translated messages. It has two methods: getMessage() and getMessages(), that allow to get one or many messages in user language, respectively. For more information, please refer to our API reference containing information about this class.

Editing translations

Editing the translation of interface elements

There are two ways to edit translated elements of the table. To edit any record via the Related Lists area, please follow these steps:

1. Navigate to the record you want to edit.
2. In the Related Lists area, open the Translations tab.
3. Find the translation that needs editing, change the Value field.
4. Make necessary changes, click Save or Save and Exit.

Editing the translation of choice options

The steps for editing the translation of choice options is similar to creating translations.

To edit the translation of choice options, please take the following steps:

1. Navigate to System Settings → Choice Options.
2. Open the record.
3. Edit the Title field.
4. Make necessary changes, click Save or Save and Exit.

Editing the translation of static interface elements

Since the two tables Source Messages (source_message) and Messages (message) are bound by the same ID, you can edit flash messages, Condition Operators in both of them. 

To make changes via the Messages (message)  table, please complete these steps:

1. Navigate to System Localization → Messages.
2. Open the necessary message or operator.
3. Edit Translation.
4. Make changes, click Save or Save and Exit.