Troubleshooting

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.

Troubleshooting

The "XML request error: Internal Server Error (500)" error message is shown when clicking the "Browse Server" button in the image and link dialogs. What is wrong?

You probably don't have the correct "Connector" for your server language set in the fckconfig.js file. By default, it uses the ASP connector. For more info about it, please click here.

Or you have a not correct configuration of parameter ConfigUserFilesPath = "/folder_for_userfiles/" in the config.asp file located in the folder \FCKeditor\editor\filemanager\browser\default\connectors\asp

For CF MX6+ you must also have an application.cfm with a <cfapplication name="blah"> tag somewhere above FCKeditor so that application variables are enabled. FCK requires that.

I'm not able to upload big files (+200Kb) using the ASP Connector? How to fix it?

IIS6.0 prevents the upload of files bigger than +200Kb. So you need to make some changes in the default IIS settings first.

Background: For IIS6.0 users, the AspMaxRequestEntityAllowed property specifies the maximum number of bytes allowed in the entity body of an ASP request. If a Content-Length header is present and specifies an amount of data greater than the value of AspMaxRequestEntityAllowed, IIS returns a 403 error response.

This property is related in function to MaxRequestEntityAllowed, but is specific to ASP request. Whereas you might set the MaxRequestEntityAllowed property to 1 MB at the general World Wide Web Publishing Service (WWW Service) level, you may choose to set AspMaxRequestEntityAllowed to a lower value, if you know that your specific ASP applications handle a smaller amount of data.

Solution: Open your metabase.XML which is located in c:\Windows\System32\Inetsrv find the line "AspMaxRequestEntityAllowed" and change it to "1073741824". This is 1GB - of course you can enter another value to suite your needs.

When putting the editor in a hidden DIV on Gecko, the editor stops working. How can I solve it?

This is a Gecko specific bug. A sample workaround can be found in the "_testcases" folder. Take a look at the "004.html" file.You just need to "re-enable" the editing when you make the DIV visible.

Edited by Alexander Kerkum - May 31, 2006

You can use this function to enable/disable all fckeditors in a given div:

if (!document.all) {switchEditors(document.getElementById("div_id_here"),"on");}
function switchEditors(oNode,sType)
        {
        var i=0;
        for (i=0;i<oNode.childNodes.length;i++)
                {
                childNode = oNode.childNodes.item(i);
                editor = FCKeditorAPI.GetInstance(childNode.name);
                if (editor && editor.EditorDocument && editor.EditMode == FCK_EDITMODE_WYSIWYG)
                        {
                        editor.EditorDocument.designMode = sType;
                        }
                switchEditors(childNode,sType);
                }
        }

Edited by Ian Sullivan - 8/11/05

This doesn't seem to work anymore. If I open 004.html, hide, and then show the editor I can't edit. A thread in the : forums noted that hiding the iframe causes Geko to turn off designMode so you just need to turn it back on when you make it visible.

if (!document.all){ //Check for Gecko
    var editor = FCKeditorAPI.GetInstance(kArticleRTE);
    //This test is probably overcautious, but since
    //EditorDocument isn't available with an accessor
    //it could disappear in a future release.
    if (editor && editor.EditorDocument && editor.EditMode == FCK_EDITMODE_WYSIWYG){
       editor.EditorDocument.designMode = "on";
    }
}

Edited by Colin Ramsay - 15/08/2005

We managed to solve this issue. Firstly make sure the code which hides your div is *not* attached to the onload event. I put it inline after the FCKEditor. Secondly, when you go to show the editor again, do something like this:

function designModeOn(){
  var editor = FCKeditorAPI.GetInstance('FCKeditor1');
  editor.EditorDocument.designMode = "on";
}
function hide(){
  var container = document.getElementById('container');
  container.style.display = 'none'
}
function show(){
  var container = document.getElementById('container');
  container.style.display = 'block';
}
function doShow(){
  show();
  hide();
  show();
  designModeOn();
}
doShow();

In other words, show it, then hide it, then show it again. Then activate design mode.

Update by Christian Springub - 22 may 2006

These solutions works only under FireFox. I found the same problem also in Internet Explorer. In this browser when you show your hidden div you can write text in editor but you can't format it. I modified the first code and this is the effect:

function switchEditors(oNode) {
  var i=0;
  for (i=0;i<oNode.childNodes.length;i++) {
    childNode = oNode.childNodes.item(i);
    editor = FCKeditorAPI.GetInstance(childNode.name);
    if (editor && editor.EditorDocument && editor.EditMode == FCK_EDITMODE_WYSIWYG) {
      editor.SwitchEditMode();
      editor.SwitchEditMode();
    }
    switchEditors(childNode);
  }
}

and in the function which shows your div put this command:

switchEditors(document.getElementById('id of div'));

This function simply turn editor in source-code mode and then come back into design mode.

Added by Wojciech Małota ( CMS ) - 24 Jun 2006

I couldn't get the above working. Childnode.name wasn't working. I think Childnode.id might have. Anyway, I recoded it using prototype.js wizardry. It works for me. Haven't tested in IE yet though.

function switchEditors() {
   $$('textarea').each(function(ta) {
       editor = FCKeditorAPI.GetInstance(ta.id);
       if (editor && editor.EditorDocument && editor.EditMode == FCK_EDITMODE_WYSIWYG) {
           editor.SwitchEditMode()
           editor.SwitchEditMode()
       }
   })
}

Added by Matt C - 27 Jun 2006

This is the answer for Matt's text.

I've tested my code in latest release versions of IE, Opera and FireFox and there is no problem. The only one thing I found is that there is an error if script shows a hidden div (and executes the function which enables the editor) before the FCKEditor is loaded. I present here the solution of this bug. I hope all people will understand how it works so I don't have to describe it.

var FCKeditorLoaded = false;
function FCKeditor_OnComplete(editorInstance) {
  FCKeditorLoaded = true;
}
function switchEditors(ID) {
  if(!FCKeditorLoaded) {
    setTimeout('switchEditors(\'' + ID + '\')', 500);
    return;
  }
  DoSwitchEditors(document.getElementById(ID));
}
function DoSwitchEditors(oNode) {
  var i;
  for (i = 0; i < oNode.childNodes.length;i++) {
    childNode = oNode.childNodes.item(i);
    editor = FCKeditorAPI.GetInstance(childNode.name);
    if (editor && editor.EditorDocument && editor.EditMode == FCK_EDITMODE_WYSIWYG) {
      editor.SwitchEditMode();
      editor.SwitchEditMode();
    }
    DoSwitchEditors(childNode);
  }
}

To start the work you need to execute this:

switchEditors('id of element');

Added by Wojciech Małota ( CMS ) - 28 Jun 2006

The problem seems to be solved in FCK Version 2.3 and Firefox 1.5.0.3. In Firefox Version 1.03 the problem exists furthermore.

Added by Luis Rocha ( ludwig_von_rocht@yahoo.com ) - 20 Mar 2007

am using the latest version of FCK on Firefox 2.0 on both Mac and Windows Vista, the problem appears on both, but not on IE7. The editors are in a hidden div and when I get to a step in the application process it shows the editors' div, but when I click on the editor field it doesn't receive focus. What I do is hit the Source button twice and it allows me to focus after that.

I'm getting a Syntax Error for the Class keyword when trying to use FCKeditor with ASP. What is causing this?

I'm getting a Syntax Error for the Class keyword when trying to use FCKeditor with ASP. What is causing this?

Make sure that the include statement for the fckeditor.asp file is before all other code on your page. If you are using the editor on another included page, make sure the fckeditor.asp include is at the top of the parent page.

Why do I get a "Page Cannot Be Displayed" error wherever I place the code to start the editor?

This can be caused because your code is not pointing the editor to the directory where the editor core (the main JavaScript file of the editor) has been installed on your server.

By default, the editor is configured to work in the "FCKeditor" folder at you web site root. You can easily change it by setting the BasePath property in your code when creating an instance of the editor. This is a sample code for ASP:

<%
oFCKeditor.BasePath = "/fckeditor/"
%>

Internet Explorer complains of a JavaScript error and no toolbar shows. Why?

Possibly check in your configuration file fckconfig.js for errors. The custom toolbar setting line labeled FCKConfig.ToolbarSets[ "Default" ] is a common place to have an error. An extra comma is the most probable problem.

FCKConfig.ToolbarSets["Default"] = [
        ['Source','-','Save','NewPage','Preview'],
        ...
        ['Style','FontFormat','FontName','FontSize'],
] ;

Should be:

FCKConfig.ToolbarSets["Default"] = [
        ['Source','-','Save','NewPage','Preview'],
        ...
        ['Style','FontFormat','FontName','FontSize']
] ;

The Built In File Browser causes my IIS to stall/hang.

If you are developing a project on a server with McAfee Antivirus software running, chances are good that the problem lies in part with the antivirus software. Try disabling ScriptStopper. ScriptStopper is trying to protect your computer from malicious scripts that will access your file system. Do not forget to re-enable ScriptStopper once you are finished.

For information on enabling/disabling ScriptStopper, see your help files or McAfee's online documentation.

This same problem *may* be true for Norton Antivirus, but I have not tested with that.

With ASP.Net, I'm having a "Cannot execute code in freed script" JavaScript error.

Try to turn off SmartNavigation.

After configuring Speller Pages, Internet Explorer gives strange script errors.

Make sure your server is not running PHP in safe mode. The Speller Pages spell checker needs to be able to run the shell_exec() PHP function, which is disabled in safe mode.

Firefox was not loading my toolbars if I used the default set, but it was working for basic.

I found that there were certain buttons that caused problems Style, Font Format/Size/Face, Text Color/BGColor.

I finally figured out that this had to do with the mime type that my server was sending, so I added the following line to my .htaccess:

AddType text/xml .xml

This resolved the problem of displaying, but it turned out that was only part of the problem. It turned out that after I got the toolbars displayed, that FCKeditor never fully loaded - the progress bar was stuck almost all the way done and my memory usage was increasing slowly.

I resolved this problem with the following in my .htaccess file:

<FilesMatch "\.html$">
ForceType none
</FilesMatch>
<FilesMatch "\.htm$">
ForceType none
</FilesMatch>

Like a lot of webmasters, I'm doing some funky stuff with mod_rewrite, parsing html as php, etc. It turned out that the things I was doing in my root directory were not compatible with FCKeditor.

In the end, this is what my /FCKeditor/.htaccess file looks like:

AddType application/x-javascript .js
AddType text/css .css
AddType text/xml .xml
<FilesMatch "\.html$">
ForceType none
</FilesMatch>
<FilesMatch "\.htm$">
ForceType none
</FilesMatch>

The first two lines (having to do with .js and .css) I picked up from the htaccess.txt file as a troubleshooting step.

Security warning when using toolbar or context menu cut/copy/paste commands. How to enable them to work properly?