Important Notes:

The CKEditor testing environment is now publicly available. CKEditor tests can be found in the tests/ directory. Read more about how to set up the environment and execute tests in the CKEditor Testing Environment guide.

Please note that the "tests" folder is not available in release packages, it is available only in the development version of CKEditor available on GitHub.

New Features:

• #11909: Introduced a parameter to prevent the editor.setData() method from recording undo snapshots.

Fixed Issues:

• #11757: Fixed: Imperfections in the Moono skin. Thanks to danyaPostfactum!
• #10091: Blockquote should be treated like an object by the styles system. Thanks to dan-james-deeson!
• #11478: Fixed: Issue with passing jQuery objects to adapter configuration.
• #10867: Fixed: Issue with setting encoded URI as image link.
• #11983: Fixed: Clicking a nested widget does not focus it. Additionally, performance of the widget.repository.getByElement() method was improved.
• #12000: Fixed: Nested widgets should be initialized on editor.setData() and nestedEditable.setData().
• #12022: Fixed: Outer widget's drag handler is not created at all if it has any nested widgets inside.
• #11960: [Blink/WebKit] Fixed: The caret should be scrolled into view on Backspace and Delete (covers only the merging blocks case).
• #11306: [OSX][Blink/WebKit] Fixed: No widget entries in the context menu on widget right-click.
• #11957: Fixed: Alignment labels in the Enhanced Image dialog window are not translated.
• #11980: [Blink/WebKit] Fixed: <span> elements created when joining adjacent elements (non-collapsed selection).
• #12009: [Nested widgets] Integration with the Magic Line plugin.
• #11387: Fixed: role="radiogroup" should be applied only to radio inputs' container.
• #7975: [IE8] Fixed: Errors when trying to select an empty table cell.
• #11947: [Firefox+IE11] Fixed: Shift+Enter in lists produces two line breaks.
• #11972: Fixed: Feature detection in the element.setText() method should not trigger the layout engine.
• #7634: Fixed: The Flash Dialog plugin omits the allowFullScreen parameter in the editor data if set to true.
• #11910: Fixed: Enhanced Image does not take config.baseHref into account when updating image dimensions.
• #11753: Fixed: Wrong checkDirty() method value after focusing or blurring a widget.
• #11830: Fixed: Impossible to pass some arguments to CKBuilder when using the /dev/builder/build.sh script.
• #11945: Fixed: Form Elements plugin should not change a core method.
• #11384: [IE9+] Fixed: IndexSizeError thrown when pasting into a non-empty selection anchored in one text node.

Important Notes:

• Marked the editor.beforePaste event as deprecated.
• The default class of captioned images has changed to image (was: caption). Please note that once edited in CKEditor 4.4+, all existing images of the caption class (<figure class="caption">) will be filtered out unless theconfig.image2_captionedClass option is set to caption. For backward compatibility (i.e. when upgrading), it is highly recommended to use this setting, which also helps prevent CSS conflicts, etc. This does not apply to new CKEditor integrations.
• Widgets without defined buttons are no longer registered automatically to the Advanced Content Filter. Before CKEditor 4.4 widgets were registered to the ACF which was an incorrect behavior (#11567). This change should not have any impact on standard scenarios, but if your button does not execute the widget command, you need to set allowedContent andrequiredContent properties for it manually, because the editor will not be able to find them.
• The Show Borders plugin was added to the Standard installation package in order to ensure that unstyled tables are still visible for the user (#11665).
• Since CKEditor 4.4 the editor instance should be passed to CKEDITOR.style methods to ensure full compatibility with other features (e.g. applying styles to widgets requires that). We ensured backward compatibility though, so the CKEDITOR.style will work even when the editor instance is not provided.

New Features:

• #11297: Styles can now be applied to widgets. The definition of a style which can be applied to a specific widget must contain two additional properties — type and widget. Read more in the Widget Styles section of the "Syles Drop-down" guide. Note that by default, widgets support only classes and no other attributes or styles. Related changes and features:
  • Introduced the CKEDITOR.style.addCustomHandler() method for registering custom style handlers.
  • The CKEDITOR.style.apply() and CKEDITOR.style.remove() methods are now called with an editor instance instead of the document so they can be reused by the CKEDITOR.editor.applyStyle() and CKEDITOR.editor.removeStyle() methods. Backward compatibility was preserved, but from CKEditor 4.4 it is highly recommended to pass an editor instead of a document to these methods.
  • Many new methods and properties were introduced in the Widget API to make the handling of styles by widgets fully customizable. See: widget.definition.styleableElements,  widget.definition.styleToAllowedContentRule,  widget.addClass(),  widget.removeClass(),  widget.getClasses(),  widget.hasClass(),  widget.applyStyle(),  widget.removeStyle(),  widget.checkStyleActive().
  • Integration with the Allowed Content Filter required an introduction of the CKEDITOR.style.toAllowedContent() method which can be implemented by the custom style handler and if exists, it is used by the CKEDITOR.filter to translate a style to allowed content rules.
• #11300: Various changes in the Enhanced Image plugin:
  • Introduced the config.image2_captionedClass option to configure the class of captioned images.
  • Introduced the config.image2_alignClasses option to configure the way images are aligned with CSS classes. If this setting is defined, the editor produces classes instead of inline styles for aligned images.
  • Default image caption can be translated (customized) with the editor.lang.image2.captionPlaceholder string.
• #11341: Enhanced Image plugin: It is now possible to add a link to any image type.
• #10202: Introduced wildcard support in the Allowed Content Rules format.
• #10276: Introduced blacklisting in the Allowed Content Filter.
• #10480: Introduced code snippets with code highlighting. There are two versions available so far — the default Code Snippetwhich uses the highlight.js library and the Code Snippet GeSHi which uses the GeSHi library.
• #11737: Introduced an option to prevent filtering of an element that matches custom criteria (seefilter.addElementCallback()).
• #11532: Introduced the editor.addContentsCss() method that can be used for adding custom CSS files.
• #11536: Added the CKEDITOR.tools.htmlDecode() method for decoding HTML entities.
• #11225: Introduced the CKEDITOR.tools.transparentImageData property which contains transparent image data to be used in CSS or as image source.

Other changes:

• #11377: Unified internal representation of empty anchors using the fake objects.
• #11422: Removed Firefox 3.x, Internet Explorer 6 and Opera 12.x leftovers in code.
• #5217: Setting data (including switching between modes) creates a new undo snapshot. Besides that:
  • Introduced the editable.status property.
  • Introduced a new forceUpdate option for the editor.lockSnapshot event.
  • Fixed: Selection not being unlocked in inline editor after setting data (#11500).
• The WebSpellChecker plugin was updated to the latest version.

Fixed Issues:

• #10190: Fixed: Removing block style with editor.removeStyle() should result in a paragraph and not a div.
• #11727: Fixed: The editor tries to select a non-editable image which was clicked.