Multilingual survey

=Introduction=

LimeSurvey contains a built-in facility that enables quick and easy translation of surveys. This facility is designed to make it easy for a human translator to translate a survey from the base language into any specified target language.

This wiki section quickly covers how a multilingual survey can be created. The guide covers topics such as:


 * the addition of a second language


 * string translation


 * quick-translation tool


 * multilingual survey overview

The example analysed throughout the wiki section can be downloaded from here: [[Media:Ls3 sample survey multilingual fr de en it.zip|LS3 multilingual survey sample]]. Unzip it and import the .lss file into your LimeSurvey instance.

Adding additional languages
The default language of the survey is the one you selected in the base language field. By default, it is the language configured in the global settings of your instance.

To check which language is the base one, access the general survey settings panel and look for the base language field. In our example, the base language is "English". To start adding new languages in which you wish to translate the survey into, see the additional languages field. In our example, three other languages have been selected: French, German, and Italian.



Once done, do not forget to click on the "Save" button located in the upper right side of the screen.

Now, if you check the top toolbar, you can observe that a small arrow appeared next to "Preview survey". This means that the survey can be previewed in different languages:



If you access the overview panel, four extra survey links are displayed. They correspond to the recently added languages:



Translating strings
To start translating strings, access the editor panel of each of your question. You can observe in the below screenshot that three additional languages are displayed above the question code field:



Click on any of them and start translating the question field.

The same type of "language bar" is located in many other places such as in the text elements and data policy settings panels, answer and subquestion text fields, and so on. However, translating fields using this method can get tricky if your survey is long and you wish not to miss anything. That is why we heavily recommend our users to use the quick translation tool. To access it, click on any survey-related setting (such as "Overview") -> Tools -> Quick-translation



Quick-translation tool
The quick-translation tool has been specifically designed for those that work with multilingual surveys. Once accessed, the following panel will be loaded:



The first option, translate to, gives you the possibility to select the language you wish to translate into from your base language.

The next options refer to the translation of your survey content. They refer to:


 * Survey title and description
 * Welcome and end texts
 * Question groups
 * Questions
 * Subquestions
 * Answer options
 * Invitation email subject
 * Reminder email subject
 * Confirmation email subject
 * Registration email subject

Once you are done translating these fields, do not forget to click on the "Save" button located in the upper right part of the panel.

Multilingual survey overview
To check your work, use the preview button. The welcome page will look like this:



Two language switcher can be observed once the welcome page is loaded. LimeSurvey offers the possibility to your respondents to change the language of instructions even though you shared with them the corresponding link for a specific language. A language switcher will also be located on the top right-side of your survey.

In the case in which you wish to hide the two "language switcher" buttons, edit the theme of your survey. For more details, see the hints & tips wiki subsection.

=Hints & tips=


 * If you wish to grant users translation permissions to access the quick-translation tool, check the following wiki subsection.


 * The "Auto-translate" feature makes use of the Google translate web service for automatic translation of a survey. You must enter your Google Translate API Key under global settings to access this feature. Google currently charges $20 US per 1 million characters submitted for translation.

How to hide the language switcher from the welcome page
In the case in which you decide to launch a multilingual survey, you will observe on the welcome page a drop-down menu that permits your respondents to select the language in which they wish to fill in your survey:



However, in certain scenarios you wish to hide the respective option. There are many ways in which you can hide the language switcher. The "twig" way is displayed below.

Access Themes from the global Configuration menu:



Click on the Theme editor button to edit the desired theme:



Look on the left side of the screen for the language_changer.twig file.



Go to the line that contains the following function:

Comment it out (replace "%" with "#") and copy the following line below it:

The line should look like this in the end:



Click on "Copy to local theme and save changes".

Access your survey and select the edited theme from the general settings panel. Now, the welcome page should look like this:



How to hide the language switcher located on the top menu
To hide the top language switcher, we will follow pretty much the same steps as described above. We just have to access the right twig file to edit it. Access again the theme you wish to change, and then go to Screen which is located in the upper-right part of the window and select Navigation from the dropdown list. Now, look on the left side of the window for "language_changer_top_menu.twig". Click on it and comment out:

Add the following line below it:

No language switcher will be displayed on the right side of the screen: