Telligent Community supports translating the majority of the text rendered by the platform. User-generated content, however, is not supported for translation.
What Language Packs are Available?
- Spanish [es-ES]
- German [de-DE]
- Italian [it-IT]
- Japanese [ja-JP]
- Chinese (Simplified) [zh-CN]
- French [fr-FR]
- Brazilian Portuguese [pt-BR]
- Dutch [nl-NL]
Enabling a New Language
A new language can be enabled by copying an existing language. Telligent Community is provided with text for US English, so the following steps use that as the base language:
- Navigate to the
Languages/
folder. - Copy the
en-US
folder to a new folder, named with the language key and locale string (for example,fr-FR
for French). - Edit the
language.xml
file and add a<language />
node after US English for the new language using the same key used in step 2 and note the appropriate state for directionality via theisRightToLeft
attribute, for example:Fullscreen1name="Français" key="fr-FR" isRightToLeft="false" - Apply these changes (the new folder and edits to the
languages.xml
file) to all web nodes and the job service.
This will enable the new language to be used within the community. The files within the new language's folder should be translated as they will be in the source language (in this case, US English).
Editing Translations
Translations exist in a few locations:
- Functionality that exposes translatable items exists within Administration > Translation > TRANSLATABLES. For each item in this list, the Translation and Templates tabs will identify the text strings that can be adjusted. Change the target language using the drop-down to the language to be translated. When complete with each item, click Save to commit the translation changes.
- Widgets expose their text translations within Administration > Interface > Widgets. For each widget in the widget list, the Resources associated with the widget can be translated. Change the target language using the drop-down to the language to be translated. When complete with all widgets, commit the changes from the Staged Changes > ... > Publish All.
- Themes expose their text translations within Administration > Interface > Themes. For each theme, the Resources associated with the theme can be translated. Change the target language using the drop-down to the language to be translated. When complete with the theme, commit the changes from Staged Changes > ... > Publish All.
- Site terms can be translated within Administration > Translation > Terms. Change the language filter to the language to be translated and edit each term for the language.
- Platform-defined text is located within the
Languages/
folder within a sub-folder with the key of the language. Changes made to these files should be applied to all web nodes and the job service.
Exporting Translations
Translatable text can be exported from the following locations:
- Functionality/plugin translations can be exported from Administration > Translation > Plugin Translations by clicking Export Resources. This will export all translations for functionality/plugins. The resulting XML file can be edited to apply to a different language or target only a single language via manual editing.
- Theme translations can be exported from Administration > Interface > Themes by clicking the Export Resources link. The resulting XML file can be translated via manual editing.
- Widget translations can be exported from Administration > Interface > Widgets by clicking the check icon above the widget list, then Select All Visible, then Export Resources. The resulting XML file can be translated via manual editing.
- Automation translations can be exported from Administration > Automations > Automation Studio by clicking on ... and then choosing Export All Resources. The resulting XML file can be translated via manual editing.
Note that terms and platform-defined text cannot be exported. They need to be manually edited or copied.
Importing Translations
Exportable translations can be imported back into Telligent Community:
- Functionality/plugin translations can be imported in Administration > Translation > Plugin Translations by clicking Import Resources.
- Theme translations can be imported in Administration > Interface > Theme Studio by clicking on the Import button and selecting the appropriate resource file and publishing via the Stated Changes list.
- Widget translations can be imported in Administration > Interface > Widgets by clicking the upload/import icon above the widget list. Imported translations will be staged for review and publishing via the Stated Changes list.
Note that terms and platform-defined text cannot be imported. They need to be manually entered or copied.
Installing a Language Pack
Telligent provides language packs for several languages. Once you have obtained a language pack, it can be installed using the following steps:
- Create a new folder with the name of the language code of the language pack you are installing (for example, for US English "en-US") inside the
Languages/
directory of your Community installation (each web node and job service). - Copy the contents of the language pack into the folder you created.
- Open
La
nguages/languages.xml
and add a<language />
node for the language you just created. Thename
is a friendly name of the language. Thekey
is the language key of the language you created, and the name of the folder the language pack is stored in. UseisRightToLeft
to identify the directionality of the language. Apply this change to every Community installation (each web node and job service). - Run the
siteterms_{language}.sql
script on your database. - Recycle the community's application pool).
- Log into your site as administrator.
- Navigate to the Theme Studio (Administration > Interface > Theme Studio) and click the Import icon and upload the Theme-Resources.xml in your language pack folder.
- Navigate to Widget Studio (Administration > Interface > Widgets) and click the Import icon and upload the
Widget-Resources.xml
file in your language pack folder. - Review and select the widget resources you want to import and click the Import button.
- After being imported, the affected widgets will show up in the Staged Changes area of Widget Studio for review. Review and publish any changes you want live for your users.
- Navigate to Administration > Translation > Plugin translations.
- Click Import Resources and upload the
Plugin-resources.xml
file from your language pack folder. - Click Import Resources.
- After the import is complete, click Save. Now, you are ready to go and select different languages for your users, or let them select the language.
Setting the Default Language
The default language for anonymous users and new users can be selected by going to Administration > Site > Identification Options and reviewing the value for Default Language. When changed, be sure to click Save to commit the change.
By default, the language of anonymous users is detected by the Anonymous User Language Detector functionality based on the language list provided by the visitor's web browser. If the browser's language cannot be matched to an installed language, the default language is used.