Multilingual translations via Weglot
Integrating Weglot with Roster provides a seamless solution for translating various elements of your ambassador program. Weglot helps translate the application form and campaign content in Roster's ambassador portal, allowing ambassadors see content in multiple languages.
The integration is easy to set up, but it involves several steps, including configuring language settings, obtaining the Weglot API key, and adjusting settings within Roster. This guide will walk you through integrating Weglot with Roster, ensuring your ambassador program supports multiple languages effectively.
Step-by-step instructions
Create a Weglot account and project
- Go to weglot.com and create an account if you don't have one.
- After account creation, start a new project.
- Name your project (e.g., Roster Ambassador Translations).
- Under website technology, select Other.
- Click Next to proceed.
Configure language settings
- Set English as the original language.
- Choose additional languages under Translated Languages. Note the pricing tiers might limit the number of languages.
- Enter roster.link under domain URL.
- Click Next to configure.
Obtain and use the Weglot API key
- In the step labeled Add Weglot snippet, locate the api_key within the JavaScript provided.
- Copy the full API key value (without quotes) to your clipboard.
- The API key starts with wg_ followed by a long alphanumeric value. e.g. wg_5f357807f1ba2d0b66a900d5ff6d47bse
- If the Next button appears as disabled, then proceed to the next step. If the Next button is enabled, then click Next
Add the Weglot API key to your Roster program's settings
In order to proceed with the Project setup in Weglot, Weglot requires that the API key is used on a live web page. That's what we'll do in this step.
- In your Roster account, navigate to Programs > Settings of the specific program to which you want to add translations.
- In program settings, click on the Integrations tab.
- In the Translation via Weglot section, paste the Weglot API key into the Weglot API Key field.
- Two toggles will appear below the Weglot API Key field:
- Application Form: Applicants can view the program's application form in any of the languages you enable in the Weglot project.
- Campaigns: Ambassadors in the program can see translations for campaigns to which they are invited.
- Enable Application Form even if you don't plan to enable translations for the application form later on. This is just to get past the next step in the Weglot project setup.
View the program's hosted application form
- While still in Program Settings, click on the Recruitment tab
- In the Recruitment Form section, click Copy > Copy form link
- Open a new browser tab and paste in the recruitment form link.
- Ensure you see a language switcher at the bottom right of the form.
- Click the language switcher and select one of the other languages.
- The form should automatically translate.
Final configuration in Weglot
- In Weglot, the Project setup should now automatically updated to show as completed. If not, try refreshing the page.
- Click to view the new project.
- Click General under the Settings section in the left-hand navigation.
- Locate the Auto-switch toggle and enable it.
- Click Save changes
- Click App settings under the Settings section in the left-hand navigation.
- Click the Add Dynamic button.
- In the dialog, enter body as the selector, and Ambassador portal as the description.
- Click Save
Translate the Application Form
When enabled in Program Settings, the application form will be translated into the languages you selected in the Weglot project. This includes the form description, field labels, and the confirmation page message.
Translate Campaigns
When enabled in Program Settings, the following campaign details for ambassadors who are in a program with translations enabled will be translated:
- Campaign title
- Campaign overview
- Campaign style guide
View and edit the translations in Weglot
- In Weglot, click Languages
- This lists the languages you have enabled for your Weglot project, and a count for how many words have been translated for each language.
- Click on a language to view and edit all the translations made by Weglot.
Need help?
If you need any additional assistance with with your Roster account, feel free to contact our support team at [email protected]. We're here to help!