CKEditor for Drupal/Installation - Revision history

Anna: Redirect created

2012-05-31T13:30:41Z

Redirect created

Anna: License article link added

2012-02-22T14:43:35Z

License article link added

Anna: Website link added

2012-02-22T13:37:38Z

Website link added

Wiktor: the id of element must be unique

2011-11-18T15:48:46Z

the id of <hide> element must be unique

Wiktor: modified headers

2011-11-17T12:49:55Z

modified headers

Wiktor: Added installation instruction for Drupal 6

2011-11-17T12:49:16Z

Added installation instruction for Drupal 6

Wiktor: Grantin permissions is optional in D7

2011-11-17T12:30:02Z

Grantin permissions is optional in D7

Wiktor: Added warning about text formats

2011-11-17T10:34:36Z

Added warning about text formats

Wiktor: /* Installing CKFinder */ Configuring CKFinder settings is optional

2011-11-17T09:19:47Z

‎Installing CKFinder: Configuring CKFinder settings is optional

Anna: Image with example added

2011-10-13T08:01:35Z

Image with example added

← Older revision		Revision as of 13:30, 31 May 2012
Line 1:		Line 1:
−	~~If you want to install CKEditor for Drupal, follow the steps described below.~~	+	#REDIRECT [[CKEditor_for_Drupal/Page_Moved]]
−
−	~~== Drupal 7 ==~~
−	* Download the installation package (<code>.zip</code> archive) from the [http://ckeditor.com/ckeditor-for-drupal official CKEditor for Drupal website].
−	* Unpack the contents of the installation package into the <code>drupal/sites/all/modules/ckeditor</code> directory.
−	* When the files are unpacked, you should see the following file structure inside the <code>drupal/sites/all/modules</code> directory:
−	~~<pre>~~
−	~~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~~
−	~~...~~
−	~~</pre>~~
−	* Enable the module in the '''Administration panel''' > '''Modules''' > '''User Interface''' section of your Drupal site.
−	* (Optional) Grant permissions for administering 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 as shown in the [[CKEditor_for_Drupal/~~License\|CKEditor for Drupal License]~~] ~~article. 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.<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.~~
−
−	~~[[Image:Drupal_CKEditor_example.png\|frame\|center\|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 (<code>sites/default/settings.php</code>) and do the following:
−	** Uncomment the <code>$base_url</code> variable and set the base URL of your website (without the trailing slash).
−	** Uncomment the <code>$cookie_domain</code> 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.
−
−	~~== Drupal 6 ==~~
−
−	* Download the installation package (<code>.zip</code> archive) from the [http://ckeditor.com/ckeditor-for-drupal official CKEditor for Drupal website].
−	* Unpack the contents of the installation package into the <code>drupal/sites/all/modules/ckeditor</code> directory.
−	* When the files are unpacked, you should see the following file structure inside the <code>drupal/sites/all/modules</code> directory:
−	~~<pre>~~
−	~~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~~
−	~~...~~
−	~~</pre>~~
−	* Enable the module in the '''Administration panel''' > '''Modules''' > '''User Interface''' section of your Drupal site.
−	* Grant permissions for using CKEditor to selected roles in the '''Administration panel''' > '''User management''' > '''Permissions''' section ('''ckeditor module''' > '''access ckeditor''').
−	* 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''' > '''Site configuration''' > '''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. '''Note:''' 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".<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="formats2">More...</hide>
−	~~<div id="formats2">~~
−	~~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>~~
−
−	~~That's it, you can now use CKEditor with its default settings on your Drupal website.~~
−
−	~~=== 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 "allow CKFinder file uploads" permission in the '''Administration panel''' > '''User management''' > '''Permissions''' section.
−	* Open the Drupal settings file (<code>sites/default/settings.php</code>) and do the following:
−	** Uncomment the <code>$base_url</code> variable and set the base URL of your website (without the trailing slash).
−	** Uncomment the <code>$cookie_domain</code> 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.

@@ Line 24: / Line 24: @@
 * Enable the module in the '''Administration panel''' > '''Modules''' > '''User Interface''' section of your Drupal site.
 * (Optional) Grant permissions for administering 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 as shown in the [[CKEditor_for_Drupal/License|CKEditor for Drupal License]] article. 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.<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>

@@ Line 2: / Line 2: @@
 == Drupal 7 ==
-* Download the installation package (<code>.zip</code> archive) from the official CKEditor for Drupal website.
+* Download the installation package (<code>.zip</code> archive) from the [http://ckeditor.com/ckeditor-for-drupal official CKEditor for Drupal website].
 * Unpack the contents of the installation package into the <code>drupal/sites/all/modules/ckeditor</code> directory.
 * When the files are unpacked, you should see the following file structure inside the <code>drupal/sites/all/modules</code> directory:
@@ Line 54: / Line 54: @@
 == Drupal 6 ==
-* Download the installation package (<code>.zip</code> archive) from the official CKEditor for Drupal website.
+* Download the installation package (<code>.zip</code> archive) from the [http://ckeditor.com/ckeditor-for-drupal official CKEditor for Drupal website].
 * Unpack the contents of the installation package into the <code>drupal/sites/all/modules/ckeditor</code> directory.
 * When the files are unpacked, you should see the following file structure inside the <code>drupal/sites/all/modules</code> directory:

@@ Line 78: / Line 78: @@
 * 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''' > '''Site configuration''' > '''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. '''Note:''' 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".<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>
+* Adjust CKEditor profiles in the '''Administration panel''' > '''Site configuration''' > '''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. '''Note:''' 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".<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="formats2">More...</hide>
-<div id="formats">
+<div id="formats2">
 Below is a short list of tags that can be created with CKEditor (form elements are not included in this list):
 <source lang="xml">

@@ Line 1: / Line 1: @@
 If you want to install CKEditor for Drupal, follow the steps described below.
-= Drupal 7 =
+== Drupal 7 ==
 * Download the installation package (<code>.zip</code> archive) from the official CKEditor for Drupal website.
 * Unpack the contents of the installation package into the <code>drupal/sites/all/modules/ckeditor</code> directory.
@@ Line 43: / Line 43: @@
-== Installing CKFinder ==
+=== 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.
@@ Line 52: / Line 52: @@
 * (Optional) Configure CKFinder settings in the '''File browser settings''' section for the CKEditor profile that you want to use.
-= Drupal 6 =
+== Drupal 6 ==
 * Download the installation package (<code>.zip</code> archive) from the official CKEditor for Drupal website.
@@ Line 92: / Line 92: @@
 That's it, you can now use CKEditor with its default settings on your Drupal website.
-== Installing CKFinder ==
+=== 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.

@@ Line 19: / Line 19: @@
        ckeditor.install
        ckeditor.module
-       ckeditor.styles.js
+       ...
 </pre>
 * 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.
 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.

@@ Line 45: / Line 45: @@
 ** Uncomment the <code>$base_url</code> variable and set the base URL of your website (without the trailing slash).
 ** Uncomment the <code>$cookie_domain</code> variable and set the domain name of your website.
-* Configure CKFinder settings in the '''File browser settings''' section for the CKEditor profile that you want to use.
+* (Optional) Configure CKFinder settings in the '''File browser settings''' section for the CKEditor profile that you want to use.