Views: 9498
Number of votes: 0
Average rating:

Adding new languages to EPiServer 5

We’ve recently run into problems with adding the less commonly-used language and locale combinations on an EPiServer installation. How do you add a new language to EPiServer 5 if it doesn’t appear in the list of available languages?

EPiServer takes the list of the languages that you can enable for a site from the languages that are installed on the host operating system. This can be a problem as the available languages can vary between different machines - for example, Indian English (en-IN) is shipped with Vista but not with Windows 2003 or XP. The big catch is that if you have a language enabled in your EPiServer database which is not installed on your target machine then EPiServer will throw an exception on start-up, which will pull your whole site down.

If you want to add a new language to EPiServer then you will have to install it on your operating system. This can be done via the CultureAndRegionInfoBuilder class in System.Globalization. This class allows you to create a new language from scratch or by copying it from an existing language, although you will have to run the code in the context of an Administrator account for it to work.

The code sample below shows how CultureAndRegionInfoBuilder can be used to create and register a new language based upon an existing language – in this case creating Hong Kong English (en-HK) from UK English (en-GB). Note that you’ll need a reference to sysglobl.dll in your project for this to compile.

public static void CreateCulture()
{
    //* Get the base culture and region information
    CultureInfo cultureInfo = new CultureInfo("en-GB");
    RegionInfo regionInfo = new RegionInfo(cultureInfo.Name);

    //* Create the a locale for en-HK
    CultureAndRegionInfoBuilder cultureAndRegionInfoBuilder = new CultureAndRegionInfoBuilder("en-HK", CultureAndRegionModifiers.None);

    //* Load the base culture and region information
    cultureAndRegionInfoBuilder.LoadDataFromCultureInfo(cultureInfo);
    cultureAndRegionInfoBuilder.LoadDataFromRegionInfo(regionInfo);

    //* Set the culture name
    cultureAndRegionInfoBuilder.CultureEnglishName = "English (Hong Kong)";
    cultureAndRegionInfoBuilder.CultureNativeName = "English (Hong Kong)";

    //* Register with your operating system
    cultureAndRegionInfoBuilder.Register();

}

Once you’ve run this code, fire up EPiServer in Admin mode, select Manage Web Site languages from the Config tab, click on Add Language and your new locale will be ready to use.

Oct 02, 2009

Renu Rathor
(By Renu Rathor, 9/21/2010 12:32:40 PM)

I am trying to apply these changes, but it doesnt tell me where di i need to add this method, any step by atep complete process to get it working?

David.Knipe
(By David.Knipe, 9/21/2010 12:32:41 PM)

Renu, you can simply create a command line application that will create and register the language for you. This only needs to be done once on each machine.

Renu Rathor
(By Renu Rathor, 9/21/2010 12:32:41 PM)

I want to edit the language culture appera in drop down of Regional and language culture, how can i do that?

paul.graham
(By paul.graham, 9/21/2010 12:32:41 PM)

Once a new culture has been create you'll it'll appear here C:\Windows\Globalization
as *.nlp file you can then copy the between servers.

Jon Haakon Ariansen
(By Jon Haakon Ariansen, 11/24/2010 10:29:08 AM)

I'm about to create a new language. I have explored the code and found the directory "Globalization" on my client machine, but I can't find "c:\windows\Globalization" on Windows 2003?
Could it be that the server needs windows update? Is "c:\windows\globalization" part of Framework 4?
If I need windows update, anybody who knows which "patch" I need to run to install this on Windows 2003?

Kind regards,
Jon Haakon

Jon Haakon Ariansen
(By Jon Haakon Ariansen, 11/24/2010 1:42:58 PM)

I'm about to create a new language. I have explored the code and found the directory "Globalization" on my client machine, but I can't find "c:\windows\Globalization" on Windows 2003?
Could it be that the server needs windows update? Is "c:\windows\globalization" part of Framework 4?
If I need windows update, anybody who knows which "patch" I need to run to install this on Windows 2003?

Kind regards,
Jon Haakon

paul.graham
(By paul.graham, 6/29/2012 2:40:29 PM)

once you've excuted the CreateCulture the c:\windows\Globalization will magically appear.

Please login to comment.