Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

When you are working on user interface translations, it is important to note in which language you are viewing your application. To find your language settings, go to the "Language" settings page, which is in the far left-hand pane in the "Application" tab.  For general information about multiple languages in CommCare go here.

If you are deploying your application in multiple languages, then you will need to add user interface translations for each language.

...

2. Select the "CommCare translations" button found on the "Languages" page in the settings section.  You should find a box that looks like this:Image Removed

...

Before you start, you should make sure that someone else has not done all the work for you already!

 3. Press "auto fill translations"  after which CommCare will show you its best educated guess at the correct translation.  For example, if another organization made an application in the Thai language, then CommCare will auto fill the translations with any user interface translations that they used.  If you want, you can use those, or you can change them to whatever you want.  If ten organizations have made applications in the Thai language, then CommCare will look for the translations that are most common for each text string and will suggest those. The auto fill translations button exists underneath within the CommCare Translations section at the bottom of the phrase list. Image Removed

...

 If your language has never been used in a CommCare application (or no user interface translations were provided) then nothing will happen.  If there are prior translations, you should see something like this (it may take up to a minute for the translations to appear):Image Removed

...

On the left is the "key" that CommCare needs to know which message you are referring to, and on the right is the translated text that will be displayed to the user.  In the image above, CommCare is suggesting translations for some of the strings, based upon previous projects.

...

The link to library of supported keys for CommCare is hosted on Github. You will be opening a webpage with a long list of "keys" and English text which looks something like this:Image Removed

...

It might look scary, but each row is simply:

key (what CommCare uses to find the text to display) = English text

This is the same as the user interface translation boxes we saw above.  The left box is for the key (i.e. "restore.message.connection.failed") and the right box is for the text to display (i.e. "Connection to server failed").

...

First, I open the CommCare library and searched the page for "required" in order to find the relevant key. Here is what I found:Image Removed

...

I take the "key" to the left of the equals sign and put it in the left box of the user interface translation section (don't include the "="), and then the translation for "Required question. Please answer it to continue" into the right box:Image Removed

...

I then click on the "+" sign next to the translation to add it to my list of translated strings.  Don't forget to save regularly.  If you want to remove a translation, just click on the "x" sign next to the line you wish to remove.

...

You can download all existing translations to excel.  Click the "Bulk Application Translations" link to expand this option.Image Removed

...

Important Notes about User Interface Translations

  • The "=" sign you see in the library does not need to be used in the user interface translation settings.

Android-Specific User Interface Translations

Android Translations are set the exact same way as Java Phone translations, but the key specified is different. You can find the specific translations on hosted on GitHub.

Changing Submit/Continue buttons and End of Form Success Messages

This allows you to customize the names of submit, continue, and end of form messages. This can make your app more readle and make your app easier to navigate.

...

Steps to setup changing submit and end of form sucess messages

  1. In your app’s settings, Download the bulk translation spreadsheet (tutorial above).

  2. In the spreadsheet, Go to the page with the forms and/or case lists where changes are needed.

    1. The first page of the spreadsheet will show menus_and_forms to help navigate the spreadsheet.
      Find the button label that will be changed.

  3. Find the button label that will be changed.

  4. Change the default_en column to your new text that should display.

  5. Save the Excel document.

  6. In CommCare, Upload bulk translations translations.

...