Localization editor

GpsGate currently supports more than 20 languages. It also offers the possibility to create a new language or to modify it to find more suitable words according to your needs.

How to set language

You can install additional languages on your server from the page SiteAdmin / Plugins.

You can set the default language for the server under SiteAdmin / Settings. Each user can set an individual language under VehicleTracker / Settings.

Note: All translations except English and Swedish are contributed by the GpsGate community. Where localized phrases are missing they are replaced by English.

How to translate to your own language

Four new privileges have been added:  _UseLanguage_EditLanguage_CreateLanguage, and _DeleteLanguage.

Privileges

  • _UseLanguage controls which languages the user can select in Settings. If no languages are enabled, English will be used.
  • _EditLanguage controls which languages can be modified. This privilege must be enabled in order for the Localizationmenu item to appear.
  • _CreateLanguage gives the right to create a new language.
  • _DeleteLanguage gives the right to delete a language or to revert custom translations of an existing language. Only languages enabled under _EditLanguage can be deleted or reverted.

Customizing an existing language

After installing the patch and enabling at least _EditLanguage for a user in an application, log in as that user. The menu item Localization should appear under the Admin menu. Selecting the menu item opens a window with a list of all the languages which you are allowed to edit.

Localization

Select a language. A window with a list of phrases appears. You can now enter new phrases in the Custom Translation column. Changes are saved automatically; there is no Save button. Those changes will now be visible in the Vehicle Tracker application to anyone who uses this language.

Localization Editor

Creating a new language

If the _CreateLanguage privilege is enabled, the Add New Language button will appear in the language list. Click it to open the Add New Language window.

Enter a language name and select a language to base the new language on. The fields Author and Noteare optional. Click the Create button to create the new language. A Localization Editor window with a list of phrases will appear, as when customizing an existing language.

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. It is possible to share the language with other roles and with other applications.

Adding new Keys

Adding new keys is needed in order to localize reports and variables. This can be done by clicking on the New Key button.

Add Key

Enter the key and its translation in the corresponding fields. Under the Module drop down menu choose the module for which the key will be used for. If you want to localize a report, choose the report definition under the Report Definition category and press create. Similarly, if you want to localize a variable, choose GenericComponents under Variables and click on Create.

Testing the language

The phrases in the user interfaces are not updated automatically as you enter them; the page has to be reloaded in order to see the changes. If the language you edited is not the currently selected language, click Settings in the menu bar, select the language in the Localization tab and click Save. When the language being edited is the same as the currently selected language, the page can be reloaded by clicking Done & Reload in the Localization Editor window, or if it isn’t open, by refreshing the page in your web browser.

Editing workflow

When opening the Localization Editor window for a language you are presented with list of phrases. This list is quite long and might feel overwhelming, however there are a number of ways of dealing with the large amount of phrases.

The leftmost column has a green check mark for phrases which have been translated or a yellow circle for phrases which are still to be translated. A phrase is considered to be translated if there is a translation from the English phrase either in the Phrase column or in the Custom Translation column.

The list can be sorted by any column. If you don’t want to see phrases which have already been translated, you can switch from SHOWING ALL to NOT TRANSLATED.

If you are looking for a specific phrase, you can search for it by typing text in the search box. Both the Phrase and Custom Translation columns are searched. If the KeyModule or Location columns are enabled, then those are searched as well.

If a phrase is too long to fit in the Custom Translation column, you can click the expand button (...) to open a window with key/phrase details. This window can also be opened by pressing Alt-Enter.

You can move between rows with UpDownPage UpPage DownCtrl-HomeCtrl-EndTabShift-Tab or Enter.

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.

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 a user-created language, then there is a Revert button in place of the Deletebutton. 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 you to save the language file as a copy with a different name, since the default files are overwritten when you upgrade the server.

How to contribute

You are most welcome to contribute with new translations. Great language translations are rewarded with free licenses.

Please contact support for more information.