CKEditor 3.1 released!
Four months after the launch of CKEditor 3.0, we finally have the first minor release of the 3.x series: CKEditor 3.1. This is supposed to become one of the most important releases for the future history of this series as it introduces several features we've planned for the 3.0, but which we were not able to have on it.
Most of the bug fixing is already available in CKEditor 3.0.2. This version 3.1 is instead focused on introducing new features or even fixes that involve stronger changes to the editor.
What's new?
There are several new features introduced with CKEditor 3.1. We've been focused on aligning CKEditor with FCKeditor 2 features which were still not available, as well as introducing a few new things.
The following are the most relevant new features.
Full page support
CKEditor is usually used to edit content to be injected inside web pages. There are some web applications that instead make it possible to users to edit entire pages, from <html> to </html>. We're introducing support for it with CKEditor 3.1. Just use the fullPage setting to enable it.
Shared toolbar (or spaces)
What about having two editing areas in the page, both sharing the same toolbar placed somewhere else? Or even having an editor with a floating toolbar? CKEditor 3.1 makes it possible by introducing the concept of shared spaces.
Powerful pasting features
The clipboard pasting features have been completely reviewed, making them easier to use and much more powerful. We're introducing a new Paste from Word cleanup system, as well as better conversion results for Paste as Plain Text.
Native jQuery integration
We're introducing the concept of "adapters", with which it's possible to provide native integration with existing JavaScript libraries and frameworks. CKEditor 3.1 comes with the jQuery adaptor, a jQuery plugin in effect, which makes it possible to integrate with CKEditor the jQuery way, like doing $().ckeditor().
Native PHP integration
The PHP integration is our first standardized server side integration. PHP developers will now have a full API to easily integrate with CKEditor without having to code the JavaScript client side.
Table merging tools
Advanced tools for editing tables are now available in the context menu. It's now easy to merge and split cells, creating advanced table layouts.
The "showborder" plugin
Now tables with no borders will be visually displayed in the editor, so users can easily find their cells and manage their contents.
Support for "baseHref"
Just like using the <base> tag into web pages, CKEditor can now be configured to use a specific URL as the "base" to resolve the address of other resources, like images. This is extremely useful when using the editor to manage pages that will be running in different domains or in different parts of the site. See baseHref in the API docs.
DIV containers
It's now easy to create <div> blocks that hold part of the contents with the new Div Container button.
And more!
There are also several other innovative features in the new release, like the possibility of placing inline CSS in the settings (to reduce the number of downloaded files), bodyId and bodyClass settings, email protection through the emailProtection setting and more.
Changelog
Check out the What's New? page for the full list of changes.
Download
License
CKEditor is available in Open Source and Commercial licenses. Full details can be found at our license page.
Reporting Issues
Please use the CKEditor development web site to report issues and suggestions through tickets.
Support
Community support is available through our forums. Visit the support page for additional options.
Other Products
Browse for images and files in CKEditor, with thumbnails, easy to use and intuitive context menu.
Commercial License
For many companies and products, Open Source licenses are not an option. This is why the Closed Distribution License (CDL) has been introduced.

Comments
ckeditor with dokuwiki
How can I integrate CKeditor with dokuwiki?
Still ruins HTML
Unfortunately CKeditor still ruins HTML and rewrites it in it's own way.
Too bad. It used to be a useful project :(
Vague
CKEditor is well known for producing prety good output.
Please be more precise and constructive, eventually opening a ticket for the issue at our dev site, including the exact description of the problem. Thanks!
special characters
I need to selected multiple characters from the window, but every time you select a character the window will close. how to keep the window open and keep adding the characters to the main control.
About the border of some elements
I found that some styles can not use the toolbar to set. And that must use the source code. For example, boder-collapse. In addition, when create a DIV element, it can not use the panel to set the border's color and width.
FullPage What is the magic to work?
I still do not understand why the simple configuration fullpage not work for me,
which will be the magic?
I just want to create an html editor with fullpage active!
IE 8 IE 7
Hi!
Gratulations and many thanks for this great job!!
At the moment we got some problems with the following code in IE 7 and IE8:
config.format_p={element:'p',attributes:{class:'text'}};
in config.js
In firefox there is no ploblem. Editor writes p class="text" in the source code. In IE 8 and 7 this doesn´t work at all.
Do you got an idea what´s wrong in this case?
all the best.
T
IE 8 Problem solved
http://cksource.com/forums/viewtopic.php?f=11&t=15503&p=39458&hilit=+cke...
Yes, class!
In fact "class" is a JavaScript statement and cannot be used in object literal definitions. It's enough to put it into quotes, transforming it in a string.
Uploader
How to Config the File uploader...
it seams not working at localhost
add and remove tabe in dialogs
HI I am using ckeditor..
I want to remove the tabs in the dialogs and add custome tabs
tell me the code for configuration
CTRL+V - on paste event
how do i intercept the CTRL+V (onpaste) event.
I basically want to grab CTRL+V data and add few text to it and then add it to the editor.
Use the "paste" event for that
You can use the paste event for that. Just update the e.data.html event data with your changes in the listening function.
get html data
If I only need to get the html data (after copy) but not actually do paste command, is there any way to do so? e.g. if is there anyway to get by html data by paste event without really doing paste?
paste event
paste event works in FF/Chrome but not work in IE7. Maybe i doing something wrong.
Do you have a sample code?
WFM with IE8 Compatibility mode
I didn't check it with IE7, but the code found in the following URL works well for me with IE8 Compatibility mode: http://pastebin.com/f254d5d9a
Still does not work in IE7.
Anyone??
WFM with IE7 also
Ok, you made me fire my virtual machine with IE7 :)... and my sample works for me.
If you still have an issue with it, I would ask you to please open a ticket at our dev site, attaching a sample test page so it can be properly investigated.
Does not WFM in IE7 - w/code
Thanks a lot for your quick response. I really appreciate it.
Here's the code that i use and it works perfectly in FF and chrome but does not work in IE 7. Do you see anything wrong with this one.
/* code*/
CKEDITOR.replace("<%= txtedit.ClientID %>",
{
toolbar : 'MyToolbar',
startupFocus : true,
});
CKEDITOR.on( 'instanceReady', function( ev ) {
ev.editor.on( 'paste', function( evt ) {
var sData = evt.data['html'];
// do your thing here
alert('h');
evt.data['html'] = '[quote]' +sData + '[quote]';
//evt.data.html = '<h1>Test!!!</h1>' + evt.data.html;
});
});
RE: Does not WFM in IE7 - w/code
mural,
You have placed a comma after the last property in your JSON object (config):
startupFocus : true,
Remove this comma and IE works just fine.
You are the best
Thank you.
CKEditor 3.1 - getClipboardData
I'm wondering the very same thing. Does any one know how to get html clipboard data?
CKEditor + Mediawiki ?
First of all thanks, million thanks!
For your work and so good editor.
We are using it as one of the must extensions in every mediawiki installations we have.
I am installing a new one, and trying to get CKEditor to work, with no luck yet.
I have been looking around for any documentation about it but the most interesting thing I could find was this:
http://docs.cksource.com/index.php?title=User_talk:Stompersly&redirect=no
Looks like it´s possible.
Do you know where I can find any help?
Thanks a lot again.
CKEditor + MediaWiki
For example here http://kirkburn.wikia.com/index.php?title=Sandbox&action=edit you can check out CKEdtior (3.0.1) working with MediaWiki. Note that it translate HTML back to wikitext.
CKEditor + MediaWiki
Hello Inez,
Did you know how to integrate CKEditor and Mediawiki or where I can find information?
I have been looking around and there´s not an extension.
Thanks
Did you find any solution for the integration?
Hello, Gabi
Did you find the extention or solution for the integration of CKEditor?
If you found, could you help me to share the solution?
Thanks,
zhongzhen.
still no luck
The install guide just says to extract to the root, which clearly doesnt work..
I would really appreciate your help with this, it looks fantastic and other people I have mentioned it sing its praises.
Please help.
Luke
Multiple css in area
Hi Fred, Alfonso, and all the ckeditor dev team
Bravo for this big big work !
I didn't follow all new features implemented in ckeditor since the 3.0, so don't be surprised if my question is almost off-topic :
is it again possible to insert more than one external css applied to editing area and dialog boxes with this new ckeditor version ?
Many thanks again, and a happy new year for everybody
Yes, look at the docs
The online documentation for the contentsCss setting shows an example on how to do that.
Cool
Many thanks ;-)
Still no OSS file browser
Am I missing something or the 3.1 doesn't include a free oss lite version of a file browser?
Simone
FCKEditor Filemanager
If you have the FCKEditor Filemanager you can change some javascript calls in it to meet the requirements of CKEditor and it will work.
It's not hard to do it.
Refresh CKeditor
hi, I´m with a problem when I try change of the FCKeditor to CKeditor, I'm a programmer of java, and I use this editor, but I don't know how change, so, I wanna know what files I should change exactly, you can pass me by email?!
RE: FCKEditor Filemanager
Is there somewhere that documents the changes that are needed?
I realize that CKSource is trying to sell a file browser, so they're probably not going to be overly helpful in the endeavour, but having a FOSS file browser is pretty important.
Thanks!
Check the docs
It's explained here: http://docs.cksource.com/CKEditor_3.x/Developers_Guide/File_Browser_%28U...
Sorry, need more details
I don't get it. Could you briefly describe what steps need to be taken to use the FCKeditor filemanager with CKEditor?
RE: Check the docs
Excellent, thank you.
We may not have it
We may not have file browsers included in CKEditor by default. Our recommendation is CKFinder, but you can also find other OSS options in the web.
Unfortunately CKFinder is not OSS
Unfortunately CKFinder is not OSS and I cannot include it into an OSS product as Subtext.
Check the web
You should check other options available in the web. I'm sure you'll find OSS options that fit your needs.
Here's a list of OSS options with comments
I looked at several options, but wasn't able to confirm any as:
- fully functional (some worked sporadically, and some not at all)
- secure (this would most likely require work, but some did not appear to be easily secured)
Here's the article: http://cli.gs/CKeditor
Too bad none of them has a server side part that works on .NET.
Too bad none of them has a server side part that works on .NET... all LAMP stuff
customConfig no longer respected?
Just upgraded to v3.1 and figured that all of my configurations would still be respected (as they are all external of the ckeditor folder). However, I had to move my configuration from that customConfig referenced file straight into the CKEDITOR.replace function in order for those config lines to be respected.
works for me
Can you provide more info to reproduce your problem?
I'm using an external file and I don't see any problem
Still not working...
To provide you with more information I made a thread in the Support forum. I am kind of curious what is going on, because I stripped out everything else and made a very, very simple testbed website to see what was occurring...
Documentation for 3.1?
Has the JavaScript API been updated yet? Need to know about any configuration changes/additions. Also is the "Paste As Plain Text" dialog depreceated, or is this still planned?
Just updated
I have just updated the code so the API docs for configurations will properly display the "Since" field for the settings introduced with the 3.1. The online documentation pages should be updated tomorrow automatically by our server.
Regarding the Paste as Plain Text dialog, maybe I didn't understand your question, but you can find the button in the toolbar. Attention that, whenever possible, the dialog is not shown and the pasting process is executed immediately.
The heading still says "3.0"
The heading still says "3.0" and I don't see any "Since 3.1" marks in the .config part of the API. Are there no new configuration options?
I read in the tracker that there was intentions in deprecating the "Past As Plain Text" dialog and that there may be a way to always past as plain text without a dialog. I think it was a goal for 3.1. Was wondering if that happened, was it scrapped, or if it's just planend for a future date.
it works for me
Look here: http://docs.cksource.com/ckeditor_api/symbols/CKEDITOR.config.html#.body...
Thanks!
Thanks to the CK team and keep up the great work.
Post new comment