Ajaxfilemanager_XH - a CMSimple_XH Plugin

Ajaxfilemanager_XH is a replacement for the default filemanager of CMSimple_XH. It facilitates the management of files and sub-folders in the configured images, downloads, media and userfiles folders. You can rename, copy, move and delete sub-folders and files, create new sub-folders, and upload, download and preview files. Even editing of text files and images is integrated.

From CMSimple_XH 1.5 on Ajaxfilemanager_XH can be used from the editor to insert download links, images and media (currently tinyMCE and CKEditor are supported).

Please do read this documentation! Support might not be given otherwise. It's generally a good idea to read the documentation, before you encounter any problems!

Important Notice

Ajaxfilemanager_XH couldn't be tested so far in various environments. It is a so called BETA version. Use with caution!

Requirements

Ajaxfilemanager_XH is a plugin for CMSimple_XH. It requires a UTF-8 encoded version.

Installation

The installation is done slightly different as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.

  1. Backup the data on your server.
  2. Unzip the distribution on your computer.
  3. Upload the directories ajaxfilemanager/ and plugins/ to your server into the CMSimple_XH root directory.
  4. Set write permissions to ajaxfm/langs/ as well as the plugins/ajaxfilemanager/'s subdirectories config/, css/ and languages/.
  5. Switch to "Ajaxfilemanager" in the back-end to check if all requirements are fulfilled.
  6. To enable Ajaxfilemanager as default filebrowser for CMSimple ≥ 1.5, enter in Settings→CMS→Filebrowser→external: "ajaxfilemanager".

Settings

The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Ajaxfilemanager" from "Plugins".

You can change the default settings of Ajaxfilemanager_XH in "Plugin Config". Hints for the options will be displayed when hovering over the help icon with your mouse.

Localization is done in "Plugin Language". You can translate the character strings to your own language, or customize them according to your needs.

The look of the Ajaxfilemanager_XH can be customized in "Plugin Stylesheet". If you want to completely change the look of the Ajaxfilemanager widget, you should create a new theme in ajaxfilemanager/lib/themes/.

Usage

This plugin is used exclusively in CMSimple_XH's back-end. It's activated through the images, downloads, media and userfiles links of the admin menu or as filebrowser from the editor.

The usage should be pretty much self explaining, IOW intuitive. Note that there is a context menu available for folders and files; to activate a command make sure it's label is highlighted.

Limitations

Ajaxfilemanager_XH can't handle files and folders with non-ASCII characters in the name.

License

Ajaxfilemanager_XH is licensed under GPLv3.

© 2011-2012 Christoph M. Becker

Czech translation © 2011-2012 Josef Nemec
Slovak translation © 2012 Dr. Martin Sereday

Credits

This plugin is powered by the Ajax File Manager. Many thanks to Logan Cai, the developer of this great file manager, for releasing it under GPL license.

Ajaxfilemanager_XH was inspired by jerry. Thanks for pointing me to the Ajax File Manager.

The plugin icon is designed by Pavel Gucolav. Many thanks for making this icon freely available.

This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.

Many thanks to the community at the CMSimple forum for tips, suggestions and testing. Particularly I want to thank snafu for his early feedback, and of course, svasti for his thourough testing and extensive feedback, as well as Simmyne for reporting the problems with ModSecurity and testing of the fix.

And last but not least many thanks to all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.