CKEditor configuration

The CKEditor provides some ways to customize the look and functions. Answers to questions should always be searched in the documentation for the CKEditor because the editor is an own project. Here are just some examples that directly affect Kunena.

Create your own configuration file

The path to the CKEditor configuration file is /media/kunena/core/js/ckeditor_config.js This file can be customized like remove buttons or add other languages etc… To ensure that these custom settings are not lost during an upgrade, add a prefix to the configuration file like “custom”. From ckeditor_config.js to customckeditor_config.js

Now go in the backend to Kunna -> Templates -> Your Kunena Template -> (tab) BBCode, scroll down and enter the prefix into this field (see image). After empty the Joomla and browser cache, the custom file will be used.

Use a different button layout (skins)

On the add-on page of the CKEditor project you find several skins for another editor layout. You see a preview on it, if you click on the name of a skin. Download your favorite and unzip the file. Open the folder and copy the contained sub folder to /media/kunena/core/js/skins

Now go in the backend to Kunna -> Templates -> Your Kunena Template -> (tab) BBCode, scroll down and enter the name of the skin into this field (see image). After empty the Joomla and browser cache, the new skin will be used.

Change the language

  • Download the language package from add-on page of the CKEditor project and unzip the file. Open the sub folder and copy the wanted language script to /media/kunena/core/js/lang. For this example I use the script for the German language de.js
  • In order for this language to be displayed, the entry CKEDITOR.lang.languages={"en":1,"de":1}(instead “de” your language code) must be made into the customckeditor_config.js
  • More information is available at Setting Editor UI Language

This change is browser related. This means that all users whose browser is German as the standard language, see the button in German. All other users see the buttons in English language. Multiple languages can also be added (see this forum topic on k.org).

Enable spell check as default

Enter this code config.scayt_autoStartup = true; to the customckeditor_config.js

When spell check is enabled as default, you don’t’ need the paste box. You get directly the suggested correct spellings.

Change spell check default language

Enter this code config.scayt_sLang = 'de_DE'; (instead de_DE your language code) to the customckeditor_config.js

The language selection for spell check seems to be limited. You see a list of available languages in the editor SCAYT dialog.

Sources: The most of these procedures have been found at CKEditor 4 Documentation and CKEditor Forums and all credit for the solutions goes to the original authors. These procedures have been supplemented and adapted for use with Kunena.