To make the process of handling languages more robust and consistent, EPiServer CMS introduces some minor changes. The following article is a description of how language settings are handled in this release.

Types of Language Settings

  1. User Interface Language
    Controls the localized resources to show. I.e. determines the language of edit and admin, and any other place where calls are made to LanguageManager and/or resource manager. Note that it is possible to pass an explicit language to LanguageManager / resource manager - in this case it is the explicit language that is used.
  2. System Language
    Used to control date/time formating, sort order etc.
  3. Content Language
    The preferred language when displaying content. Note that the actual content language is eventually determined by a LanguageSelector and is dependant on the languages available for the pages that are displayed.

Vocabulary

Content Language

Accessing

The current value can be determined by reading ContentLanguage.CurrentCulture. You can change the value by assigning this property.

Note that content language may be a neutral culture. If sorting / formatting is required you should read from ContentLanguage.SpecificCulture. The specific culture is evaluated on-demand and follows the .NET Framework rules for determining a specific culture from a neutral culture, see CultureInfo.CreateSpecificCulture.

Selecting

  1. Compile a list of preferred languages in priority order:
    1. If the query string parameter "epslanguage" exists, add the language code to the list.
    2. If admin or edit page and the "editlanguagebranch" cookie exists, add the language code to the list.
    3. If the web.config parameter domainLanguageMapping is set and we have a match from the host name, add the language code to the list.
    4. If the cookie "epslanguage" exists, add the language code to the list.
    5. If the browserLanguageDetection setting is enabled, get the entire list of Request.UserLanguages into the list.
  2. Get a list of all available content languages, enabled or not, (LanguageBranch.List()) and pick the first language from the preferred list that has an exact match in the content language list.
  3. If no match found in the previous step, use the first candidate match(*).
  4. If no candidate match found, use the first language returned by the list of available and enabled content languages.

Modifying

The selection algorithm outlined above is implemented in ContentLanguage.DefaultContentLanguage and can be overridden by inheriting from ContentLanguage and assigning an instance of the new class to the static property Instance on ContentLanguage.

User Interface Language

Accessing

The current value can be determined by reading CultureInfo.CurrentUICulture and set by setting Thread.CurrentThread.CurrentUICulture. The information is a CultureInfo object and the language code ("en", "sv" etc.) can be retrieved from CultureInfo.Name

Note that CurrentUICulture can be a neutral culture (i.e. CultureInfo.GetCulture("en") would return a valid culture for CurrentUICulture) since CurrentUICulture is never used for sorting or formatting.

Selecting

  1. The first step is to compile a list of perferred languages in priority order:
    1. If viewing a template, add the current content language code.
    2. If there is a language setting in the personal profile, add it to the list.
    3. Use system default as set in web.config, <globalization uiCulture="xx">, which may be auto in which case it reads the browser language preferences.
  2. The next step is to get a list of all available User Interface languages (LanguageManager.GetLanguages()) and pick he first language from the preferred list that has an exact match in the UI Language list.
  3. If no such match exists, use the first candidate match (*).
  4. If no candidate match exists, use the first available user interface language.

Modifying

In case you want to customize the selection logic, you can modify CurrentUICulture in the InitializeCulture() method (virtual method on System.Web.UI.Page). Our default implementation is done in EPIServer.PageBase.

System Language

Accessing

This current value can be determined by reading CultureInfo.CurrentCulture and set by setting Thread.CurrentThread.CurrentCulture. The information is a CultureInfo object and the language code ("en-GB", "sv-SE" etc.) can be retrieved from CultureInfo.Name.

Note that CurrentCulture can not be a neutral culture since its primary purpose is to provide sorting and formatting information. I.e. the langauge code must be something like "en-GB" or "sv-SE". Trying to use a neutral culture will result in an exception when assigning the culture to CurrentCulture.

Selecting

The first step is to compile a list of preferred languages in priority order:

  1. If viewing a template, use the current content language code if language code is valid(**).
  2. If there is a language setting in the personal profile, use it if language code is valid(**).
  3. Use system default as set in web.config, <globalization uiCulture="xx">, which may be auto in which case it reads the browser language preferences. Since this culture has been set at the very start of the request, this step is really a "do nothing".

(**) Valid means that there is a CultureInfo with the specified language code and that the language is not a neutral culture.

Modifying

In case you want to customize the selection logic, you can modify CurrentCulture in the InitializeCulture() method (virtual method on System.Web.UI.Page). Our default implementation is done in EPIServer.PageBase

See Also

Writing Culture-Safe Managed Code