File Upload Preferences¶

Descriptive name of upload directory¶

This is the descriptive name of the upload destination. It is a required field and must be unique, but spaces are allowed. This name will appear when uploading files via the PUBLISH page.

Server Path to Upload Directory¶

The full server path (not a URL) to the upload folder for this destination. For example:

/home/user/example.com/public_html/images/uploads/

If you are not sure how to determine your server path please contact your hosting company.

URL of Upload Directory¶

The full URL to the new destination. For example: http://example.com/images/uploads/

Allowed File Types¶

This preference will determine how the system handles the uploaded files. You have two choices for this preference:

1. Images only: With this preference set, the system will only allow image files of the type GIF, JPG, JPEG, or PNG.
2. All file types: This option will allow you to upload files of any type to the system. Be careful with this setting since it could be possible for someone to upload a malicious file.

Maximum File Size (in bytes)¶

You can optionally set a maximum allowed size for uploaded file. Leave the setting blank if you do not wish to impose a limit. The size is defined in bytes; 1 kilobyte = 1024 bytes. Example: to limit each upload to 30 kilobytes, you’ll put 30720 in the field.

Maximum Image Height (in pixels)¶

You can optionally set the maximum allowed height for uploaded images, images over this setting will be automatically resized. Leave both this setting and the maximum width setting blank if you do not with to impose a limit. The size is defined in pixels. This option only applies to uploaded images and not other file types.

Maximum Image Width¶

You can optionally set the maximum allowed width for uploaded images, images over this setting will be automatically resized. both this setting and the maximum height setting blank if you do not with to impose a limit. The size is defined in pixels. This option only applies to uploaded images and not other file types.

Image Properties¶

These properties will be added inside the image tag (if an image is uploaded). Leave this setting blank if you do not wish for any properties to be added.

For example: If you have border=”0” alt=”image” name=”image” set as your preference, when you upload an image, the resulting tag will look like this:

<img src="http://example.com/images/upload/pic.jpg" border="0" alt="image" name="image" width="124" height="98" />

Image Pre Formatting¶

This setting lets you specify data to be placed before the HTML for an uploaded image. Using this (and the following) setting you can easily “wrap” your file code. For example, you could use <div class=”thumb”>.

Image Post Formatting¶

This setting lets you specify data to be placed after the HTML for an uploaded image. Using this (and the previous) setting you can easily “wrap” your file code. For example, you could use </div>. Together with the previous setting you would get this output:

<div class="thumb"><img src="http://example.com/images/upload/pic.jpg" border="0" alt="image" name="image" width="124" height="98" /></div>

File Properties¶

These properties will be added inside the link tag (if a file is uploaded). Leave this setting blank if you do not wish for any properties to be added.

For example: If you have title=”file_name” set as your preference, when you upload a file, the resulting tag will look like this:

<a href="http://example.com/images/upload/plan.txt" title="file_name">plan.txt</a>

File Pre Formatting¶

This setting lets you specify data to be placed before the HTML for an uploaded file (non-image). Using this (and the following) setting you can easily “wrap” your file code. For example, you could use <div class=”file”>.

File Post Formatting¶

This setting lets you specify data to be placed after the HTML for an uploaded file (non-image). Using this (and the previous) setting you can easily “wrap” your file code. For example, you could use </div>. Together with the previous setting you would get this output:

<div class="file"><a href="http://example.com/images/upload/plan.txt" >plan.txt</a></div>

File Category Groups¶

You may assign multiple category groups to a file upload directory, which will allow you to assign categories to any uploaded files.

Image Manipulations¶

This area allows you to specify one or more alternate versions of an image that automatically get created when the original image is uploaded. A manipulation can include a resized version, a watermark, or both.

The resize type will determine whether the image is constrained (resized) or cropped to the specified dimensions. If only height or width is specified, the thumbnails will be created using that as the master dimension. For example, setting the height to 200 and leaving the width blank will result in an image that is no higher than 200 pixels, with the width resized proportionately. Setting both the height and the width to 200 would result in an image that is no higher or wider than 200 pixels.

You can refer to a particular Image Manipulation in your templates via a File Field’s single variable tag or its variable pair tag.

Restrict file uploading to select member groups¶

This setting allows you to specify which member groups have permission to upload files to this file upload destination. By default, only the “Members” group and any user-created member groups are listed. Super Admins can always upload files.