mirror of
https://github.com/formbricks/formbricks.git
synced 2026-01-06 05:40:02 -06:00
docs: update multi-language surveys (#6354)
This commit is contained in:
Harsh Bhat
@@ -1205,7 +1205,7 @@
|
||||
"delete_survey_and_responses_warning": "Êtes-vous sûr de vouloir supprimer cette enquête et toutes ses réponses?",
|
||||
"edit": {
|
||||
"1_choose_the_default_language_for_this_survey": "1. Choisissez la langue par défaut pour ce sondage :",
|
||||
"2_activate_translation_for_specific_languages": "2. Activer la traduction pour des langues spécifiques :",
|
||||
"2_activate_translation_for_specific_languages": "2. Activer la traduction pour des langues spécifiques:",
|
||||
"add": "Ajouter +",
|
||||
"add_a_delay_or_auto_close_the_survey": "Ajouter un délai ou fermer automatiquement l'enquête",
|
||||
"add_a_four_digit_pin": "Ajoutez un code PIN à quatre chiffres.",
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 28 KiB After Width: | Height: | Size: 34 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 33 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 25 KiB |
@@ -28,87 +28,111 @@ How to deliver a specific language depends on the survey type (app or link surve
|
||||
|
||||
## Creating a Multi-language Survey
|
||||
|
||||
- Open the **Survey Languages** page in the Formbricks settings via the top-right menu:
|
||||
<Steps>
|
||||
<Step title="Configure Survey Languages">
|
||||
Go to Configuration and open the **Survey Languages tab**:
|
||||
|
||||
|
||||
|
||||
|
||||
- Click on the **Edit languages** button, to add a new language to your survey
|
||||
Click on the **Edit languages** button to add a new language to your survey.
|
||||
|
||||
|
||||
Select the preferred language from the dropdown and assign an identifier Alias. Click the **Add language** button to add the language to your project:
|
||||
|
||||
- Select the preferred language from the dropdown and assign an identifier Alias. Click the **Add language** button to add the language to your project.
|
||||
|
||||
|
||||
|
||||
You can come back to this page anytime to add more languages or remove existing ones.
|
||||
</Step>
|
||||
|
||||
You can come back to this page anytime to add more languages or remove existing ones.
|
||||
<Step title="Create or Edit Your Survey">
|
||||
Return to the dashboard to create a new survey or edit an existing one:
|
||||
|
||||
- Now, return to the dashboard to create a new survey or edit an existing one.
|
||||
|
||||
</Step>
|
||||
|
||||
|
||||
<Step title="Enable Multi-language Support">
|
||||
In the survey editor, scroll down to the **Multiple Languages** section at the bottom and enable the toggle next to it:
|
||||
|
||||
- In the survey editor, scroll down to the **Multiple Languages** section at the bottom and enable the toggle next to it.
|
||||
|
||||
|
||||
|
||||
Choose a **Default Language** for your survey.
|
||||
|
||||
- Choose a **Default Language** for your survey.
|
||||
<Note>Changing the default language will reset all the translations you have made for the survey.</Note>
|
||||
</Step>
|
||||
|
||||
<Note>Changing the default language will reset all the translations you have made for the survey.</Note>
|
||||
<Step title="Add Supported Languages">
|
||||
Add the languages from the dropdown that you want to support in your survey:
|
||||
|
||||
1. Now, add the languages from the dropdown that you want to support in your survey.
|
||||
|
||||
</Step>
|
||||
|
||||
|
||||
<Step title="Preview and Translate Content">
|
||||
|
||||
1. You can now see the survey in the selected language by clicking on the language dropdown in any of the questions.
|
||||
You can now see the survey in the selected language by clicking on the language dropdown in any of the questions.
|
||||
|
||||
Now you can translate all survey content, including questions, options, and button placeholders, into the selected language.
|
||||
|
||||
|
||||
</Step>
|
||||
|
||||
1. You can now translate all survey content, including questions, options, and button placeholders, into the selected language.
|
||||
|
||||
|
||||
|
||||
1. Once you are done, click on the **Publish** button to save the survey.
|
||||
<Step title="Publish Your Survey">
|
||||
Once you are done, click on the **Publish** button to save the survey.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## App Surveys Configuration
|
||||
|
||||
1. After you setup the Formbricks SDK for your user, you can call the `setLanguage` function with the language code. This can be either the ISO identifier or the Alias you set when creating the language. The `language` attribute makes sure that this user only sees surveys with a translation in this specific language available.
|
||||
<Steps>
|
||||
<Step title="Set Up Language for Users">
|
||||
After you setup the Formbricks SDK for your user, you can call the `setLanguage` function with the language code. This can be either the ISO identifier or the Alias you set when creating the language. The `language` attribute makes sure that this user only sees surveys with a translation in this specific language available.
|
||||
|
||||
```js
|
||||
Formbricks.setup({
|
||||
environmentId: "<environment-id>",
|
||||
appUrl: "<app-url>", // use PUBLIC_URL if you are using multi-domain setup, otherwise use WEBAPP_URL
|
||||
});
|
||||
```js
|
||||
Formbricks.setup({
|
||||
environmentId: "<environment-id>",
|
||||
appUrl: "<app-url>", // use PUBLIC_URL if you are using multi-domain setup, otherwise use WEBAPP_URL
|
||||
});
|
||||
|
||||
Formbricks.setLanguage("de"); // ISO identifier or Alias set when creating language
|
||||
```
|
||||
Formbricks.setLanguage("de"); // ISO identifier or Alias set when creating language
|
||||
```
|
||||
|
||||
<Note>
|
||||
If a user has a language assigned, a survey has multi-language activate and it is missing a translation in
|
||||
the language of the user, the survey will not be displayed.
|
||||
</Note>
|
||||
<Note>
|
||||
If a user has a language assigned, a survey has multi-language activated and it is missing a translation in
|
||||
the language of the user, the survey will not be displayed.
|
||||
</Note>
|
||||
</Step>
|
||||
|
||||
1. That's it! Now, users with the language attribute set will see the survey in their preferred language. You can start collecting responses in multiple languages and filter them by language on the summary page.
|
||||
<Step title="Start Collecting Responses">
|
||||
That's it! Now, users with the language attribute set will see the survey in their preferred language. You can start collecting responses in multiple languages and filter them by language on the summary page.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
---
|
||||
|
||||
## Link Surveys Configuration
|
||||
|
||||
For link surveys, the translation delivery is dependent on the `land` URL parameter.
|
||||
For link surveys, the translation delivery is dependent on the `lang` URL parameter.
|
||||
|
||||
After publishing the survey, just copy the survey link and append the `lang` query parameter with the language alias you have set.
|
||||
<Steps>
|
||||
<Step title="Publish Your Survey">
|
||||
After publishing the survey, just copy the survey link and append the `lang` query parameter with the language alias you have set.
|
||||
</Step>
|
||||
|
||||
For example, if you have set the alias for French as `fr`, you can share the survey link as
|
||||
<Step title="Create Language-Specific URLs">
|
||||
For example, if you have set the alias for French as `fr`, you can share the survey link as
|
||||
|
||||
[`https://your-survey-url.com?lang=fr`](https://your-survey-url.com?lang=fr)
|
||||
[`https://your-survey-url.com?lang=fr`](https://your-survey-url.com?lang=fr)
|
||||
|
||||
Here are two examples:
|
||||
Here are two examples:
|
||||
|
||||
- English: [https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=en](https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=en)
|
||||
- English: [https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=en](https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=en)
|
||||
|
||||
- German: [https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=de](https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=de)
|
||||
- German: [https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=de](https://app.Formbricks.com/s/clptfos2i1pj516pvhxqyu3bn?lang=de)
|
||||
|
||||
Without the `lang` parameter, Formbricks will show the survey in the default language you have set.
|
||||
Without the `lang` parameter, Formbricks will show the survey in the default language you have set.
|
||||
</Step>
|
||||
|
||||
You can now start collecting responses in multiple languages!
|
||||
<Step title="Start Collecting Responses">
|
||||
You can now start collecting responses in multiple languages!
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
---
|
||||
|
||||
@@ -125,13 +149,21 @@ Formbricks fully supports Right-to-Left (RTL) languages such as Arabic, Hebrew,
|
||||
|
||||
### Setting Up RTL Languages
|
||||
|
||||
No additional configuration is needed to enable RTL support. Simply:
|
||||
<Steps>
|
||||
<Step title="Add RTL Language">
|
||||
Add an RTL language (like Arabic or Hebrew) in the **Survey Languages** settings
|
||||
</Step>
|
||||
|
||||
1. Add an RTL language (like Arabic or Hebrew) in the **Survey Languages** settings
|
||||
2. Create translations for your survey content in the RTL language
|
||||
3. The survey will automatically display in RTL format when that language is selected
|
||||
<Step title="Create Translations">
|
||||
Create translations for your survey content in the RTL language
|
||||
</Step>
|
||||
|
||||
|
||||
<Step title="Automatic RTL Display">
|
||||
The survey will automatically display in RTL format when that language is selected
|
||||
|
||||
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user