Installation

Installing FileManager is a quite simple process but it's slightly different depending on if you want to use it together with TinyMCE or in as a standalone component.

Installing FileManager PHP

FileManager PHP requirements

  • Apache 1.3+, IIS 4 or other web server capable of running PHP
  • PHP 4.3+ script language used by the FileManager.

Installing it as a TinyMCE plugin

  1. Unpack the filemanager and copy it to the tinymce plugins directory (tiny_mce/plugins/filemanager).
  2. Add the filemanager to the TinyMCE init option called plugins.
  3. Reload the page and verify that the filemanager is working by checking for browse buttons inside the link and image dialogs.
  4. Configure the filesystem.rootpath config option by editing the config.php file (tiny_mce/plugins/filemanager/config.php)
  5. Make sure that the configured rootpath has write access.
  6. Enable and integrate your CMS with the SessionAuthenticator or any other Authenticator implementation to make it secure.

(Note: You can turn off the Authenticator by setting the "authenticator" option to nothing, empty string, but this is not recommended unless there is some other protection, this is the same thing as leaving the keys in your car while away, anyone can access and upload files to your website.)

Installing it as a standalone application

  1. Unpack the filemanager and copy it to a desired directory on the web server for example /www/filemanager
  2. Verify that the installation is working by pointing your browser to the path http://www.yoursite.com/filemanager
  3. Add the mcfilemanager.js script to your page and add the mcFileManager.open call to any link. See the example index.html page that is in the root folder for more details.
  4. Configure the filesystem.rootpath config option by editing the config.php file (filemanager/config.php)
  5. Make sure that the configured rootpath has write access.
  6. Enable and integrate your CMS with the SessionAuthenticator or any other Authenticator implementation to make it secure.

Setting write access

You need to make sure that the specified filesystem.rootpath is writable by PHP and Apache, this can normally be done using a FTP client or a SSH shell. Remember if you are using safe mode the user and group must also match not only the access rights.

Installing FileManager .NET

FileManager .NET requirements

Installing it as a TinyMCE plugin

  1. Unpack the filemanager and copy it to the tinymce plugins directory (c:/inetpub/wwwroot/js/tiny_mce/plugins/filemanager).
  2. Copy the dll files from filemanager/bin to your sites root bin (c:/inetpub/wwwroot/bin)
  3. Add the filemanager to the TinyMCE init option called plugins.
  4. Reload the page and verify that the filemanager is working by checking for browse buttons inside the link and image dialogs.
  5. Configure the filesystem.rootpath config option by editing the Web.config file. (c:/inetpub/wwwroot/js/tiny_mce/plugins/filemanager/Web.config)
  6. Make sure that the configured rootpath has write access.

Installing it as a standalone application

  1. Unpack the filemanager and copy it to a desired directory on the web server for example /www/filemanager
  2. Copy the dll files from filemanager/bin to your sites root bin for example c:/inetpub/wwwroot/bin
  3. Verify that the installation is working by pointing your browser to the path http://www.yoursite.com/filemanager
  4. Add the mcfilemanager.js script to your page and add the mcFileManager.open call to any link. See the example page for details.
  5. Configure the filesystem.rootpath config option by editing the Web.config file (filemanager/Web.config)
  6. Make sure that the configured rootpath has write access.

Visual Studio

If you are using MCFileManager with Visual studio, exclude the SRC directory from compiling/building your project.

Setting write access

Some hosting companies don't provide write access to the wwwroot by default. So you might need to add write access for the "files" directory or the directory you configured in the filesystem.rootpath option. For PHP you need to chmod the directory with the write bit for the owner and group and for .NET you need to add the NETWORK_SERVICE user and make sure that it has "Modify" permissions. It might also be a good idea to add write access to the "js/_cache" directory since it will write cached files there, but this is not required but it will reduce the workload for the server.

Troubleshooting

If you have problems installing or integrating the MCFileManager product you should first consult the FAQ but you can always ask us to help you at the forums.