Built in File Browser

The editor comes with a default, generic, File Browser that is, for now, used by the Link and Image dialog windows (throw the "Browser Server" button). This File Browser offers a unique interface that can be used by all server side languages throw a "Connector" that is based on standard XML messages. The developer, when implementing FCKeditor on his site, can decide wich Connector to used based on his server capabilities and preferences.

Today, there are available Connectors for ASP, PHP and ASP.NET.

Configuring the Connector

All connectors available in the editor package can be found at the following folder: "editor/filemanager/browser/default/connectors". Each server side language has its own folder there, with the Connector file inside it. To choose witch connector to use, the developer just edit the configuration file and modify the following key (in this case for the Link Dialog box):

FCKConfig.LinkBrowserURL = FCKConfig.BasePath + "filemanager/browser/default/browser.html?Connector=connectors/aspx/connector.aspx" ;

The Connector path is relative to the "editor/filemanager/browser/default" folder. The user could even written his custom Connector and point the LinkBrowserURL to it, like "?Connector=/MyFolder/MyConnector.php " for example.

The same thing applies to the "ImageBrowserURL" configurations.

Configuring the Server Directory

All files handled by the editor point to a directory tree placed in the server side. In this way, all uploads and urls point to that tree.

This tree has a single Root directory that is called, by default, "/UserFiles/ ". You should create this folder on you web site to avoid problems with the File Browser.

In any case, it is possible to point the Root directory of your File Browser to any directory you want. For example, suppose I wan't my files on a "/Files/EditorFiles/" directory. I just need add an optional parameter to the "LinkBrowserURL" configuration string. This paramenter is called "ServerPath ". So, using our sample, the LinkBrowserURL string should be something like this:

FCKConfig.LinkBrowserURL = FCKConfig.BasePath + "filemanager/browser/default/browser.html?Connector=connectors/aspx/connector.aspx&ServerPath=/Files/EditorFiles/" ;

The same thing applies to the "ImageBrowserURL" configurations.