Revision as of 13:36, 18 May 2010

CKFinder allows you to create thumbnails and to scale uploaded images to the preferred size.

This section describes working with images. It will provide you with the information on how to properly configure thumbnails and image resizing options.

Thumbnails

You can set configure thumbnails by using the following settings in the configuration file:

Thumbnails.Url = BaseUrl + "_thumbs/";
Thumbnails.Dir = "";
Thumbnails.Enabled = true;
Thumbnails.MaxWidth = 100;
Thumbnails.MaxHeight = 100;
Thumbnails.Quality = 80;

Url and Dir

The Url and Dir properties defined the folder used to hold all thumbnail images, and the URL to access them. It works just like the BaseUrl and BaseDir settings.

Enabled

By setting Enabled to "false", CKFinder will have no support for thumbnails.

MaxWidth and MaxHeight

Sets the maximum size of the thumbnails displayed in CKFinder. These values are expressed in pixels.

Quality

Sets the quality level used to produce thumbnails in a range from 1 to 100. The smaller the quality the smaller the size of the thumbnail files. Notice that an acceptable value should not be less than 45. For quality thumbnails, 80 is more than sufficient.

Image Auto Scaling

It is possible to configure CKFinder to automatically scale images to fit a maximum size. If the original image size is bigger than the one specified by you, the image size will be scaled down proportionally to fit your predefined values.

You may also change the quality of the scaling algorithm in a range from 1 to 100.

To apply these options you should change values in the configuration file:

Images.MaxWidth = 1600;
Images.MaxHeight = 1200;
Images.Quality = 80;

Verify Image Uploads

Image files may be improperly used to inject invalid content in your web site. To enhance the security of your server, CKFinder can automatically verify image files on upload. You can use the SecureImageUploads to enable/disable this feature:

SecureImageUploads = true ;