Multilingual survey
From LimeSurvey Manual
Under construction
Introduction
LimeSurvey provides the feature of running one survey in several translations at the same time without the need to copy it.
This wiki section quickly covers how a multilingual survey can be created. The guide covers topics such as:
The example analysed throughout the wiki section can be downloaded from here: LS3 multilingual survey sample. To import it, 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 [settings] of your instance.
To check which language is the base one, access the general survey settings panel and see 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 to, see the additional languages field. In our example, four 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 four 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 [Text_elements#Description|description]]
- Welcome and end texts
- Question groups
- Questions
- Subquestions
- Answer options
- Invitation email subject
- Reminder email subject
- Confirmation email subject
- Registration email subject
Please note that at the moment of writing this section (LimeSurvey 3.16.0), the following sections are translatable but not displayed in this panel:
To translate them, please access each option and follow the steps described in the previous wiki subsection.
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
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:
LimeSurvey does not allow you to edit the standard themes! If you wish to add changes to a standard team, click on the Extend button located on the top bar to create a copy of the standard theme.
Look on the left side of the screen for the language_changer.twig file.
Go to the line that contains the following function:
{% if aSurveyInfo.alanguageChanger.show == true %}
Comment it out (replace "%" with "#") and copy the following line below it:
{% if false == true %}
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:
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:
{% if aSurveyInfo.alanguageChanger.show == true %}
Add the following line below it:
{% if false == true %}
No language switcher will be displayed on the right side of the screen:
