Difference between revisions of "Template:Drupal OS 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.

(Template contents part 4 added)
m (Minor formatting changes)
 
(2 intermediate revisions by the same user not shown)
Line 37: Line 37:
  
 
[[Image:Drupal_7_OS_grant_permissions.png|frame|center|Granting permission to use CKEditor in the Drupal 7 Administration Panel]] | }}
 
[[Image:Drupal_7_OS_grant_permissions.png|frame|center|Granting permission to use CKEditor in the Drupal 7 Administration Panel]] | }}
 +
{{#ifeq: {{{version}}} | 6 |You will now need to grant permissions for using CKEditor to selected roles in the '''Administration panel''' > '''User management''' > '''Permissions''' section. Scroll to the '''ckeditor module''' section and select the checkbox next to the '''access ckeditor''' permission for the roles that you want to grant this permission to.
 +
 +
[[Image:Drupal_6_OS_grant_permission.png|frame|center|Granting permission to use CKEditor in the Drupal 6 Administration Panel]]| }}
  
  
 
You can now enter the configuration of your CKEditor for Drupal module by visiting the '''Administration panel''' > '''{{{path1}}}''' > '''CKEditor''' section. If you want to enable [http://ckfinder.com CKFinder], an advanced Ajax file browser, see the [[CKEditor_for_Drupal/Open Source/Drupal_{{{version}}}/CKFinder|Installing CKFinder]] article.
 
You can now enter the configuration of your CKEditor for Drupal module by visiting the '''Administration panel''' > '''{{{path1}}}''' > '''CKEditor''' section. If you want to enable [http://ckfinder.com CKFinder], an advanced Ajax file browser, see the [[CKEditor_for_Drupal/Open Source/Drupal_{{{version}}}/CKFinder|Installing CKFinder]] article.
  
−
You should now adjust CKEditor profiles in the '''Administration panel''' > '''{{{path1}}}''' > '''CKEditor''' section. Profiles determine which options are available to users based on system-wide roles. In each profile you can choose which textareas will be replaced by CKEditor, select a default toolbar, and configure some more advanced settings.
+
You should now adjust CKEditor profiles in the '''Administration panel''' > '''{{{path1}}}''' > '''CKEditor''' section. Profiles determine which options are available to users based on system-wide roles. In each profile you can choose which textareas will be replaced by CKEditor, select a default toolbar, and configure some more advanced settings. {{#ifeq: {{{version}}} | 6 |Please note that User 1 must be assigned a system role that corresponds to the privileges required. If no role is assigned to User 1, they will have the privileges of "authenticated user".| }}
  
 
<note>Certain text formats (e.g. <code>Filtered HTML</code>) limit allowed HTML tags, so after saving the content you may notice that some tags created with CKEditor are removed. The list of allowed HTML tags can be configured in the '''Administration panel''' > '''{{{path2}}}'''. <hide target="formats2">More...</hide>
 
<note>Certain text formats (e.g. <code>Filtered HTML</code>) limit allowed HTML tags, so after saving the content you may notice that some tags created with CKEditor are removed. The list of allowed HTML tags can be configured in the '''Administration panel''' > '''{{{path2}}}'''. <hide target="formats2">More...</hide>

Latest revision as of 12:47, 30 May 2012

important note
These instructions assume that you install the CKEditor for Drupal module in the sites/all/modules directory (recommended). If you want to use the sites/all/libraries/ directory, you will need to adjust the paths given in the instructions accordingly.


If you want to install the CKEditor module on your Drupal {{{version}}} site, follow the steps described below.

First of all, download the installation package (.zip or tar.gz archive) for Drupal {{{version}}} from the official CKEditor for Drupal module site at drupal.org.

Unpack the contents of the installation package into the drupal/sites/all/modules 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>
      images           <dir>
      includes         <dir>
      plugins          <dir>
      changelog.txt
      ckeditor.api.php
      ckeditor.css
      ckeditor.info
      ckeditor.install
      ckeditor.module
      ...

Download standalone CKEditor from http://ckeditor.com/download. Unpack the contents of the ckeditor directory from the installation package to the sites/all/modules/ckeditor/ckeditor (or sites/all/libraries/ckeditor) directory.

important note
You can skip uploading the _samples and _source folders. See the Minimum Setup article for some more tips regarding the minimum required CKEditor setup.


Go to the Administration Panel of your Drupal {{{version}}} site and choose the Modules option from the Site Building section. Scroll down to the User interface section and select the checkbox next to the CKEditor module name.

[[Image:Drupal_{{{version}}}_Enterprise_enable_module.png|frame|center|Enabling the CKEditor module in the Drupal {{{version}}} Administration Panel]]




You can now enter the configuration of your CKEditor for Drupal module by visiting the Administration panel > {{{path1}}} > CKEditor section. If you want to enable CKFinder, an advanced Ajax file browser, see the [[CKEditor_for_Drupal/Open Source/Drupal_{{{version}}}/CKFinder|Installing CKFinder]] article.

You should now adjust CKEditor profiles in the Administration panel > {{{path1}}} > CKEditor section. Profiles determine which options are available to users based on system-wide roles. In each profile you can choose which textareas will be replaced by CKEditor, select a default toolbar, and configure some more advanced settings.

important note

Certain text formats (e.g. Filtered HTML) limit allowed HTML tags, so after saving the content you may notice that some tags created with CKEditor are removed. The list of allowed HTML tags can be configured in the Administration panel > {{{path2}}}.

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>.


In order to have better control over line breaks, you may disable the line break converter for a given text format in the Administration panel > {{{path2}}} section (recommended).

The CKEditor installation and basic configuration process is now finished. You can start to use CKEditor with its default settings on your Drupal {{{version}}} website.

Retrieved from "https://docs-old.ckeditor.com/index.php?title=Template:Drupal_OS_Installation&oldid=7062"
This page was last edited on 30 May 2012, at 12:47.