Lucee Developer

Update March 19, 2011: version 2.1.0 is out! See the change list underneath.

I finally found time to update the coldfusion filemanager for the CKeditor 3. Check the long list of changes underneath! Also read the original blog post for more info on this filemanager.

I released the first versions in February/March 2010, as you can read in this blog post. Since publishing it, I noticed it had some user interface issues. These issues were mostly javascript-related, and were already existent in the original code by the Core Five labs. But nevertheless, they needed to be fixed.

Download

• Download the complete CKeditor with Coldfusion filemanager
• Browse all the files within subversion

Demo

With the risk of being completely spammed, I created a demo environment. It has some restrictions: images only, and all files are deleted within an hour.

Install

1. Download and unzip the package.

I will assume you unzipped it into your website's root folder.

2. Change the settings in file /ckeditor/filemanager/Application.cfm

Most of these settings will be good to go, but you can change whatever you like:

<cfset request.language = "en" /><!--- see directory 'lang' --->
<cfset request.maxFileSizeKB = 10000 /><!--- max. upload file size, in KiloBytes (1.000 KB = 1 MB) --->
<cfset request.onlyImageUploads = false />
<cfset request.allowedImageExtensions = "jpg,jpeg,gif,png" />
<!--- should we allow all files? If true, we do not check the extension. --->
<cfset request.allowAllFiles = false />
<cfset request.allowedExtensions = "zip,rar,psd,tif,gz,odf,odt,ods,txt,csv,pdf,doc,docx,xls,xlsx,ppt,pptx,odf,odt"
    & ",#request.allowedImageExtensions#" />
<!--- If a file is uploaded with a name which already exists, should we rename it or overwrite it? --->
<cfset request.uploadCanOverwrite = true />
<!--- the web path to the root upload directory --->
<cfset request.uploadWebRoot = "/uploads/" />
<!--- the absolute path to the root upload directory --->
<cfset request.uploadRootPath = expandPath(request.uploadWebRoot) />
<!--- In case you are using an alias named "uploadRoot" in Apache/IIS, pointing to a network share, your paths would look like this:
<cfset request.uploadWebRoot = "/uploadRoot/" />
<cfset request.uploadRootPath = "\\servername\share\imageuploads\" />
--->

Note: since version 2.1, all settings have moved to this one file. In previous versions, there was also /ckeditor/filemanager/filemanager.config.cfm and /ckeditor/filemanager/connectors/cfm/Application.cfm.

3. Change the function isAllowed() in /ckeditor/filemanager/Application.cfm

By default, this function allows interaction with the filemanager from everyone. Even if you put the ckeditor directory inside your cms system or other "protected area", then the filemanager will still be available to everyone, because it has it's own Application.cfm file.
Make sure that you do something with this function, to prevent unwanted access. For example:

Check for the existence of a specific cookie

<cfif structKeyExists(cookie, "userLoggedIn")><cfreturn true /><cfelse><cfreturn false /></cfif>

Or, when you use cflogin, include the Application.cfm/cfc from your website, and then check if the user isLoggedIn()

<cfinclude template="/Application.cfm" />
<cfif isUserLoggedIn()><cfreturn true /><cfelse><cfreturn false /></cfif>

Or check on IP address

<cfif cgi.remote_addr eq "123.45.67.89"><cfreturn true /><cfelse><cfreturn false /></cfif>

4. Check if everything is working

Go to http://yourwebsite.com/ckeditor/index.html, and test it!

In case something is not working, then you'd better install firebug in Firefox, open the filemanager, and check the Console tab of Firebug to see which request throws an error. That should give you a starting point to see what's really going on.

Also, you could check the exception log file of Coldfusion / Railo / Blue Dragon.

Change list: version 2.1

• Added support for network share storage
• merged setting files into one Application.cfm
• revised some internal functions (path checking etc.)
• fixed a bug with non-displayed error output when using Quick Upload (i.e. when uploading wrong file type, no error msg was returned)
• Error message "cannot declare local variable cfcatch twice" fixed

Change list: version 2.0

• Path of current location now has a max length of 50 chars. Otherwise, characters in the middle of the path are replaced with “...”.
• Header of the window now always fits (buttons sometimes fell underneath the rest of the page)
• Right-click context menu for directories does not have “download” option anymore, and the “Select” option now behaves as a single click on the directory.
• CfApplication has a new name, so multiple filemanagers can be used on the same website.
• When flushing the filemanager cache, an html message is displayed (instead of returning json formatted error).
• The filemanager now shows files and directories alphabetically in both the tree view and the grid view.
• Directory and file names starting with a dot are not returned in the file listings anymore.
• The filemanager now always shows the relative path (calculated from the uploadRoot) of the current directory/file as the main window's title.
• Newly added directories and files are now correctly shown and clickable in the tree view.
• A LOT of UI enhancements in the filemanager. For example, the tree view now always reflects the location of the grid view, and vice versa.
• Preview images are now shown with a max width/height of 350px.
• When renaming a file or directory, the UI now updates the new name everywhere correctly.

Change list: earlier versions

See the earlier blog post

Questions? Problems? Using it?

Let me know by adding a comment underneath!