Search:     Advanced search

Localize in a new language.

Article ID: 64
Last updated: 04 Aug, 2012
Revision: 6
Add comment
Views: 0
Comments: 0

We do support Multi language but English is defaulted. You can change the language for both frontend and backup entirely as you wish. The language is determined from the user's preferences (his operating system language resp. the browser language) and he might be allowed to switch between the supported languages. Throughout this application, the language file types are mainly divided into three parts. 

Please refer to the Working with languages manual if you want information about translating the user interface, multilingual content or to build multilingual sites with the  Internationalization (i18n) module.

01.  Global Language file. 

02.  Language file to interpret each corresponding module(s).

03.  Language file to interpret web form(s).

All Global Language File:

The global language file is responsible for translating frontend and backend both. It translates all core modules which installs by default. 

File Location: /<$ServerPath>/application/languages/ lang.xx_XX.ini 
NB : $ServerPath represents your home Dir when the application is installed.

How to Add ? 

Copy an existing language file and rename it such as  lang.fr_FR.ini or lang.de_DE.ini.ini or lang.kr_KR.ini etc adding lang. as prefix follow by .ini as extension. Translate the language file from English into your mother language and Put the your language file into the /<$ServerPath>/application/languages/ directoryLanguage codes follow the convention of a two letter lowercase language name, followed by an underscore, followed by two upper-case latters signifying the country code which follows i18n localization standard.  So for example the default english for the United States would be: en_US adding lang as prefix follow by .ini as extension.  Now edit the variable by your native language such as:

install_step2_date_format = "Date format:"  (Default)

install_step2_date_format = " [email protected]:"  (Your Native Language)

Language file to translate individual modules:

Each module will have an independent language file to translate its respective module’s data only. This language file is read by it’s corresponding module in order to interpret belonging modules.  

File Location : application/languages/xx_YY/<$ModuleName>/lang.xx_YY.ini  (xx_YY represents lang.fr_FR.ini or lang.de_DE.ini etc convention)

How to Add ?

Copy an existing language file and rename such as  lang.fr_FR.ini or lang.de_DE.ini.ini or lang.kr_KR.ini etc adding lang. as prefix follow by .ini as extension. Translate the language file from English into your mother language and Put the your language file into the /<$ServerPath>/application/modules/<$ModuleName>/languages/.  Language codes follow the convention of a two letter lowercase language name, followed by an underscore, followed by two upper-case latters signifying the country code which follows i18n localization standard.

See the image below : 

Important : 

Unlike other language files, the form base language file name must suffix by respective form’s name followed by .ini extenison. Language codes follow the convention of a two letter lowercase language name, followed by an underscore, followed by two upper-case latters signifying the country code followed by form name. So for example the default english for the United States would be: en_US.BookinForm.ini when this language will only be applied for BookinForm. 

Finally Set Default Language :

Please open application/modules/Settings/forms/source/en_US.GlobalSettingsForm.ini file and find below line :
settings.elements.default_language.options.multiOptions.fr_FR = "French" and add an new line to include your language as follows :

Example : settings.elements.default_language.options.multiOptions.nl_NL = "My new Dutch Language" and finally save it.


When you are done with above translation and save application/modules/Settings/forms/source/en_US.GlobalSettingsForm.ini, login to Administrator => Site => Global Configuration (http:// YOURDOMAIN/Settings/global/update) => Default Language: => selected your native language as Default.

Need more easy Translation? Avoid duplication of common language

In order to minimize your translation effort, avoid translating the repeatedly usable words. Open your default language file located “[DOMAIN]/application/languages/lang.xx_xx.ini” and find variable such as common_date , common_delete, common_add, common_save etc to update by native language. It mean when you update common_save value as “SAVED” means all module’s save  button update by “SAVED” . This way you can used language file “[DOMAIN]/application/languages/lang.xx_xx.ini” file to minimize the translation effort.

This article was:  
Also read
document Language architecture and it hierarchical overview
document How to change default Country and Currency ?
document How to add Flag of my country to render into our Language
document How to manage or customize State and Area.
document Locale language and Internationalization

Also listed in
folder Templates Customization
folder Modules Wise Documentation -> Multi-Language

Prev   Next
Few reasons why we choose the Zend framework.     Customize the basic configuration though Global Setting.