Integration

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.

There are several ways to integrate CKEditor into your pages. This page presents the most common way to achieve it.

Step 1: Loading CKEditor

CKEditor is a JavaScript application. To load it, you just need to include a single file reference at your page. Supposing that you have installed CKEditor at the "ckeditor" directory at the root of your web site, here you have an example:

<head>
	...
	<script type="text/javascript" src="/ckeditor/ckeditor.js"></script>
</head>

With the above file loaded, the CKEditor JavaScript API is ready to be used.

Attention: be sure to use the original file name ("ckeditor.js") when including it in your pages. If you instead want to use a different file name, or even merge the CKEditor script into another JavaScript file, then be sure to look at the Specifying the Editor Path page.

Step 2: Creating an Editor Instance

CKEditor works just like a textarea in your page. While the editor offers a user interface to easily write, format and work with rich text, the same thing could be achieved, not that easily, with a textarea, requiring the user to type HTML code inside of it.

But, as a matter of fact, CKEditor uses a textarea to transfer its data to the server. The textarea is invisible to the end user. So, to create and editor instance you must, ironically, create a textarea first:

<textarea name="editor1">&lt;p&gt;Initial value.&lt;/p&gt;</textarea>

Note that, if you want to load data into the editor, from a database for example, just put that data inside the textarea, just like the above example.

In this example, we have named our textarea "editor1". This name can be used in the server side later, when receiving the posted data.

Now, using the CKEditor JavaScript API, we "replace" the plain textarea with an editor instance. A single JavaScript call is needed for that:

<script type="text/javascript">
	CKEDITOR.replace( 'editor1' );
</script>

This script block must be included at any point "after" the <textarea> tag in the page. You can also call the replace function inside <head>, but you need to listen for the "window.onload" event in such case:

<script type="text/javascript">
	window.onload = function()
	{
		CKEDITOR.replace( 'editor1' );
	};
</script>

Step 3: Saving the Editor Data

As previously described, the editor works just like a <textarea> field. So, when submitting a form containing an editor instance, its data will be simply posted, using the textarea name as the key to retrieve it.

For example, following the above example, in PHP we would do something like this:

<?php
$editor_data = $_POST[ 'editor1' ];
?>

Client Side Data Handling

Some applications (like Ajax applications) need to handle all data at the client side, sending it to the server by its own ways. In such case, it's enough to use the CKEditor API to easily retrieve an editor instance data. For example:

<script type="text/javascript">
	var editor_data = CKEDITOR.instances.editor1.getData();
</script>

Complete Sample

<html>
<head>
	<title>Sample - CKEditor</title>
	<script type="text/javascript" src="/ckeditor/ckeditor.js"></script>
</head>
<body>
	<form method="post">
		<p>
			My Editor:<br />
			<textarea name="editor1">&lt;p&gt;Initial value.&lt;/p&gt;</textarea>
			<script type="text/javascript">
				CKEDITOR.replace( 'editor1' );
			</script>
		</p>
		<p>
			<input type="submit" />
		</p>
	</form>
</body>
</html>