Localization for KMS/KAF Administrators - How to Change Your Kaltura Application Language?

To help ensure a quality user experience, Kaltura MediaSpace and KAF applications provide localization configuration to adapt online content for regional specificity. Using the Application and Languages modules in the Kaltura MediaSpace Admin Console and the Languages module in the KAF Admin Console, the KMS/KAF admin can control the MediaSpace/KAF instance localization features.

KMS

 To configure the KMS language

  1. Login to MediaSpace Admin Console
  2. Select the Application module in the Global section.
  3. Set the following:

    • languageConfiguration – Set the instance configuration: multi-language instance or single language instance.
    • languageSelection - Choose the default language for a new user in this specific instance.

  4. When the instance is configured to Multi-language, select the languages available from the languageSelection field.


The available languages in the languageSelection field are built from the out-of-the-box Kaltura languages in addition to custom languages that were created by the admin previously.

Customizing Languages for a KMS or KAF Instance

Use the Languages module in the KMS Management Console or the KAF Admin Console to create a custom language or change text in an available language. 

For KAF: Follow the KAF Specific Instructions in addition to the customizing instuctions that follow.

You will need to download the existing application text file and then upload the new/modified file.

To download language texts

  1. Select the Languages module in the Global section.
  2. In the DownloadLocaleText field,click Download Texts to download the latest texts of KMS. 


    A zip file with standard locale.po files for all languages is created. The zip file contains all text for all languages for this specific KMS/KAF instance.

  3. Select the desired language and modify the text as necessary. You can use translation editors available on the web,  for example, poedit, to modify text. The final result should be a binary .mo file.

To upload language texts

  1. Select the Languages module in the Global section.
  2. Click +Add UpdateCustom Language to upload the new/modified texts for KMS or your KAF instance (a binary .mo file).

  3. Configure the following fields to upload the custom Language and click Save.

    Field

    Description

    languageAdminName

    Enter the name of the language to be presented in the language drop down list (for the admin), in Application module, languageSelection and language fields.

    languageClientName 

    Enter the name of the language to be presented in the language drop down list for the users.

    languageCode

    For KAF only: Select the formal language code to be used to sync the instance language to the hosting application (LMS,CMS, SBS) chosen language.

    localeFile

    Click upload locale. Upload your customized .mo file.In order to convert your customized .po file to an.mp file you can use some available tools on the web.

    localeIcon

    Click upload flag. Upload a custom language flag icon to be presented to the users. The icon should be in *.jpg;*.jpeg;*.bmp;*.png;*.gif;*.tif;*.tiff;*.ico format and the dimensions should be 30px X 26px (The application will resize any given image, however for the best visual result, use these dimensions). You can also choose from this library of icons: http://freebiesbug.com/psd-freebies/100-flat-flag-psd-icons/

    languageId

    Unique language id for application usage (not for KMS/KAF admin usage).

KAF Specific Information

When the instance is from a KAF-based LMS Extension (specifically - Sakai, Blackboard, Canvas, Brightspace, Moodle to follow in the future) the following is relevant:

  • The Kaltura instance (the Kaltura screens) receive the language settings from the hosting application (Sakai, Blackboard, Canvas, Brightspace) – whether created or added by the application admin or the user.
  • Custom languages may be added as described in the Customizing Languages for a KMS or KAF Instance section in this article.

  • The languageCode field is a for KAF use only. The KAF admin should set it for a custom language. This field is used to sync the instance language to the hosting application chosen language. The languageCode of a custom language takes precedence over the Kaltura default language with the same code.
In This Article