(→Resource Type Options) |
|||
| (14 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
== Default resources == | == Default resources == | ||
| − | === Resources types === | + | === Resources types === |
There are three built-in resources types in CKFinder: '''files''', '''images''' and '''flash'''. They appear in the config.php file as below: | There are three built-in resources types in CKFinder: '''files''', '''images''' and '''flash'''. They appear in the config.php file as below: | ||
| − | < | + | |
| − | 'name' = | + | <source lang="php">$config['ResourceType'][] = Array( |
| − | 'url' = | + | 'name' => 'Files', // Single quotes not allowed |
| − | 'directory' = | + | 'url' => $baseUrl . 'files', |
| − | 'maxSize' = | + | 'directory' => $baseDir . 'files', |
| − | 'allowedExtensions' = | + | 'maxSize' => 0, |
| − | 'deniedExtensions' = | + | 'allowedExtensions' => '7z,aiff,asf,avi,bmp,csv,doc,fla,flv,gif,gz,gzip,jpeg,jpg,mid,mov,mp3,mp4,mpc,mpeg,mpg,ods,odt,pdf,png,ppt,pxd,qt,ram,rar,rm,rmi,rmvb,rtf,sdc,sitd,swf,sxc,sxw,tar,tgz,tif,tiff,txt,vsd,wav,wma,wmv,xls,xml,zip', |
| + | 'deniedExtensions' => ''); | ||
$config['ResourceType'][] = Array( | $config['ResourceType'][] = Array( | ||
| − | 'name' = | + | 'name' => 'Images', |
| − | 'url' = | + | 'url' => $baseUrl . 'images', |
| − | 'directory' = | + | 'directory' => $baseDir . 'images', |
| − | 'maxSize' = | + | 'maxSize' => 0, |
| − | 'allowedExtensions' = | + | 'allowedExtensions' => 'bmp,gif,jpeg,jpg,png', |
| − | 'deniedExtensions' = | + | 'deniedExtensions' => ''); |
$config['ResourceType'][] = Array( | $config['ResourceType'][] = Array( | ||
| − | 'name' = | + | 'name' => 'Flash', |
| − | 'url' = | + | 'url' => $baseUrl . 'flash', |
| − | 'directory' = | + | 'directory' => $baseDir . 'flash', |
| − | 'maxSize' = | + | 'maxSize' => 0, |
| − | 'allowedExtensions' = | + | 'allowedExtensions' => 'swf,flv', |
| − | 'deniedExtensions' = | + | 'deniedExtensions' => '');</source> |
| + | |||
These resources will be enabled if this option: | These resources will be enabled if this option: | ||
| − | <pre>$config['DefaultResourceTypes'] = '';</pre> | + | |
| − | is left empty. | + | <pre>$config['DefaultResourceTypes'] = '';</pre> |
| + | |||
| + | is left empty. You may specify what resources types you want to use by placing their names separated by a comma. | ||
| − | == | + | == Resource Type Options == |
| − | + | For each resource type you may set several options to precisely configure its behavior. | |
| + | |||
| + | '''url''' and '''directory''' - define the base URL address and the server directory to use to handle and publish the files for this Resource Type. They follow the same rules as defined in the [[CKFinder_1.x/Developers Guide/PHP/Configuration/Quick Start|Quick Start]] section for the '''$baseUrl''' and '''$baseDir''' settings. | ||
| + | |||
| + | '''maxSize''' - is the maximum size of the uploaded image defined in bytes.You may also use shorthand notation. Available options are: G, M, K (case insensitive). Remember that: 1M equals 1048576 bytes (one Megabyte), 1K equals 1024 bytes (one Kilobyte), 1G equals one Gigabyte. Example: 'maxSize' => "8M", | ||
| + | |||
| − | + | You can use the following settings to list the file extensions that can be upload to the server: | |
| − | ''' | + | * '''allowedExtensions''' - the extensions you wish CKFinder to use. If left empty, only DeniedExtensions is used to check uploads. |
| + | * '''deniedExtensions''' - the extensions you don't wish the CKFinder to use. | ||
| − | '''allowedExtensions''' | + | '''Important: It is recommended''' to always use the allowedExtensions setting, in favor of deniedExtensions. If you leave '''allowedExtensions''' empty and you define an extension in '''deniedExtensions''', for example "pdf", it will allow the upload of all the other files except the files with the "pdf" extension. However it isn't a good way to secure your server from unwanted uploads. The best way is to put all of the preferred extensions in '''allowedExtensions'''. That's the only way to effectively secure your server from hacker's attacks. |
| − | |||
| − | + | {{#CUSTOMTITLE:Built-in resource types}} | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Latest revision as of 09:01, 28 May 2010
Default resources
Resources types
There are three built-in resources types in CKFinder: files, images and flash. They appear in the config.php file as below:
$config['ResourceType'][] = Array( 'name' => 'Files', // Single quotes not allowed 'url' => $baseUrl . 'files', 'directory' => $baseDir . 'files', 'maxSize' => 0, 'allowedExtensions' => '7z,aiff,asf,avi,bmp,csv,doc,fla,flv,gif,gz,gzip,jpeg,jpg,mid,mov,mp3,mp4,mpc,mpeg,mpg,ods,odt,pdf,png,ppt,pxd,qt,ram,rar,rm,rmi,rmvb,rtf,sdc,sitd,swf,sxc,sxw,tar,tgz,tif,tiff,txt,vsd,wav,wma,wmv,xls,xml,zip', 'deniedExtensions' => ''); $config['ResourceType'][] = Array( 'name' => 'Images', 'url' => $baseUrl . 'images', 'directory' => $baseDir . 'images', 'maxSize' => 0, 'allowedExtensions' => 'bmp,gif,jpeg,jpg,png', 'deniedExtensions' => ''); $config['ResourceType'][] = Array( 'name' => 'Flash', 'url' => $baseUrl . 'flash', 'directory' => $baseDir . 'flash', 'maxSize' => 0, 'allowedExtensions' => 'swf,flv', 'deniedExtensions' => '');
These resources will be enabled if this option:
$config['DefaultResourceTypes'] = '';
is left empty. You may specify what resources types you want to use by placing their names separated by a comma.
Resource Type Options
For each resource type you may set several options to precisely configure its behavior.
url and directory - define the base URL address and the server directory to use to handle and publish the files for this Resource Type. They follow the same rules as defined in the Quick Start section for the $baseUrl and $baseDir settings.
maxSize - is the maximum size of the uploaded image defined in bytes.You may also use shorthand notation. Available options are: G, M, K (case insensitive). Remember that: 1M equals 1048576 bytes (one Megabyte), 1K equals 1024 bytes (one Kilobyte), 1G equals one Gigabyte. Example: 'maxSize' => "8M",
You can use the following settings to list the file extensions that can be upload to the server:
- allowedExtensions - the extensions you wish CKFinder to use. If left empty, only DeniedExtensions is used to check uploads.
- deniedExtensions - the extensions you don't wish the CKFinder to use.
Important: It is recommended to always use the allowedExtensions setting, in favor of deniedExtensions. If you leave allowedExtensions empty and you define an extension in deniedExtensions, for example "pdf", it will allow the upload of all the other files except the files with the "pdf" extension. However it isn't a good way to secure your server from unwanted uploads. The best way is to put all of the preferred extensions in allowedExtensions. That's the only way to effectively secure your server from hacker's attacks.