CKEditor for ASP.NET Installation Guide

What Is CKEditor?

CKEditor is an online WYSIWYG rich text editor that can be embedded inside web pages. It is not a replacement for desktop word processors like Microsoft Word or OpenOffice Writer, but a component to be used as a part of web applications and websites. For more information on CKEditor refer to the product website.

Integrating CKEditor for ASP.NET with Your Page

If you want to integrate CKEditor with your ASP.NET page, follow the steps outlined below.

  1. Go to the official CKEditor download site and download the latest versions of both CKEditor 3.x and the CKEditor for ASP.NET Control.
  2. Unpack both installation packages to a desired location.
  3. Add a reference to the CKEditor for ASP.NET Control to your website.
    In Visual Studio use the Add Reference command and browse to the bin\Release\CKEditor.NET.dll file from the unpacked CKEditor for ASP.NET installation package. You can also manually copy the DLL file to the bin folder of your application.
  4. Copy the unpacked editor files from the CKEditor 3.x installation package and paste them into the application directory of your website.
  5. Register the CKEditor for ASP.NET Control in your page: 
    <%@ Register Assembly="CKEditor.NET" Namespace="CKEditor.NET" TagPrefix="CKEditor" %>
  6. Insert a CKEditor instance into the page body: 
    <CKEditor:CKEditorControl ID="CKEditor1" runat="server"></CKEditor:CKEditorControl>
  7. Run the ASP.NET application and open the page in the browser. A CKEditor instance should be added to the page.

CKEditor for ASP.NET Samples

The CKEditor for ASP.NET installation package comes with a few sample pages that can be used to try out the ASP.NET control. In order to view the working samples in your browser, proceed as follows (all instructions refer to Windows 7 and IIS):

  1. Unpack the _samples folder of the CKEditor for ASP.NET Control installation package to C:\inetpub\wwwroot.
    If you do not have this folder in your system, you need to install Internet Information Services first.
  2. Go to Control Panel –> System and Security –> Administrative Tools –> Internet Information Services (IIS) Manager. Find the _samples folder under the Default Web Site tree.
  3. Right-click the _samples folder and select Convert to application.
  4. From the Browse Application menu on the right-hand side choose Browse *:80 (http).
  5. The application will open in your default Internet browser. You can now browse the samples to see the CKEditor for ASP.NET Control at work.

Documentation

The full CKEditor for ASP.NET Control documentation is available online under the following address:
http://docs.cksource.com/CKEditor.NET