This article describes how to get CKFinder up and running by adjusting some basic settings.
The CheckAuthentication() Function
By default, CKFinder will not work due to authentication restrictions. You must first make sure that you have configured it correctly, and then enable it.
Once you have completely configured CKFinder, you are ready to enable it for use. The CheckAuthentication() function is used for that. In this function you must implement the code ensuring that the requests are coming from an authenticated user. This is usually done by assigning a session variable when the user logs into your system.
If the user is properly authenticated, the fuction should return true. We strongly recommend you to NOT simply return true from this function without implementing authentication checks. Without authentication support anonymous users would be able to use CKFinder on your website, including uploading and deleting files from your server.
The following is a sample implementation of the CheckAuthentication() function:
License
If you purchased CKFinder, you should put your license key in the config.xml file:
<licenceKey>put your license name here</licenceKey> <licenceName>put your license key here</licenceName>
If you leave these fields blank, CKFinder will be fully functional, but it will be running in demonstration mode.
baseURL
The baseURL is the base path used to build the final URL for the resources handled by CKFinder.
Examples:
<baseURL>/userfiles/</baseURL> <baseURL>http://example.com/ckfinder/files/</baseURL>
If you leave this field empty, the default value (/userfiles/) will be used.
Please note that the trailing slash is required.
baseDir
The baseDir is the path to the local directory (on the server) which points to the baseURL URL described above. This is the path used by CKFinder to handle the files on the server. Full write permissions must be granted to this directory.
You may point it to a directory directly:
<baseDir>/home/login/public_html/ckfinder/files/</baseDir> <baseDir>C:/SiteDir/CKFinder/userfiles/</baseDir>
Or you may let CKFinder discover the path based on baseURL:
<baseDir></baseDir>
by leaving the baseDir value empty.
Bear in mind that CKFinder will only discover the path, when the base URL is a local Web path (relative to document root). Example:
<baseURL>/userfiles/</baseURL>
If it is a full URL address, like the following one:
<baseURL>http://example.com/ckfinder/files/</baseURL>
the path will not be discovered.
Please note that the trailing slash is required.