Configurations Options

The following list describes all possible configurations found in the fckconfig.js file:

AutoDetectLanguage
(true / false)
When set to "true", tells the editor to automatically detect the user language preferences to adapt its interface language.
With Internet Explorer, the language configured in the Windows Control Panel is used.
With Firefox, the browser language is used.
BaseHref
(string)
Base URL used to resolve links (on images, links, styles, etc.).
For example, if BaseHref is set to 'http://www.fredck.com', an image that points to "/images/Logo.gif" will be interpreted by the editor as "http://www.fredck.com/images/Logo.gif", without touching the "src" attribute of the image.
ContentLangDirection
('ltr' / 'rtl')
Sets the direction of the editor area contents. The possible values are:
  • ltr - Left to Right
  • rtl - Right to Left
ContextMenu
(string array)
Sets the list of active options in the context menu.
CustomConfigurationsPath
(string)
Sets the path of a custom file that can override some configurations. Leave it empty to ignore.
It is recommended to use absolute paths (starting with /), like "/myfckconfig.js".
Debug
(true / false)
Enables the debug window to be shown when calling the FCKDebug.Output() function.
DefaultLanguage
(string)
Sets the default language used for the editor's interface localization.
The default language is used when the AutoDetectLanguage options is disabled or when the user language is not available.
EditorAreaCSS
(string)
Set the CSS styles file to be used in the editing area. In this way you can point to a file that reflects your web site styles.
EnableSourceXHTML
(true / false)
When set to "true", tells the editor to process the HTML source to XHTML when switching from WYSIWYG to Source view.
EnableXHTML
(true / false)
When set to "true", tells the editor to process the HTML source to XHTML on form post.
FillEmptyBlocks
(true / false)
When set to "true", block elements (like P, DIV, H1, PRE, etc...) are forced to have content (a  ).
Empty blocks are "collapsed" by while browsing, so a empty <p></p> is not visible. While editing, the editor "expand" empty blocks so you can insert content inside then. Setting this option to "true" results useful to reflect the same output when browsing and editing.
FontColors
(string)
Sets the colors that must be shown in the colors panels (in the toolbar).
FontFormats
(string)
Sets the list of formats to be shown in the "Format" toolbar command.
FontNames
(string)
Sets the list of fonts to be shown in the "Font" toolbar command.
FontSizes
(string)
Sets the list of font sizes to be shown in the "Size" toolbar command.
ForcePasteAsPlainText
(true / false)
When set to "true", converts the clipboard contents to pure text on pasting operations.
ForceSimpleAmpersand
(true / false)
When set to "true", on XHTML processing, forces the ampersands (&) on tags attributes to not be converted to "&amp;". This conversion is a W3C requirement for XHTML, so it is recommended to leave this option to "false".
FormatIndentator
(string)
Sets the characters to be used when indenting the HTML source when formatting it. Useful values are a sequence of spaces ('     ') or a tab char ('\t').
FormatOutput
(true / false)
When set to "true", the output HTML generated by the editor will be processed and formatted.
FormatSource
(true / false)
When set to "true", the HTML shown by the editor, while switching from WYSIWYG to Source views, will be processed and formatted.
FullPage
(true / false)
When set to "true", enables full page editing (from <HTML> to </HTML>). It also enables the "Page Properties" toolbar button.
GeckoUseSPAN
(true / false)
When set to "true", tells Gecko browsers to use SPAN instead of <B>. <I> and <U> for bold, italic an underline.
IeSpellDownloadUrl
(string)
Points the editor to the URL used to download the ieSpell program setup.
ImageBrowser
(true / false)
If set to "true", the "Browse Server" button is visible in the "Image" dialog window.
ImageBrowserURL
(string)
Sets the URL of the page called when the user clicks the "Browse Server" button in the "Image" dialog window.
In this way, you can create your custom Image Browser that is well integrated with your system.
ImageBrowserWindowHeight
(number)
Sets the height, in pixels, of the "Image Browser" window (shown when the "Browse Server" button is clicked in the Image dialog window.
ImageBrowserWindowWidth
(number)
Sets the width, in pixels, of the "Image Browser" window (shown when the "Browse Server" button is clicked in the Image dialog window.
LinkBrowser
(true / false)
If set to "true", the "Browse Server" button is visible in the "Link" dialog window.
LinkBrowserURL
(string)
Sets the URL of the page called when the user clicks the "Browse Server" button in the "Link" dialog window.
In this way, you can create your custom File Browser that is well integrated with your system.
LinkBrowserWindowHeight
(number)
Sets the height, in pixels, of the "File Browser" window (shown when the "Browse Server" button is clicked in the Link dialog window.
LinkBrowserWindowWidth
(number)
Sets the height, in pixels, of the "File Browser" window (shown when the "Browse Server" button is clicked in the Link dialog window.
Plugins
(object)
With this object you can register the plugins to be loaded by the editor calling it "Add()" function.
PluginsPath
(string)
Sets the base path used when looking for registered plugins.
ShowBorders
(true / false)
When set to "true", show "fake" table and cells borders on table that has the border attribute set to zero.
SkinPath
(string)
Sets the path to the skin (graphical interface settings) to be used by the editor.
SmileyColumns
(number)
Sets the number of columns to be shown in the "Smiley" dialog window.
SmileyImages
(string array)
Sets the list of images to available in the "Smiley" dialog window.
SmileyPath
(string)
Sets the base path for the smiles images.
SmileyWindowHeight
(number)
Sets the height, in pixels, of the "Smiley" dialog window.
SmileyWindowWidth
(number)
Sets the width, in pixels, of the "Smiley" dialog window.
SpellChecker
('ieSpell' / 'SpellerPages')
Sets the spell checker to be used on spell checking operations. For more info, click here.
StartupFocus
(true / false)
When set to "true", forces the editor to get the keyboard input focus on startup (page load).
StylesXmlPath
(string)
Sets the path to the XML file that has the definitions and rules of the styles used by the "Style" toolbar command. For more info, click here.
TabSpaces
(number)
Set the number of spaces (&nbsp;) to be inserted when the user hits the "tab" key.
This is an Internet Explorer only feature. Other browsers insert spaces automatically by default.
ToolbarCanCollapse
(true / false)
When set to "true", tells the editor that the toolbar can be Collapsed/Expanded by the user when clicking the vertical bar placed on the left of it (on the right for "rtl" languages).
ToolbarSets
(object)
With this object you can define which items to be shown in the toolbar. You can define more than one toolbar in the configuration file.
ToolbarStartExpanded
(true / false)
When set to "true", the toolbar is Expanded on startup, otherwise it is Collapsed and the user must click on it to show it.
UseBROnCarriageReturn
(true / false)
When set to "true", inserts a <BR> tag when the user hits the "enter" key, instead of starting a new paragraph (<P> or <DIV>).
This is an Internet Explorer only feature. Other browsers insert the <BR> tag by default.