CKFinder 2.x/Developers Guide/ColdFusion/Configuration/Quick Start - Revision history

Anna: Article content moved to a template

2011-03-31T12:25:22Z

Article content moved to a template

Anna: Sessions note template changed, code formatted with GesHi

2011-03-31T10:44:52Z

Sessions note template changed, code formatted with GesHi

Wiktor: Created page with '== The CheckAuthentication() function
== By default, CKFinder will not work due to authentication restrictions. You must first be sure that you have configured it properly, …'

2010-05-14T19:20:04Z

Created page with '== The CheckAuthentication() function<br> == By default, CKFinder will not work due to authentication restrictions. You must first be sure that you have configured it properly, …'

New page

== The CheckAuthentication() function<br> ==

By default, CKFinder will not work due to authentication restrictions. You must first be sure that you have configured it properly, 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 that ensures that the requests are coming from an authenticated user. This is usually done by assigning a session variable when the user logs on your system.

Return "true" if the user is properly authenticated. We strongly recommend you to NOT simply return "true" from this function without implementing authentication checks. Anonymous users would be able to use CKFinder, including uploading and deleting files from your server.

The following is a sample implementation for it:
<pre>function CheckAuthentication()
{
if ( structKeyExists(session, "IsAuthenticated") and session.IsAuthenticated )
{
return true;
}

return false;
}
</pre>
{{CKFinder_2.x Sessions|lang=ColdFusion}}
=== License ===

If you purchased CKFinder you should put your license key in the config.cfm file:
<pre>config.licenseName = 'put your license name here';
config.licenseKey = 'put your license key here';</pre>
If you leave this fields blank CKFinder will be fully functional but it will be ruining in demo mode.

=== baseUrl ===

The '''baseUrl''' is the base path used to build the final URL for the resources handled in CKFinder. Examples:
<pre>config.baseUrl = 'http://example.com/ckfinder/files/';
config.baseUrl = '/userfiles/';</pre>
If you leave this field empty the default value (/userfiles/) will be used. Notice that the trailing slash is required.

=== baseDir ===

The '''baseDir''' is the path to the local directory (in the server) which points to the above baseUrl URL. This is the path used by CKFinder to handle the files in the server. Full write permissions must be granted to this directory. Examples:

You may point it to a directory directly:
<pre>config.baseDir = '/home/login/public_html/ckfinder/files/';
config.baseDir = 'C:/SiteDir/CKFinder/userfiles/';</pre>
Or you may let CKFinder discover the path, based on baseUrl:
<pre>config.baseDir = APPLICATION.CreateCFC("Utils.FileSystem").resolveUrl(config.baseUrl);</pre>
Remember that CKFinder will only discover the path when the base url is a local web path ( relative to document root ).<br>Example:
<pre>config.baseUrl = '/userfiles/';</pre>
If it is a full URL address.<br>Example:
<pre>config.baseUrl = 'http://example.com/ckfinder/files/';</pre>
the path won't be discovered. Notice that the trailing slash is required.

@@ Line 1: / Line 1: @@
-== The CheckAuthentication() function<br> ==
+{{CKFinder_2.x_CheckAuthentication}}
 <source lang="cfm">function CheckAuthentication()
+{
@@ Line 21: / Line 13: @@
 {{CKFinder_2.x Sessions note|lang=ColdFusion}}
-=== License ===
+{{CKFinder_2.x License|file=<code>config.cfm</code>|code=
 <source lang="cfm">config.licenseName = 'put your license name here';
-config.licenseKey = 'put your license key here';</source>
+config.licenseKey = 'put your license key here';</source> }}
-=== baseUrl ===
+{{CKFinder_2.x baseUrl|baseUrl=baseUrl|code=
 <source lang="cfm">config.baseUrl = 'http://example.com/ckfinder/files/';
-config.baseUrl = '/userfiles/';</source>
+config.baseUrl = '/userfiles/';</source>}}
-You may point it to a directory directly:
+{{CKFinder_2.x baseDir|baseUrl=baseUrl|baseDir=baseDir|code1=
 <source lang="cfm">config.baseDir = '/home/login/public_html/ckfinder/files/';
-config.baseDir = 'C:/SiteDir/CKFinder/userfiles/';</source>
+config.baseDir = 'C:/SiteDir/CKFinder/userfiles/';</source>|code2=
-Or you may let CKFinder discover the path, based on baseUrl:
+<source lang="cfm">config.baseDir = APPLICATION.CreateCFC("Utils.FileSystem").resolveUrl(config.baseUrl);</source>|code3=
-<source lang="cfm">config.baseDir = APPLICATION.CreateCFC("Utils.FileSystem").resolveUrl(config.baseUrl);</source>
+<source lang="cfm">config.baseUrl = '/userfiles/';</source>|code4=
-Remember that CKFinder will only discover the path when the base url is a local web path ( relative to document root ).<br>Example:
+<source lang="cfm">config.baseUrl = 'http://example.com/ckfinder/files/';</source>}}

@@ Line 8: / Line 8: @@
 The following is a sample implementation for it:
-<pre>function CheckAuthentication()
+<source lang="cfm">function CheckAuthentication()
+{
      if ( structKeyExists(session, "IsAuthenticated") and session.IsAuthenticated )
@@ Line 17: / Line 17: @@
      return false;
+}
-</pre>
+</source>
 {{CKFinder_2.x Sessions|lang=ColdFusion}}
 === License ===
 If you purchased CKFinder you should put your license key in the config.cfm file:
-<pre>config.licenseName = 'put your license name here';
+<source lang="cfm">config.licenseName = 'put your license name here';
-config.licenseKey = 'put your license key here';</pre>
+config.licenseKey = 'put your license key here';</source>
 If you leave this fields blank CKFinder will be fully functional but it will be ruining in demo mode.
@@ Line 29: / Line 31: @@
 The '''baseUrl''' is the base path used to build the final URL for the resources handled in CKFinder. Examples:
-<pre>config.baseUrl = 'http://example.com/ckfinder/files/';
+<source lang="cfm">config.baseUrl = 'http://example.com/ckfinder/files/';
-config.baseUrl = '/userfiles/';</pre>
+config.baseUrl = '/userfiles/';</source>
 If you leave this field empty the default value (/userfiles/) will be used. Notice that the trailing slash is required.
@@ Line 38: / Line 40: @@
 You may point it to a directory directly:
-<pre>config.baseDir = '/home/login/public_html/ckfinder/files/';
+<source lang="cfm">config.baseDir = '/home/login/public_html/ckfinder/files/';
-config.baseDir = 'C:/SiteDir/CKFinder/userfiles/';</pre>
+config.baseDir = 'C:/SiteDir/CKFinder/userfiles/';</source>
 Or you may let CKFinder discover the path, based on baseUrl:
-<pre>config.baseDir = APPLICATION.CreateCFC("Utils.FileSystem").resolveUrl(config.baseUrl);</pre>
+<source lang="cfm">config.baseDir = APPLICATION.CreateCFC("Utils.FileSystem").resolveUrl(config.baseUrl);</source>
 Remember that CKFinder will only discover the path when the base url is a local web path ( relative to document root ).<br>Example:
-<pre>config.baseUrl = '/userfiles/';</pre>
+<source lang="cfm">config.baseUrl = '/userfiles/';</source>
 If it is a full URL address.<br>Example:
-<pre>config.baseUrl = 'http://example.com/ckfinder/files/';</pre>
+<source lang="cfm">config.baseUrl = 'http://example.com/ckfinder/files/';</source>
 the path won't be discovered. Notice that the trailing slash is required.

CKFinder 2.x/Developers Guide/ColdFusion/Configuration/Quick Start - Revision history

Anna: Article content moved to a template

Anna: Sessions note template changed, code formatted with GesHi

Wiktor: Created page with '== The CheckAuthentication() function == By default, CKFinder will not work due to authentication restrictions. You must first be sure that you have configured it properly, …'

Wiktor: Created page with '== The CheckAuthentication() function
== By default, CKFinder will not work due to authentication restrictions. You must first be sure that you have configured it properly, …'