uploadSettings.filesPerPackage Property HTML5/Flash Uploader JavaScript

Supported technologies:

Gets or sets a number of user-selected files which will be processed and uploaded within a single request.

Syntax

JavaScript Initialize 
$au.imageUploaderFlash({
    uploadSettings: {
        //...other params...
        filesPerPackage: 1,
        //...other params...
    }
})
Get/Set Value at Runtime 
$au.imageUploaderFlash('uploaderID').uploadSettings().filesPerPackage(value);
value = $au.imageUploaderFlash('uploaderID').uploadSettings().filesPerPackage();

Property Value

Type: Number

The number of user-selected files that will be processed and uploaded within a single request. If a user selects more files than specified here, several POST files will be made to send those files. When this value is 0, all the files are uploaded in one request.

Default value is 1.

Remarks

When this property is greater than 0, HTML5/Flash Uploader sends as many items (converted files and their respective metadata) per each request as specified by this param. Typical scenario is when you set this value to 1, i.e. every user-selected file is processed and uploaded in a separate request. It gives a number of benefits: reduces amount of memory used on the server to process requests from HTML5/Flash Uploader and allows resuming partially completed upload if it has been broken, etc.

Note, if you configure multiple convertors, all files generated by them are uploaded together. For example, this param is 1 and you are uploading an original file + a thumbnail. If a user selects three files, they will be uploaded in three requests (not in six!). If you prefer to override this behavior and have to upload each converted file separately, use the uploadConverterOutputSeparately property.

See Also

Reference

Manual