(Sessions note removed) |
(added note about the checkAuthentication method) |
||
| Line 1: | Line 1: | ||
| − | + | == Enabling CKFinder == | |
| − | <source lang=" | + | |
| + | As explained in the [[CKFinder_2.x/Developers Guide/Java/Installation|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. | ||
| + | <source lang="xml"> | ||
| + | <enabled>true</enabled> | ||
</source> | </source> | ||
| + | |||
| + | <note> | ||
| + | Usually enabling file manager for anyone is not the best idea and a more sensitive authentication method is needed. After enabling CKFinder, access can be restricted with the <code>checkAuthentication</code> method to ensure that requests are coming from an authenticated user with required privileges. | ||
| + | |||
| + | To create a custom <code>checkAuthentication</code> method, simply override it from the Configuration class, as explained in [[CKFinder_2.x/Developers_Guide/Java/Integration#Extending_Configuration | Extending Configuration]] article. | ||
| + | </note> | ||
| + | |||
{{CKFinder_2.x License|file=<code>config.xml</code>|code= | {{CKFinder_2.x License|file=<code>config.xml</code>|code= | ||
Revision as of 22:25, 1 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 file manager for anyone is not the best idea and a more sensitive authentication method is needed. After enabling CKFinder, access can be restricted with the checkAuthentication method to ensure that requests are coming from an authenticated user with required privileges.
To create a custom checkAuthentication method, simply override it from the Configuration class, as explained in Extending Configuration 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.