hi_KCFinder-Plugin

The bridge between CMSimple_XH and Pavel Tzonkovs KCfinder web file manager.

© 2014 Holger Irmler, http://CMSimple.HolgerIrmler.de.

Features

• replaces the default file administration in CMSimple_XH with KCfinder
  
• usable with CKeditor, TinyMCE 3.x and TinyMCE 4.x
  
• ready to use with other plugins

KCFinder-Features

• Ajax engine with JSON responses
• Multiple files upload
• Upload files using HTML5 drag and drop
• Download multiple files or a folder as single ZIP file
• Select multiple files with the Ctrl/Command key
• Clipboard for copying, moving and downloading multiple files
• Resize uploaded images. Configurable maximum image resolution
• Configurable thumbnail resolution
• Visual CSS themes
• Multilanguage system
• Slideshow using arrow keys

Requirements

CMSimple_XH

• CMSimple_XH 1.6+
• It will not run with older versions (use hi_kcfinder 1.6 instead)
• CMSimple 4.x is not supported this time because of too much incompatibilities.
  You may drop me a line, if you need a version for CMSimple 4.x.
  Depending on interest, I'll consider to release a 4.x-Edition of the plugin.

Server

• KCFinder is officialy tested on Apache 2 web server only. Probably it will works on other web servers
• Only PHP5 server-side scripting is supported. Min. PHP-Version 5.1.0 with GD extension is required and safe mode should be off. To work with client-side HTTP cache, the PHP must be installed as Apache module.
• PHP ZIP extension must be loaded in order to have ability downloading multiple files and directories as single ZIP file.
• Refer to the "System-Check" in the plugin backend if you have trouble running this plugin.

Browser

• Browser side code requires modern browser supporting CSS3.
  KCFinder does not work in Internet Explorer 6.

Installation

1. Always make a backup of your installation before adding a new plug-in.
2. Unzip the archive and copy the files and folders into your plugins-folder.

   It should look like this:

   • [Root]
     • [(2lang)]
     • [cmsimple]
     • ...
     • [plugins]
       • ...
       • [hi_kcfinder]
         • [config]
         • [css]
         • [help]
         • [kcfinder]
         • [languages]
         • admin.php
         • index.php
       • admin.php
       • index.php
       • kcfinder_init.php
       • license.txt
       • version.nfo
     • [...]
     • index.php

The file plugins/hi_kcfinder/config/config.php needs to be set writable.

(To edit the languages online do the same with the language files in plugins/hi_kcfinder/languages.)

3. Login and click on "Settings -> CMS -> Filebrowser -> External:",
   enter hi_kcfinder to activate the plugin.

Configuration

1. Login to your CMSimple site
2. Select the "hi_kcfinder-Plugin" from the list of available plugins
3. Click on "Plugin Config" to view or edit the configuration settings

There are hints for the configuration options available, if you hover with your mouse over the little blue questionmark.

Please take care on correct settings. Normally the default configuration should be usable for most servers.

How to use together with a WYSIWYG-Editor

If hi_kcfinder is configured as external filebrowser, it will work with any compatible editor without further configuration.

Acknowledgment

KCFinder is written by Pavel Tzonkov and dual-licensed unde GPLv2 & LGPLv2

Plugin-License

For the detailed plugin-license please refer to the shipped license.txt.

Need help?

... visit cmsimpleforum.com.

 THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED 
 IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND,
 EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
 FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
 THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.