WA3.2 Language translation

Note: The instructions described here applies to openIMIS version 1.3.0 and later. You will need Visual Studio to change update the language resource files and to publish the updated version. 

Web Application .Net is supporting up to two languages. The language translation is done on the Web Application source code level (this page) and on the database level (see WA4.1 Language selection and translation tables). 

The Web Application language localisation is using the default ASP.Net Globalization and Culture configuration. The translation is based on resource files. The generic application is translated into English-language and French-language.

In order to facilitate the translation of the Web Application and to have a common repository for language packs for openIMIS, we have subscribed to lokalise.com. If you wish to add new languages to openIMIS Web Application, you can request the access by visiting the Web Application project on lokalise. For more information on the translation platform please check Translation Management platform page.

Add a new language for Web Application in lokalise

1. Add new language to the project
   1. From the Web Application project press the + button to add a new language
      
   2. From the Add languages modal select the language to add. You can filter the languages by writing in the input field. In this example, we will choose French (Cameroon). Multiple languages can be added at once.
      
   3. Click the Add button. 
2. Translate the glossary to the new language 
   1. From the Web Application project press the Glossary button to add a new language
      
   2. For each glossary term, translate in the new added language
      
3. Translate the Web Application into the new language
   1. For each term in the Web Application project, translate it in the new language
      
4. Export the language as resource file
   1. From the Web Application project press the Download button
      
   2. Select the language you want to download and the different download settings
      
   3. Press Build and download button. This will download a ZIP file with resource files for all selected languages. Unzip 

Add the new language in the Web Application project 

1. Open the Web Application .Net solution downloaded from Github
2. In the Solution Explorer window, navigate to IMIS project → App_GlobalResources folder and open the contextual menu with right-click 
3. Select Add → Existing Item...
4. Select the resource file for the new language and press Add. This will copy the file to the App_GlobalResources folder and add it to the project. 
5. (Optional) you can check the new language by opening the resource file. 

To use the new language, the Web Application .Net solution needs to be published and deployed. Don't forget to update language selection and translation tables in the database. 

The goal of this page is to give an example of the different organization name you can have in Chad to illustrate how it is important to adapt openIMIS to the country-specific names validated by the country because sometimes there is multiple truth

Also, it is often complex and can change over time: