Localization editor

In addition to the supported languages, GpsGate offers the possibility to create a new language or modify an existing language. This allows you to customize the UI to your specific customer needs.

Requirements

Enable the following, in the Privileges & Plugins of your application.

Screenshot

Customizing an existing language

1. Log in to your application and go to Admin > Localization

Screenshot

2. Select the language you want to edit. In this example, we'll use French.

Screenshot

3. When the window opens, we recommend adding the Key and Module elements to clearly view which key you are edit from which module.(click right on the Header and select Key and Module)

Screenshot

4. Now you can add/change translation keys.

Screenshot

5. Search: you can search for a specific item to translate. The search could be both in the original or destination language if there's already a key.

6. Click on Screenshot to edit an existing translation.

7. Enable the button  Screenshot to view which elements which are translated.

Otherwise the button disable Screenshot will display the words and phrases which has not been translated.

Screenshot

8. It's also possible that neither the key nor the translation exists for certain elements on the screen (desktop/mobile). In such a case you'll need to add the key yourself. Do so by clicking on 

Screenshot

9. When you click on + Key, the following window will open and you will fill in the necessary info

Screenshot 2024-04-22 at 14.07.26.png

  • Key: the original element to translate.
  • Translation: the element translated in the destination language.
  • Module: for desktop elements select VehicleTracker. Select GenericComponents if you want to translate device variables.
  • Report definitions report titles and column names can be translated by selecting the proper report name.

10. After adding the key, select Reload UI if you want to see the changes immediately on the screen.

Screenshot

Creating a new language

If the _CreateLanguage privilege is enabled, the Add New Language button will appear in the language list.

1. Click it to open the Add New Language window.

Screenshot

2. Enter a language name and select a language on which to base the new language. The fields Author and Note are optional. Click the Save button to create the new language.

Screenshot

A Localization Editor window with a list of phrases will appear, just as when you're customizing an existing language.

Screenshot

3. Click on Save or Save & Reload when you have finished adding all keys.

When created, a new language will only be enabled for the role of the user who created it and in the application where it was created.

Screenshot

It is possible to share the language with other roles and with other applications as well.

Exporting a language

A language can be exported to a .lang file by clicking the Export button in the Localization Editor. Only the contents of the Custom Translation column are exported.

 

Screenshot

Deleting or reverting a language

User-created languages can be deleted, provided the _DeleteLanguage privilege is enabled. Click the Delete button in the Localization Editor to delete the language. Please note that there is no undo for this action.

If the language is not user-created, then there is a Revert button in place of the Delete button. Clicking Revert will erase all the entries in the Custom Translation column, reverting the language to the default version. Please note that there is no undo for this action.

Note: If you modify an existing language, we recommend that you save the language file as a copy with a different name. The default files are overwritten when you upgrade the server.

How to contribute

You are most welcome to contribute to new translations. Please contact support for more information.