hi_KCFinder-Plugin

The bridge between CMSimple(_XH) and Pavel Tzonkovs KCfinder web file manager.

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

This plugin is free to use on your own on website - commercial or non-commercial. Professional web-designer who are planning to deliver it as part of their service to their customers, are advised to contact me for a reseller license!
Only this way I'll be able to contribute you and the CMSimple-Community with this and other new plugins.

But anyway, If you like this plugin, or using it in a commercial scope,
consider donating a few bucks to me via PayPal:l donation via paypal !

Features

• replaces the default CMSimple file administration with KCfinder
• usable with FCKeditor (integration-file available), CKeditor and TinyMCE
  
• ready to use with other plugins

KCFinder-Features

• Ajax engine with XML responses
• Select multiple files with the Ctrl/Command key
• Download multiple files or a folder as single ZIP file
• Clipboard for copying and moving multiple files (only inside a folder-tree)
• Resize bigger uploaded images. Configurable maximum image resolution
• Configurable thumbnail resolution. Thumnails selectable in WYSIWYG-Editors
• Visual CSS themes
• Multilanguage system
  

Requirements

CMSimple

• CMSimple or CMSimple_XH with a working Pluginloader. Recommended Pluginloader-Version is >= 2.1)
• The plugin is written and tested for CMSimple_XH from version 1.4. It my run with older versions too.
• The new folderstructure of CMSimple_XH must be accessible (create a folder /userfiles in the
  same level as /images and /downloads if not already present).
  The thumbnails were created in the folder /image/.thumbs (the plugin will create this folder subfolder)
• hi_KCFinder can't run together with "File Administration" plugin from http://cmsimpleplugins.jakobsfeld.dk/ since it's a replacement of it.

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.
• Do a "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]
       • ...
       • [pluginloader]
       • [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. You're ready to use the plugin! There is no need to activate something by scripting, since it just consist of an backend.
   Click on the link "Images" or "Downloads" to enter to the new filebrowser.

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

In CMSimple_XH, there are hints for every configuration option 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

The bridge is ready to include KCfinder to compatible WYSIWYG-Editors.
For incusion, you need a special prepared include file, named the same as the editor name.
For FCKeditor, the default editor in CMSimple_XH, is a include file available from the project-page.
Please visit http://CMSimple.HolgerIrmler.de for details.

Acknowledgment

KCFinder is written by Pavel Tzonkovs 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.