PHP Connector for the FCKEditor v2 File Manager
Written By Grant French, Sept 2004
grant@mcpuk.net - http://www.mcpuk.net 

FCK Editor - Written By Frederico Caldeira Knabben
http://www.fckeditor.net 

Icons supplied for file types from everaldo - 
http://www.everaldo.com

Permissions fix for upload.cgu and fix for
thumbnail background colour by -
Ben Lancaster (benlanc@ster.me.uk)

!!PLEASE READ THROUGH THIS README *BEFORE* CRYING FOR HELP!!


NOTES:
------

This software is provided as is with no guarantees or
warranties what so ever. It has been tested under:-

PHP 4.3.3 / Apache 1.3.28 (OpenBSD 4.4)
PHP 4.3.3 / Apache 1.3.27 (WinXP Pro)
PHP 4.3.8 / Apache 1.3.31 (FreeBSD)
PHP 5.0.2 / Apache 2.0.50 (Linux)

Reported to work under IIS with minor alterations.
(Manually define $_SERVER['DOCUMENT_ROOT'] and dont use
the upload cgi)

!!! if you specify the relative path of the connector in 
	the fckconfig.js file you may experience some unusual
	behaviour mainly in firefox, like the resource list
	failing to refresh. To avoid this specify the absolute
	path of the connector.

	
	
SETUP FOR JUST CONNECTOR:
-------------------------

The php folder in this zip can go anywhere in the webroot.

(test script included, visit the testme.php file in the php folder
in your webbrowser, doesnt test file upload, thumbnail, deletefolder,
deletefile commands yet, but it may help find problems.)


PHP CONNECTOR CONFIGURATION:
----------------------------
the connector.php file must be referenced in the fckconfig.js file e.g.

Example Configuration (fckconfig.js)
------------------------------------

FCKConfig.LinkBrowserURL = 
	FCKConfig.BasePath + "filemanager/browser/default/browser.html?" +
	"Connector=" + FCKConfig.BasePath + "filemanager/browser/default/connectors/php/connector.php&" + 
	"UploadHandler=" + FCKConfig.BasePath + "filemanager/browser/default/connectors/php/Commands/helpers/upload.cgi" ;

FCKConfig.ImageBrowserURL = 
	FCKConfig.BasePath + "filemanager/browser/default/browser.html?Type=Image&" +
	"Connector=" + FCKConfig.BasePath + "filemanager/browser/default/connectors/php/connector.php&" + 
	"UploadHandler=" + FCKConfig.BasePath + "filemanager/browser/default/connectors/php/Commands/helpers/upload.cgi" ;

Please make sure you comment out or remove any other lines in the 
fckconfig.js starting with:
FCKConfig.ImageBrowserURL =
FCKConfig.LinkBrowserURL = 

in this case the php folder in this zip was placed in the 
filemanager/browser/default/connectors/ folder in the 
FCKEditor's base directory.


Upload Progress (PHP Connector)
-------------------------------
You may move the filemanager/browser/default/connectors/php/Commands/helpers/upload.cgi ,
filemanager/browser/default/connectors/php/Commands/helpers/progress.cgi and
filemanager/browser/default/connectors/php/Commands/helpers/header.cgi
to you cgi-bin folder or set the settings on the folder to allow these to be executed,
check the first line in each of these files to check that the path to perl is correct
for your setup. Open the header.cgi file, check and modify settings as required.
If you have moved these files adjust the path to them in the fckconfig lines as 
specified above and the path the progress.cgi in the config.php file (see below)


PHP Connector Config
---------------------
Then look at the config.php and customize it to your needs, 
it is fully comments so this should be quite simple.


FILE & FOLDER SETUP:
--------------------

1. Create the user files folder (set in the config.php) and 
	the following folders inside that:
		Image
		File
		Media
		Flash

2. Chmod each of these so they are writeable to the php processes user. 
	(if all else fails chmod 0777 them)



FINAL NOTE:
-----------

1. After testing it is recommended that you remove the testme.php file.
2. Limited support will be provided by email as and when i have time.
3. Think you could do a better job of the readme? Go on then...
4. If you have any ideas share them either by mailing me or in the 
	forum for the fckeditor (sf.net/projects/fckeditor/forums)


LICENSE:
--------

LGPL - Lesser General Public License (see LICENSE.txt file)
