Editor / Localization

Localization

With RadEditor you can easily create a new language pack or alter some of the labels of an existing one.

Localization is contained in resourse files .resx which are within the product dll. There are three built-in localizations (English, French and German) which can be set through the Language property. For example to localize the editor in German set Language="de-DE".

To create your own localizations for the editor, you need to create the  App_Global Resources folder in the root of your web application and copy the English resx files (which will be provided for download from our site) into it. These files are:

• RadEditor.Dialogs.resx - contains all dialogs' localization strings
• RadEditor.Main.resx - contains the spell's, paste and other localization strings
• RadEditor.Modules.resx - contains the modules' localization strings
• RadEditor.Tools.resx - contains the editor's tools localization strings

After you have copied the resx files, you must duplicate each copy of these files and rename them using the syntax shown in the few examples below:

• RadEditor.Tools.<Your_Language>.resx
• RadEditor.Main.<Your_Language>.resx
• RadEditor.Dialogs.<Your_Language>.resx
• RadEditor.Tools.<You_Language>.resx

All resx file contain two columns: Name and Value.

It is mandatory to set the ReservedResource string in the Name column of the RadEditor.Tools.<Language>.resx file. Without this string the resource files will not be recognized.

Once you do that you can localize the strings in the Value column. You need to localize the strings in the Value column of your new resx files.

The next step is to set the Language property of RadEditor to the name of the <localization> string in the RadEditor.Tools.<language>.resx file:

Inline in the RadEditor's declaration:

<telerik:radeditor runat="server" ID="RadEditor1" Language="it-IT"></telerik:radeditor>

In the CodeBehind:

C#:
RadEditor1.Language = "it-IT";

VB.NET:
RadEditor1.Language = "it-IT"

If you provide a new localization for RadEditor which works properly, we will gladly reward you for your work.

Changing the location of the Localization files:

The LocalizationPath property indicates where the editor will look for its .resx localization files in the web application. By default the .resx localization files of RadEditor are placed in the App_GlobalResources folder. However, if it is not possible to put the resource files in the default location or .resx files compilation is disabled for some reason (e.g. in a DotNetNuke environment), then the LocalizationPath property should be set to point to the new location of the resource files.