Configuring multilingual and RTL UI

  Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic! Mail us feedback on this topic!  

Kentico CMS allows you to manage content in any language, including double-byte (eastern) languages, such as Chinese, and right-to-left languages (such as Hebrew or Arabic). All content is stored and published in UNICODE.

 

Translating the administration interface

 

If you want the administration interface to be displayed in a different language or at least with different culture settings (e.g. calendar and numeric format), go to Site Manager -> Development -> UI cultures and create a new UI culture:

 

UI culture name: Hebrew (example - you can use any other culture)
UI culture code: he-IL (example - you can use any other culture code)

 

Click OK.

 

Now create a copy of file <web project>\CMSResources\cms.resx under name cms.he-IL.resx (generally cms.<culture code>.resx) in the same folder and translate the strings.

 

Please note: when you make changes to the .resx file, you need to restart the web application using the Site Manager -> Administration -> System -> Restart application button so that the changes are updated in the user interface.

 

Modifying standard strings

 

If you want to modify some text in the user interface (including web parts), you can create a custom.resx file and put your strings to this file. The name of the string must be the same as in the cms.resx file. This procedure allows you to modify the strings without worrying that your changes will be overwritten during an upgrade to a newer version.

 

If you need to customize strings in non-english resource file, your custom file must use a name like custom.fr-fr.resx for French.

 

How to add your own strings

 

If you need to translate your own web site strings, such as form labels or other static text into several languages, you can create custom string in Site Manager -> Development -> UI cultures either in English or only in some specific language. Please be sure to check the Custom string box in this case so that the string is automatically exported with your web site.

 

Then, you can retrieve the string using the CMS.GlobalHelper.ResHelper.GetString method in your custom code.

 

Please see chapter Localization Expressions to see how you can insert localized strings into text values throughout the CMS.

 

 

 

Priority of the resource strings

 

When looking for a localized strings, the system uses the following priority:

 

1.database (Site Manager -> Development -> UI Cultures)
2.custom.resx
3.cms.resx

 

It means if there are duplicate strings with same name in all three files, the system will use the one stored in the database.

 

To change the priorities, you can add the following key to your web.config:

<add key="CMSUseSQLResourceManagerAsPrimary" value="false" />

When the key is added, the priorities are the following:

 

1.custom.resx
2.cms.resx
3.database (Site Manager -> Development -> UI Cultures)

 

 

Applying selected culture to the user interface

 

Now if you want to view the user interface in a different culture, you need to go to Site Manager -> Administration -> Users -> edit your user profile and set the Preferred user interface culture to the required value:

 

devguide_clip0166

 

When you sign out and sign in again, the user interface is displayed with the new culture settings and translated strings (after you translate them):

 

devguide_clip0739

 

Page url: http://devnet.kentico.com/docs/devguide/index.html?configuring_multilingual_ui.htm