Changes to UI language files
You must have an "__EOF" label at the end of every language file, otherwise the UI will not load correctly and the login form will not display. (Abiquo 4.6+)
Changes to UI Client Configuration
You should add your custom configuration to the client-config-custom.json file. This new file should contain all custom UI configuration, such as language names and keyboards. DO NOT make changes to client-config-default.json because your changes will be lost when you upgrade Abiquo. (Abiquo 3.4+)
To create custom UI labels and API error messages:
Go to the language file location which is as follows
and find the default language file.
Do not change lang_en_US_labels.json because the platform will overwrite your changes when you upgrade
To customize the US English labels, create a new custom file in the same folder called:
Copy any default labels you want to change to this file and enter the new text values. See UI Labels, which also provides a change history for upgrades. For example, change "enterprise" to "tenant" in the part of the label after the colon ":".
Copy any error messages you want to change from the list of default messages on the wiki. See UI Error Messages. Make appropriate changes, for example, for some sample messages VM-9999 and VM-10000. Tip: the error messages in table format are at User Interface Messages.
Your file must always end with the "__EOF" label, for example:
If you do not add the __EOF label, the UI will not load correctly and the login form will not display
Check your JSON format using a JSON validator, for example, http://jsonformatter.curiousconcept.com/#jsonformatter and remember:
The default language of US English is automatically compiled into the Abiquo UI Client, so if there are any problems with the language files, then the client will automatically revert to the default US English.
To create a new UI language file in another language:
Copy the en_US file and rename it to the language code of your language. For example, to create a label file for translation to French from France, enter the following commands while logged into the Abiquo Server as root:
For language codes, see ISO language codes web page.
For instructions of how to translate the file, see Abiquo UI Localization
After you have created the language files, do these steps to add the languages:
Add the files to the server in the languages folder:
Go to the configuration folder
Add your languages in the order that you want them to appear in the menu. For example, the default configuration is:
For example, to add the Spanish and French languages to the file, add a comma after the English entry, and add a new entry for Spanish and French
Note that the platform will store the last language used in browser LocalStorage.
Check your JSON format because the platform will not load the UI with an invalid configuration
Check for an extra comma at the end of the list or a missing comma in the list!
Save the file with UTF-8 encoding to preserve the special characters
For VMware ESXi, you can also add a keyboard configuration for each language, see Configure Abiquo UI
To test new languages
The platform will remember the last language used in the UI and select it on the login screen. The value is stored in the browser's localStorage with “language” as the key and the language code as the value, for example, “es_ES” for Spanish from Spain.
About and Support links display in the bottom right corner of the screen. These links open popups.
You can also customize these optional UI elements in the language files.
If your JSON format is not correct, the Abiquo UI may not function. To check your file, you can use a JSON checker, for example http://jsonformatter.curiousconcept.com/#jsonformatter