Template:Drupal OS CKFinder - Revision history

J.swiderski at 12:08, 19 September 2018

2018-09-19T12:08:22Z

Anna at 13:03, 14 July 2015

2015-07-14T13:03:05Z

J.swiderski at 12:59, 14 July 2015

2015-07-14T12:59:54Z

Anna: Path corrected

2012-05-31T12:32:20Z

Path corrected

Anna: Path corrected

2012-05-31T12:29:16Z

Path corrected

Anna: Template contents added

2012-05-31T12:16:32Z

Template contents added

New page

CKFinder is an Ajax-based file manager created by CKEditor developers: http://ckfinder.com/. CKFinder support is already built into the CKEditor for Drupal module, but due to licensing issues you need to buy it separately, add the files to your Drupal site and then enable the file browser.

<note>If you are looking for a simplified solution, try the [http://ckeditor.com/ckeditor-for-drupal Enterprise version of the module] that comes with a CKFinder license and the file browser already included in the module and working out-of-the-box. The Enterprise version of the component also includes professional assistance from the original CKEditor development team in the form of a '''dedicated e-mail support channel'''.</note>

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

First of all, download '''CKFinder for PHP''' from the [http://ckfinder.com/download official CKFinder website].

Unpack the contents of the installation package into the directory that contains the CKEditor module and place it in the <code>sites/all/modules/ckeditor/ckfinder</code> (or <code>sites/all/libraries/ckfinder</code>) folder. . When the files are unpacked, you should see the following file structure inside the <code>drupal/sites/all/modules</code> directory:
<source>
modules <dir>
ckeditor <dir>
ckeditor.css
ckeditor.info
...
ckeditor <dir>
_samples <dir>
_source <dir>
adapters <dir>
images <dir>
...
ckeditor.js
...
ckfinder <dir>
_samples <dir>
core <dir>
...
ckfinder.js
ckfinder.php
...
</source>

You will now need to grant the '''"{{{permission}}}"''' permission in the '''Administration panel''' > '''{{{path1}}}''' > '''Permissions''' section. Note: if you do not see this permission, it means that CKEditor did not find CKFinder and you have probably uploaded CKFinder into a wrong directory.

[[Image:Drupal_{{{version}}}_Enterprise_CKFinder_permission.png|frame|center|Granting CKFinder access permission in the Drupal Administration panel]]

Now open the CKFinder configuration file (<code>ckfinder/config.php</code>) and introduce the code changes described below.

Firstly, remove the <code>CheckAuthentication()</code> function (do not worry, this function is defined in <code>filemanager.config.php</code>, see below):
<source lang="php">
function CheckAuthentication() <- remove it
{ <- remove it
//WARNING : DO NOT simply... <- remove it
... <- remove it
return false; <- remove it
} <- remove it
</source>
For CKFinder installed in the <code>sites/all/modules/ckeditor/ckfinder</code> directory add:
<source lang="php">
require_once '../../../../includes/filemanager.config.php';
</source>
straight below the following line:
<source lang="php">
$baseDir = resolveUrl($baseUrl);
</source>
For CKFinder installed in the <code>sites/all/libraries/ckfinder</code> directory add:
<source lang="php">
require_once '../../../includes/filemanager.config.php';
</source>
straight below the following line:
<source lang="php">
$baseDir = resolveUrl($baseUrl);
</source>

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

Select CKFinder as a preferred file browser in the '''Administration panel''' > '''{{{path2}}}''' > '''CKEditor''' section (for a selected CKEditor profile scroll down to the '''File browser settings''' section).

[[Image:Drupal_{{{version}}}_OS_enable_CKFinder.png|frame|center|Selecting CKFinder as a preferred file browser in the Drupal Administration panel]]

You can now [[CKEditor_for_Drupal/Open Source/Drupal_{{{version}}}/Configuration|configure]] CKFinder settings in the '''File browser settings''' section for the CKEditor profile that you want to use. You may also change destination folders for files uploaded with CKFinder.

@@ Line 1: / Line 1: @@
 CKFinder is an Ajax-based file manager created by CKEditor developers: http://ckfinder.com/. CKFinder support is already built into the CKEditor for Drupal module, but due to licensing issues you need to buy it separately, add the files to your Drupal site and then enable the file browser.
-<note>The instructions below are valid for '''CKFinder 2.x only'''. The CKEditor module as well as its documentation will be adjusted to new CKFinder 3.x soon.</note>
+<note>The instructions below are valid for '''CKFinder 2.x only'''.</note>
 <note>If you are looking for a simplified solution, try the [http://ckeditor.com/ckeditor-for-drupal Enterprise version of the module] that comes with a CKFinder license and the file browser already included in the module and working out-of-the-box. The Enterprise version of the component also includes professional assistance from the original CKEditor development team in the form of a '''dedicated e-mail support channel'''.</note>

@@ Line 1: / Line 1: @@
 CKFinder is an Ajax-based file manager created by CKEditor developers: http://ckfinder.com/. CKFinder support is already built into the CKEditor for Drupal module, but due to licensing issues you need to buy it separately, add the files to your Drupal site and then enable the file browser.
-<note>Below instructions are valid for '''CKFinder 2.x only'''. Module as well as documentation will be adjusted to new CKFinder 3.x soon.</note>
+<note>The instructions below are valid for '''CKFinder 2.x only'''. The CKEditor module as well as its documentation will be adjusted to new CKFinder 3.x soon.</note>
 <note>If you are looking for a simplified solution, try the [http://ckeditor.com/ckeditor-for-drupal Enterprise version of the module] that comes with a CKFinder license and the file browser already included in the module and working out-of-the-box. The Enterprise version of the component also includes professional assistance from the original CKEditor development team in the form of a '''dedicated e-mail support channel'''.</note>

@@ Line 59: / Line 59: @@
 For CKFinder installed in the <code>sites/all/libraries/ckfinder</code> directory add:
 <source lang="php">
-require_once '../../../../../includes/filemanager.config.php';
+require_once '../../../../../modules/ckeditor/includes/filemanager.config.php';
 </source>
 straight below the following line: