Installation"

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.

(→‎Installing CKFinder: Configuring CKFinder settings is optional)
(Added warning about text formats)
Line 19: Line 19:
 
       ckeditor.install
 
       ckeditor.install
 
       ckeditor.module
 
       ckeditor.module
−
       ckeditor.styles.js
+
       ...
−
      ckeditor-rtl.css
 
−
      license.html
 
−
      README.txt
 
−
      TROUBLESHOOTING.txt
 
−
      UPGRADE.txt
 
−
  ...
 
 
</pre>
 
</pre>
 
* Enable the module in the '''Administration panel''' > '''Modules''' > '''User Interface''' section of your Drupal site.
 
* Enable the module in the '''Administration panel''' > '''Modules''' > '''User Interface''' section of your Drupal site.
 
* Grant permissions for using CKEditor in the '''Administration panel''' > '''People''' > '''Permissions''' section.
 
* Grant permissions for using CKEditor in the '''Administration panel''' > '''People''' > '''Permissions''' section.
 
* Add your license name and key by editing the Global Profile in the '''Administration panel''' > '''Configuration''' > '''Content Authoring''' > '''CKEditor''' > '''Global settings''' section. CKEditor will now run in licensed mode.
 
* Add your license name and key by editing the Global Profile in the '''Administration panel''' > '''Configuration''' > '''Content Authoring''' > '''CKEditor''' > '''Global settings''' section. CKEditor will now run in licensed mode.
−
* Adjust CKEditor profiles in the '''Administration panel''' > '''Configuration''' > '''Content Authoring''' > '''CKEditor''' section. Profiles determine which options are available to users based on the input format system.
 
 
* If you want to enable CKFinder, an advanced Ajax file browser, see the '''Installing CKFinder''' section below.
 
* If you want to enable CKFinder, an advanced Ajax file browser, see the '''Installing CKFinder''' section below.
 +
* Adjust CKEditor profiles in the '''Administration panel''' > '''Configuration''' > '''Content Authoring''' > '''CKEditor''' section. Profiles determine which options are available to users based on the input format system.<br><warning />Certain Text formats (e.g. <code>Filtered HTML</code>) limit allowed HTML tags, so after saving the content you many notice that some tags created with CKEditor are removed. The list of allowed HTML tags can be configured in '''Administration panel''' > '''Configuration''' > '''Content authoring''' > '''Text formats'''. <hide target="formats">More...</hide>
 +
<div id="formats">
 +
Below is a short list of tags that can be created with CKEditor (form elements are not included in this list):
 +
<source lang="xml">
 +
      <a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr>
 +
      <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tbody> <th> <tr> <td> <em> <b> <u> <i> <strong>
 +
      <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code>
 +
      <cite> <embed> <object> <param> <strike> <caption> <iframe>
 +
</source>
 +
<strong>Note:</strong> be careful when granting users access to create tags like <code><iframe></code>.
 +
</div>
  
 
You can now use CKEditor with its default settings on your Drupal website, like in the figure below, or [[CKEditor_for_Drupal/Configuration|customize it to your needs]] if required.
 
You can now use CKEditor with its default settings on your Drupal website, like in the figure below, or [[CKEditor_for_Drupal/Configuration|customize it to your needs]] if required.

Revision as of 12:34, 17 November 2011

If you want to install CKEditor for Drupal, follow the steps described below.

  • Download the installation package (.zip archive) from the official CKEditor for Drupal website.
  • Unpack the contents of the installation package into the drupal/sites/all/modules/ckeditor directory.
  • When the files are unpacked, you should see the following file structure inside the drupal/sites/all/modules directory:
modules                <dir>
   ...
   ckeditor            <dir>
      ckeditor         <dir>
      ckfinder         <dir>
      images           <dir>
      includes         <dir>
      plugins          <dir>
      changelog.html
      ckeditor.api.php
      ckeditor.css
      ckeditor.info
      ckeditor.install
      ckeditor.module
      ...
  • Enable the module in the Administration panel > Modules > User Interface section of your Drupal site.
  • Grant permissions for using CKEditor in the Administration panel > People > Permissions section.
  • Add your license name and key by editing the Global Profile in the Administration panel > Configuration > Content Authoring > CKEditor > Global settings section. CKEditor will now run in licensed mode.
  • If you want to enable CKFinder, an advanced Ajax file browser, see the Installing CKFinder section below.
  • Adjust CKEditor profiles in the Administration panel > Configuration > Content Authoring > CKEditor section. Profiles determine which options are available to users based on the input format system.
    important noteCertain Text formats (e.g. Filtered HTML) limit allowed HTML tags, so after saving the content you many notice that some tags created with CKEditor are removed. The list of allowed HTML tags can be configured in Administration panel > Configuration > Content authoring > Text formats.

Below is a short list of tags that can be created with CKEditor (form elements are not included in this list): 

<a> <p> <span> <div> <h1> <h2> <h3> <h4> <h5> <h6> <img> <map> <area> <hr>
      <br> <br /> <ul> <ol> <li> <dl> <dt> <dd> <table> <tbody> <th> <tr> <td> <em> <b> <u> <i> <strong>
      <del> <ins> <sub> <sup> <quote> <blockquote> <pre> <address> <code>
      <cite> <embed> <object> <param> <strike> <caption> <iframe>

Note: be careful when granting users access to create tags like <iframe>.

You can now use CKEditor with its default settings on your Drupal website, like in the figure below, or customize it to your needs if required.

A basic page created with CKEditor for Drupal


Installing CKFinder

CKFinder is an Ajax-based file manager created by CKEditor developers: http://ckfinder.com/. It is already included in your licensed CKEditor for Drupal module, so all you need to do is enable it in the Drupal administration panel.

  • Grant the "CKFinder access" permission in the Administration panel > People > Permissions section.
  • Open the Drupal settings file (sites/default/settings.php) and do the following:
    • Uncomment the $base_url variable and set the base URL of your website (without the trailing slash).
    • Uncomment the $cookie_domain variable and set the domain name of your website.
  • (Optional) Configure CKFinder settings in the File browser settings section for the CKEditor profile that you want to use.
Retrieved from "https://docs-old.ckeditor.com/index.php?title=CKEditor_for_Drupal/Installation&oldid=6650"