MCImageManager:Installation

From Moxiecode Documentation Wiki

Contents 1 Installation instructions 2 Installing ImageManager PHP 2.1 ImageManager PHP requirements 2.2 Installing it as a TinyMCE plugin 2.3 Installing it as a standalone application 2.4 Setting write access 3 Installing ImageManager .NET 3.1 ImageManager .NET requirements 3.2 Installing it as a TinyMCE plugin 3.3 Installing it as a standalone application 3.4 Setting write access 4 Troubleshooting

Installation instructions

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 the imagemanager to the TinyMCE init option called plugins.
3. Reload the page and verify that the imagemanager 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/imagemanager/config.php)
5. Make sure that the configured file path has write access.
6. Enable and integrate your CMS with the SessionAuthenticator or any other Authenticator implementation to make it secure.

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 (tiny_mce/plugins/imagemanager/config.php)
5. Make sure that the configured file path 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

• Internet Information Services 4+
• Microsoft .NET Framework Version 1.1 Redistributable Package or newer

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 the imagemanager to the TinyMCE init option called plugins.
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 Web.config file (tiny_mce/plugins/imagemanager/Web.config)
6. Make sure that the configured file path 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 (tiny_mce/plugins/imagemanager/Web.config)
6. Make sure that the configured file path has write access.

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.