(Article contents proof-read and formatted) |
(Note updated with a correct reference) |
||
| Line 11: | Line 11: | ||
Usually enabling the file manager for anyone is not a recommended solution and a more fine-grained authentication method is needed. After you enable CKFinder access can be restricted by using the <code>checkAuthentication</code> method to ensure that requests are coming from an authenticated user with required privileges. | Usually enabling the file manager for anyone is not a recommended solution and a more fine-grained authentication method is needed. After you enable CKFinder access can be restricted by using the <code>checkAuthentication</code> method to ensure that requests are coming from an authenticated user with required privileges. | ||
| − | In order to create a custom <code>checkAuthentication</code> method, override it from the <code>Configuration</code> class, as explained in the [[CKFinder_2.x/Developers_Guide/Java/Integration#Extending_Configuration|Extending Configuration]] article. | + | In order to create a custom <code>checkAuthentication</code> method, override it from the <code>Configuration</code> class, as explained in the [[CKFinder_2.x/Developers_Guide/Java/Integration#Extending_Configuration|Extending Configuration]] section of the [[CKFinder_2.x/Developers_Guide/Java/Integration|Integrating CKFinder]] article. |
</note> | </note> | ||
Revision as of 11:36, 7 April 2011
Contents
Enabling CKFinder
As explained in the Installation Guide due to security reasons by default CKFinder is disabled. When you reviewed the settings and are ready to go, open the configuration file and enable the program.
<enabled>true</enabled>
Usually enabling the file manager for anyone is not a recommended solution and a more fine-grained authentication method is needed. After you enable CKFinder access can be restricted by using the checkAuthentication method to ensure that requests are coming from an authenticated user with required privileges.
In order to create a custom checkAuthentication method, override it from the Configuration class, as explained in the Extending Configuration section of the Integrating CKFinder article.
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.