Looking for something specific? Skip ahead:
Prefer to watch a video? https://controlshiftlabs.zendesk.com/hc/en-us/articles/204189087--Video-Supporting-Additional-Languages.
If you're looking for information about using our translations manager, Transifex, please see: https://controlshiftlabs.zendesk.com/hc/en-us/articles/204207138-Help-for-New-Translators.
Are you interested in making your toolset available to speakers of other languages? The ControlShift toolset supports a number of translations, all of which have been provided by other ControlShift-using organizations. We currently have translations for: Dutch, German, Greek, Hebrew, Italian, Japanese, Korean, Polish, Portuguese, Romanian, Spanish, and Swedish. Not all of these languages have complete translations for the entire toolset, but the campaigns tools should be fully translated.
We also have beginning translations for: French, Hindi, and Indonesian. (Between 30 - 50% translated.)
This article will walk you through allowing site visitors to use your site in one of the fully translated languages. If you're interested in using one of the partially translated languages, or a language not listed above, click here.
If you want to use one of the completed translations or edit your supported languages, go to the admin homepage > Settings > Time Zone & Locale > Manage Locales.
This page has three lists of languages:
- Supported Locales: These languages are available to all site visitors.
- Beta Locales: These languages are only visible to org admins. When supporting a new language, you may want to the leave the language as a beta locale until all organization-specific content is translated into the new language.
- Available Locales: These are languages that are supported by ControlShift, but are not currently visible to anyone on your site.
Adding a New Language
To add a new language, go to the admin homepage > Settings > Time Zone & Locale > Manage Locales > Available Locales section, find the language you want to offer on the site, and click Add. (The ID codes used for these languages are at the bottom of this article.)
After clicking to Add a new language, it will be added to the Beta Locales section of this page. (Again, beta locales are not visible to regular site visitors until they're published and become a supported locale.) In this Beta Locales view, you'll see the percentage of content that has been translated into the new locale. Please note that the translated percentage listed here is the percentage of organization-specific content only, not the percentage of the platform as a whole. To start adding translations for the organization-specific content, click the Translate link.
This page will show you a breakdown of where the untranslated content is housed. Note that the Content categories here are the same as the categories included in CMS > Content.
From here, clicking a category name will bring you to a page detailing the pieces of content included in the category. If the content has a check mark in the locale's column, then it has been translated. To translate the content, click the content name.
From here, you'll see the current text in your organization's default language. At the bottom of this page is the list of languages that have been added to the site. Choose the appropriate locale and click Translate.
The translation page will again show the current text in the site's primary language. Enter a translation for the text and click Save Translation.
If you need to edit a translation at any time, go to CMS > Content. From here, click into the correct category and piece of content, and then click Edit Translation.
Once you've completed translating organization-specific text into the new language, return to the Manage Locales page (admin homepage > Settings > Time Zone & Locale > Manage Locales) and click to Publish the translation. This will move the translation from beta, which is only visible to site admins, and make it a supported locale, which is visible to all site visitors.
Once your site has more than one published language, a language drop down will be added to the footer.
Removing a supported locale
If you've added a locale to your site, but want to remove it, you can do so from the Manage Locales page (admin homepage > Settings > Time Zone & Locale > Manage Locales.
If the language you want to remove is currently included in the Supported Locales section, click the Edit link at the end of the locale's row. On the edit locale page, there's a checkbox labeled Visible. Unchecking this box will remove the language from the Supported Locales section and demote the language to a Beta Locale.
If the language is listed as a Beta Locale, click the x button (in the Remove column) of the language's row. This will move the language to an Available Locale.
Adding Additional Translations
If you're interested in adding a translation other than Dutch, German, Greek, Hebrew, Italian, Japanese, Korean, Polish, Portuguese, Romanian, Spanish, and Swedish, send us a support email (firstname.lastname@example.org). We use a translation app for our site, so if you have a staff person or volunteer who is fluent in your desired language they can easily contribute to the translation.
ControlShift Supported Languages
|German (formal / Sie)||de|
|German (informal / Du)||de-AT|