Localizing CKEditor for SharePoint

This website contains links to software which is either no longer maintained or will be supported only until the end of 2019 (CKFinder 2). For the latest documentation about current CKSource projects, including software like CKEditor 4/CKEditor 5, CKFinder 3, Cloud Services, Letters, Accessibility Checker, please visit the new documentation website.

If you look for an information about very old versions of CKEditor, FCKeditor and CKFinder check also the CKEditor forum, which was closed in 2015. If not, please head to StackOverflow for support.

(Restart note added)
(Spacing added)
 
Line 29: Line 29:
  
 
[[Image:CKESP{{{version}}}_localization03.png|frame|center|CKEditor — Site Settings page localized in Polish in SharePoint {{{version}}}]]
 
[[Image:CKESP{{{version}}}_localization03.png|frame|center|CKEditor — Site Settings page localized in Polish in SharePoint {{{version}}}]]
 +
  
 
<note>If you do not see the changes after you have refreshed the page, you must restart the application pool. Go to '''Control Panel''' -> '''System and Security''' -> '''Administrative Tools''' -> '''Internet Information Services (IIS) Manager'''. Choose the right application pool and restart it.</note>
 
<note>If you do not see the changes after you have refreshed the page, you must restart the application pool. Go to '''Control Panel''' -> '''System and Security''' -> '''Administrative Tools''' -> '''Internet Information Services (IIS) Manager'''. Choose the right application pool and restart it.</note>

Latest revision as of 13:54, 15 February 2011

If you want to localize CKEditor for SharePoint, you can create new language strings for the locale that your SharePoint installation is using. Note that the user interface of the editor itself already has multiple language versions, so all you need to do is localize the SharePoint menu entries and descriptions to fully and seamlessly integrate CKEditor into a SharePoint system for a language other than English.

Go to the C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\{{{dir}}}\Resources directory and find the CKEditor.resx file that contains all language strings for the default English installation.

[[Image:CKESP{{{version}}}_localization01.png|frame|center|CKEditor.resx file in the Resources directory for SharePoint {{{version}}}]]


Copy the file to the same directory and rename it to CKEditor.xx-XX.resx, where xx-XX is an IETF language tag that stands for language-region. Some examples of valid IETF tags are de-DE for German language as used in Germany or fr-CH for French used in the Switzerland.

[[Image:CKESP{{{version}}}_localization02.png|frame|center|New localization files added to the Resources directory for SharePoiny {{{version}}}]]


A fragment of the original CKEditor.resx file with default English language strings is shown below.

CKEditor.resx file contents


Once your new language file is ready, open it with either a text editor or an XML schema editing tool and search for the language strings. In order to localize CKEditor for SharePoint you will need to translate all <value> strings for the </code> elements.

A fragment of the translated <code>CKEditor.pl-PL.resx</code> file with Polish language strings is shown below.

CKEditor.pl-PL.resx file contents


When you are done, save the file in the <code>C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\Resources</code> directory. Your localized strings will appear on all pages with an appropriate language set in the regional settings.

Image below shows the CKEditor — Site Settings configuration page with Polish translation applied.

[[Image:CKESP{{{version}}}_localization03.png|frame|center|CKEditor — Site Settings page localized in Polish in SharePoint {{{version}}}]]


important note
If you do not see the changes after you have refreshed the page, you must restart the application pool. Go to Control Panel -> System and Security -> Administrative Tools -> Internet Information Services (IIS) Manager. Choose the right application pool and restart it.

This page was last edited on 15 February 2011, at 13:54.