This is an archived discussion page for the HowToManuallyIntegrateFCKEditor page.

DavidUctaa - For a painless, and practically brainless method of integrating a different WYSIWYG editor (TinyMCE), see my TinyMCE integration instructions.

GregSwindle - I agree! TinyMCE is the way to go.

EricJohnson - I had some problems with the FCKeditor integration instructions and thought it would be best to create a related discussion page for dialogue on the issues I'm seeing. Any recommendations/clarifications or pointers much appreciated.

JSPWiki Environment

  • JSPWiki version 2.2.33
  • Tomcat 4.1.30
  • Mac OS X 10.4.4

Step 1 Issues

  • The instruction Copy the archive directory editor to the JSPWiki scripts/fckeditor directory (overwrite the existing fckeditor.js) seems to imply that the act of copying the "editor" directory into "scripts/fckeditor" would overwrite "fckeditor.js"
    • In my installation of JSPWiki v2.2.33, the "fckeditor.js" script that is shipped in the downloadable .war file is located in the "scripts/fckeditor" directory and would therefore not be over-written by the act of copying the "editor" directory. If I should instead delete "fckeditor.js" from the specified directory, that would be a useful distinction to make.

Step 2 Issues

  • The FCKeditor "JSP Integration Pack" no longer seems to be available from
    • There is something called "FCKeditor.Java", but the contents of that download and associated configuration files do not seem to align with the instructions.
    • There does not appear to be a SimpleUploaderServlet, associated directories and/or entries in the web.xml file for the FCKeditor.Java package. Caveat: I looked at versions 2.1 and version 2.2 of the FCKeditor.Java package

Overall, I got the impression that the instructions I was following may not work -- even with some tweaking and debugging -- so I decided to stop working on it and flag the issue.

Other Questions

  • Is there an easy way to experiment with the FCKeditor on certain wiki pages, while continuing to use the standard editing form elsewhere?
    • I think this may be possible in later versions of JSPWiki (v2.3.7+)... Any guidance appreciated.
  • Is it proper protocol on the JSPWiki project to flag this kind of thing as a documentation bug?

The FCK editor documentation works only with 2.2.x series. For 2.3, we've done quite a lot more integration work. However, I haven't been tracking the FCK editor for a few months now, so I'm not quite sure what the status is. Any help is appreciated.

This is a good way to flag things. You might also consider adding it to the Main page (and cleaning away some links that are no longer relevant discussion items).

- JanneJalkanen

Clarification: My difficulties were encountered using the documentation and the JSPWiki 2.2.x series. FCKeditor packaging has definitely changed for the server side code. The relatively minor issue with Step 1 was encountered with the exact versions of both JSPWiki and the FCKeditor client package as referenced by the instructions.

I'm happy to do some testing with JSPWiki 2.3.x alpha/nightly code and help with updated instructions. I'd like some help from someone that has FCKeditor working, since stumbling through on my own may take more time than I've got. Ideally, we should start with a fresh download of the FCKeditor client and server packages from Sourceforge, then run through the process from beginning to end. The *nix script command can be helpful for keeping a record of all the little steps along the way...

Anyone interested?

PS The recent mention of a patch from Chuck Smith to support multiple editors in 2.3.89+ sounds intriguing.

-- EricJohnson

Actually, there's no need for the JSP integration package (JSPWiki has its own integration built-in). You only need the editor package.

The instructions are unfortunately for 2.2; there are no instructions for 2.3 at the moment...

-- JanneJalkanen

I will try this install again and post my results/questions.

-- EricJohnson

That would be great!

-- JanneJalkanen

If I use the FCKEditor, will using Headings from the Format dropdown (which generates H1, H2, H3 etc. tags) automatically create page anchors that I can link to via a WikiLink (e.g., WikiLink#SectionName)?

--David Uctaa, 25-May-2006

When I decompress the files downloaded from their site into the folder <wikihome>/scripts/fckeditor I recieve two errors when switching to the fckeditor:
OS:Linux FC4
There wasn't any mention of anything going wrong in the JSPWiki log or catalina.
Any ideas on where I went wrong? Is it too early for the version of JSPWiki I'm using to be asking this? Thanks in advance for any advice.
Creating a "scripts" directory inside the
folder and copying the
file into it seems to resolve the above two errors.

BUT I get a the following when I click "save":
JSPWiki has detected an error
Error Message
Place where detected
native methodjava.lang.ClassLoader.defineClass1(), line -2

-- Neil Phillips - 27/07/2006

Thank you Neil. A step closer. I was able to reproduce the same error. StoneBrooks
I had the same problem. The solution for me was to run Tomcat with JDK 1.4.2. (don't forgett the JDK 1.4 Compatability Package)

-- mbob - 30/07/2006

I'm pretty new to JSPWiki, so please apologize when I ask stupid questions. After installing JSPWiki 2.4.15 adding JavaMail, customizig authentication and the like everything seems to work well- with one exception:

WYSIWYG-editing: When I select "FCK" in the "Edit page" context, the content field disappears and I have to switch back to plain. The same happens when I try to install FCK as recommended.

So it's not my experience that it is so easy as mentioned before by someone.

For me and other beginners it would be extremely useful, to have a "recipe" how to use WYSIWYG.

Thanks! Hans-J.

--hjmbn, 28-Jul-2006

After adding the FCK editor files to your installation be sure to clear your browser cache.

--Stone Brooks, 28-Jul-2006

Thanks, Stone Brooks. Unfortunately this doesn't help. I download the FCKeditor_2.3.1.tar.gz from, then I "tar xvfz" it into the scripts-directory which creates FCKeditor there.

I move away the fckeditor folder and then I rename the newly created folder FCKeditor to fckeditor. Then I restarted everything (browser, container): no effect. Whenever in editing mode for a page I select "FCK" instead of "plain" the input field disappears.

I'm using JSPWiki 2.4.15, tomcat 5.5.17, jvm 1.5.0_06 on a solaris 10 OS.

I couldn't find any useful information in the log files.

Got any clue? Thanks.

--hjmbn, 31-Jul-2006

I found that I had to copy the lines below (from the scripts/fckconfig.js file) to the scripts/editor/scripts/fckconfig.js to fix the "JSPWiki Toolbar not found" problem:

FCKConfig.ToolbarSets["JSPWiki"] = [
] ;

Oh yeah, my set-up: CentOS release 4.3, Java 1.5.0_07, JBoss Application Server 4.0.4, JSPWiki 2.4.36

--elgee, 19-Aug-2006

Question : Can any buddy help me out, I have integrated FCK editor in my JSPWiki by reading your manual and it’s work fine (thanks). I got a problem in uploading an image. When I click on “Browse Server” button it gives me an error “XML request error: Internal Server Error (500)”. Please help me to solve this error it’s an urgent.

FCK editor is really cool, although JSPWiki 2.4 realse remove it, I spend much time on adding it :)

but I found FCK editor can not process Image tag correctly. Insert a image, save it, image tag will be a link!!!! if there are already image links in page, FCK editor can not view it !

--AnonymousCoward, 12-Sep-2006


We removed it because the support had bugs in it, as you've noticed... But the code is still in CVS and in the source package, so if you guys have any patches, I'd love to take it in. In fact, it would be great if someone would package a ready-to-install FCK package for JSPWiki and upload it here!

-- JanneJalkanen, 12-Sep-2006

Just wanted to share my experience#

Hi there - got the FCKEditor 2.3.2 up and running with JSPWiki 2.4.87 on JBoss 3.2.8. It tried several configurations, so sadly I cant tell you what the major tweak was.

Looks like downloading the package from and extracting it to the scripts dir did it.

Notice some pittfalls:

  • set allowHTML = true in
  • to get the FCK option in the combo box download JSPWiki source (Checkout the branch 2_4), add the editor entry to etc/ini/jspwiki_module.xml and build ant target opened_war
  • the configuration files (fckconfig.js and fckstyles.xml) which are used are located directly in the scripts dir - the files from the FCK zip (one level deeper: scripts\fckeditor) will be ignored
  • set FCKConfig.EditorAreaCSS = FCKConfig.BasePath + '../../../templates/default/jspwiki.css' ; in fckconfig.js for better WYSIWYG

Now the bad news: WYSIWYG IS NOT WYSIWYG#

Looks like the convertion of the HTML input to wiki markup removes some information. Found some discussion, but none gives a solution.

Some examples:
Adding a <h1> a page with PLAIN , saving, editing with FCK (dont change, just open and save) leads to <h2>

Also some CSS tags will not be converted correctly: <p class="warning">X</span> is not converted to %%warning X%%

BUT: <span style="COLOR: green">X</span> will be converted correctly to %%( color: green; ) X%%

Thats it ... have to find out if I can accept this behaviour ...

-- Timo, 16.01.2007

After installing the fckeditor new patches, the editor is working but i can't save my changes. The error message :

Error Message org/apache/xerces/parsers/AbstractSAXParser Exception java.lang.NoClassDefFoundError Place where detected native methodjava.lang.ClassLoader.defineClass1(), line -2

plz help me to solve the problem..

--Jobin C Antony, 15-feb-2007

For those willing to build JSPWiki from source, please see WysiwygEditingPatch for several patches that fixes the integration problem (along with some additional changes).

--David Au, 02-Feb-2007

Locking down this page because of the constant spam. You'll need to be authenticated to comment on or edit this page.

--David Au, 05-Apr-2007

Add new attachment

Only authorized users are allowed to upload new attachments.
« This page (revision-1) was last changed on 01-Jan-2008 17:27 by David Au