ckeditor-dev

CKEditor 4 - The best browser-based WYSIWYG editor

This repository contains the development version of CKEditor.

Attention: The code in this repository should be used locally and for development purposes only. We do not recommend using it in production environment because the user experience will be very limited. For that purpose, you should either build the editor (see below) or use an official release available on the CKEditor website.

Code Installation

There is no special installation procedure to install the development code. Simply clone it to any local directory and you are set.

Available Branches

This repository contains the following branches:

• master – Development of the upcoming minor release.
• major – Development of the upcoming major release.
• stable – Latest stable release tag point (non-beta).
• latest – Latest release tag point (including betas).
• release/A.B.x (e.g. 4.0.x, 4.1.x) – Release freeze, tests and tagging. Hotfixing.

Note that both master and major are under heavy development. Their code did not pass the release testing phase, though, so it may be unstable.

Additionally, all releases have their respective tags in the following form: 4.4.0, 4.4.1, etc.

Samples

The samples/ folder contains some examples that can be used to test your installation. Visit CKEditor SDK for plenty of samples showcasing numerous editor features, with source code readily available to view, copy and use in your own solution.

Code Structure

The development code contains the following main elements:

• Main coding folders:
  • core/ – The core API of CKEditor. Alone, it does nothing, but it provides the entire JavaScript API that makes the magic happen.
  • plugins/ – Contains most of the plugins maintained by the CKEditor core team.
  • skin/ – Contains the official default skin of CKEditor.
  • dev/ – Contains some developer tools.
  • tests/ – Contains the CKEditor tests suite.

Building a Release

A release-optimized version of the development code can be easily created locally. The dev/builder/build.sh script can be used for that purpose:

> ./dev/builder/build.sh

A "release ready" working copy of your development code will be built in the new dev/builder/release/ folder. An Internet connection is necessary to run the builder, for its first time at least.

Testing Environment

Read more on how to set up the environment and execute tests in the CKEditor Testing Environment guide.

Reporting Issues

Please use the CKEditor GitHub issue page to report bugs and feature requests.

License

Copyright (c) 2003-2017, CKSource - Frederico Knabben. All rights reserved.

For licensing, see LICENSE.md or http://ckeditor.com/license

Changelog

CKEditor 4.7.3

New Features:

• #568: Added possibility to adjust nested editables' filters using the CKEDITOR.filter.disallowedContent property.

Fixed Issues:

• #554: Fixed: change event not fired when typing the first character after pasting into the editor. Thanks to Daniel Miller!
• #566: Fixed: The CSS border shorthand property with zero width (border: 0px solid #000;) causes the table to have the border attribute set to 1.
• #779: Fixed: The Remove Format plugin removes elements with language definition inserted by the Language plugin.
• #423: Fixed: The Paste from Word plugin pastes paragraphs into the editor even if CKEDITOR.config.enterMode is set to CKEDITOR.ENTER_BR.
• #719: Fixed: Image inserted using the Enhanced Image plugin can be resized when the editor is in read-only mode.
• #577: Fixed: The "Delete Columns" command provided by the Table Tools plugin throws an error when trying to delete columns.
• #867: Fixed: Typing into a selected table throws an error.
• #817: Fixed: The Save plugin does not work in Source Mode.

Other Changes:

• Updated the WebSpellChecker plugin:
  • #40: Fixed: IE10 throws an error when spell checking is started.
• #800: Added the CKEDITOR.dom.selection.isCollapsed() method which is a simpler way to check if the selection is collapsed.
• #830: Added an option to define which dialog tab should be shown by default when creating CKEDITOR.dialogCommand.