Installation

Installing ImageManager 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 ImageManager PHP

ImageManager PHP requirements

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

If you want to use the image editing functionality you will need to have GD installed. The current recommended version is 2.0+. Some GD versions on Windows does not support GIF format editing, this can cause a problem with the editing functions of MCImageManager.

Installing it as a TinyMCE plugin

  1. Unpack the imagemanager and copy it to the tinymce plugins directory (tiny_mce/plugins/imagemanager).
  2. Add imagemanager to the TinyMCE init plugins option.
  3. Add insertimage to the list of buttons in the TinyMCE init options.
  4. Reload the page and verify that the imagemanager is working by checking for browse buttons inside the link and image dialogs.
  5. Configure the filesystem.rootpath config option by editing the config.php file (tiny_mce/plugins/imagemanager/config.php)
  6. Make sure that the configured rootpath has write access.
  7. Enable and integrate your CMS with the SessionAuthenticator or any other Authenticator implementation to make it secure. You can either use your own authentication script or set a username and password in the login_session_auth.php file. If you don't add username and password settings for ImageManager, any visitor to your website may be able to upload or delete any image they like.

(Note: You can turn off the Authenticator by setting the "authenticator" config 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 imagemanager and copy it to a desired directory on the web server for example /www/imagemanager
  2. Verify that the installation is working by pointing your browser to the path http://www.yoursite.com/imagemanager
  3. Add the mcimagemanager.js script to your page and add the mcImageManager.open call to any link. See the example page for details.
  4. Configure the filesystem.rootpath config option by editing the config.php file (imagemanager/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 ImageManager .NET

ImageManager .NET requirements

Installing it as a TinyMCE plugin

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

Installing it as a standalone application

  1. Unpack the imagemanager and copy it to a desired directory on the web server for example /www/imagemanager
  2. Copy the dll files from imagemanager/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/imagemanager
  4. Add the mcimagemanager.js script to your page and add the mcImageManager.open call to any link. See the example page for details.
  5. Configure the filesystem.rootpath config option by editing the Web.config file (imagemanager/Web.config)
  6. Make sure that the configured rootpath has write access.

Visual Studio

If you are using MCImageManager 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 MCImageManager product you should first consult the FAQ but you can always ask us to help you at the forums.