Functionality parameters: Upload
Home
page
Contact
support
|
JavaPowUpload 2.1
Functionality parameters: Upload |
Home
pageContact
support
|
JavaPowUpload functinality parameters related to upload
For more information on how to setup the JavaPowUpload parameters see tutorials section.
| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.UploadUrl | URL | url to the file receiving script in the http upload mode or to ftp folder in ftp upload mode. Valid protocols are ftp, http, https. |
|
| Upload.DragAndDrop.Enabled | Bollean | It determines whether JavaPowUpload should use drag and drop feature in the upload mode for adding files. | true |
| Upload.AutoStartOnFilesAdd | Bollean | It determines whether JavaPowUpload should start upload process automatically when a user adds files. | false |
| Upload.AllowAddFilesWhileUpload | Bollean | It determines whether JavaPowUPload should allow addition of files while upload is in proccess . | true |
Browse dialog parameters
| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.BrowseDialog.DetailsViewByDefault | Bollean | It determines whether JavaPowUpload should set details or list view by default in the browse dialog. | false |
| Upload.BrowseDialog.DefaultPath | String | Default path for the browse dialog in the Upload mode. | |
| Upload.BrowseDialog.ImagePreview.Visible | Bollean | It determines whether JavaPowUpload should display the image preview in the browse dialog. | false |
| Upload.BrowseDialog.ImagePreview.Width | Integer | Width of the image preview panel. | 150 |
| Upload.BrowseDialog.ImagePreview.Height | Integer | Height of the image preview panel. | 150 |
File filter parameters
| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.FileFilter.MaxFileSize | long | Maximum file size allowed for upload in bytes. | -1 |
| Upload.FileFilter.MaxFileCount | long | Maximum number of files allowed for upload. | -1 |
| Upload.FileFilter.MaxFileTotalSize | long | Maximum total file size allowed for upload in bytes. | -1 |
| Upload.FileFilter.Types | string | An array of file types used to filter the files displayed in the dialog box. To allow the files without extention, use "without_extension" string as an extension Example: fileFilter.Types=jpeg,jpg,giff |
|
| Upload.FileFilter.Description | string | File filter description. The description will look like: fileFilterDescription+fileFilterDescription.FileSizeLimit | Allowed files |
| Upload.FileFilter.Description.FileSizeLimit | string | File size limit string pattern. It is added to the end of fileFilter.Description parameter. |
(file size limit: #MAXFILESIZE#) |
| Upload.FileFilter.MultipleSelection | Bollean | It determine whether JavaPowUpload should allow multiple file selection in the browse dialog. Note: if Upload.FileFilter.MaxFileCount parameter is set to 1, JavaPowUpload will automatically disable multiple selection in the browse dialog. |
true |
| Upload.FileFilter.IncludeSubDirectories | Bollean | It determines whether JavaPowUpload should add subdirectories to the file tree. | true |
| Upload.FileFilter.SelectionMode | String | Possible values: "FILES" - a user is able to select only files in the browse dialog. "DIRS" - a user is able to select only directories in the browse dialog. "FILES_AND_DIRS" - a user is able to select files and folders. |
FILES_AND_DIRS |
Upload thumbnails
| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.Thumbnails.Upload | boolean | It determines whether JavaPowUpload should upload thumbnails to a server. | false |
| Upload.Thumbnails.UploadOriginalFile | boolean | It determines whether JavaPowUpload should upload an original image file to a server. | false |
| Upload.Thumbnails.Height | long | Thumbnail image height. It propotionally changes to source image dimensions. | 500 |
| Upload.Thumbnails.Width | long | Thumbnail image width. It propotionally changes to source image dimensions. | 500 |
| Upload.Thumbnails.Format | string | Image format of a thumbnail. Possible values are: jpeg, JPEG, jpg, JPG, png, PNG, bmp, BMP. |
JPG |
| Upload.Thumbnails.FilePrefix | string | This prefix will be added to the source image file name. | |
| Upload.Thumbnails.GenerateOnAdd | boolean | If the parameter is set to true, JavaPowUpload will generate image thumbnail for upload when the images are being added, otherwise the thumbnails will be generated when the upload process is initiated. | false |
| Upload.Thumbnails.IncludeOriginalImageMetadata | boolean | It determines whether JavaPowUpload should write metadata from the original image into the newly created thumbnail. | false |
| Upload.Thumbnails.Watermark.Enabled | boolean | It deterimes whether JavaPowUpload should add watermark to the thumbnails. The watermark is added only to the uploaded thumbnail and not visible in the DetailsArea preview. |
false |
| Upload.Thumbnails.Watermark.ImageUrl | URL | Url to the image which should be used as a watermark. | |
| Upload.Thumbnails.Watermark.Position | String | Available values: Top.Left, Top.Center, Top.Right, Center.Left, Center.Center, Center.Right, Bottom.Left, Bottom.Center, Bottom.Right. | Bottom.Right |
| Upload.Thumbnails.Watermark.Alpha | float | Watermark transparency. 0.0 - fully transparent, 1.0 - fully opaque. | 0.6 |
| Upload.Thumbnails.Watermark.Text | String | Watermark text. It is used only if the Upload.Thumbnails.Watermark.ImageUrl parameter is not set, or cannot be loaded. | |
| Upload.Thumbnails.Watermark.TextColor | Color | Watermark text color. | #FF0000 |
| Upload.Thumbnails.Watermark.FontName | String | Watermark text font. | Arial |
| Upload.Thumbnails.Watermark.FontStyle | Integer | Watermark text style. Font style: 0�plain, 1-bold, 2-itallic. |
1 |
| Upload.Thumbnails.Watermark.FontSize | Integer | Watermark text size. | 18 |
Compress before upload
| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.Compress.Enabled | boolean | Determines whether cfiles should be compressed before upload or not. | false |
| Upload.Compress.Format | string | Format of generated archive file. Available values: ZIP, JAR, TAR, TAR-GZIP, TAR-BZIP2 |
ZIP |
| Upload.Compress.Level | string | Compression level. Applies only for JAR and ZIP compression format. Available values: DEFAULT, BEST_SPEED, BEST_COMPRESSION |
DEFAULT |
| Upload.Compress.ArchiveFileName | string | Name of archive file. You can use 2 placehglders: #UNIQUEID# - will be replaced with unique identifier #COUNTER# - will be replaced with current count of archive files |
#UNIQUEID# |
| Upload.Compress.PlaceThumbnailsAtRoot | boolean | If thumbnmails upload enabled, you can configure applet to place all generatred thumbnails at root of archive. If value set to true, all thumbnails placed at the root of archive, otherwise thumbnails placed in the same folders as source image files. | false |
| Upload.Compress.MaxFilesInArchive | integer | Determines how many files should be included in one archive file. Empty value - all files will be placed in one archive. | |
| Upload.Compress.IncludeFileTypes | string | Which files should be included into archive. Comma separated list of file types. Example: txt,log,doc,docx |
|
| Upload.Compress.IgnoreFileTypes | string | Comma separated list of file types which should be ignored. For example you can configure to ignore already compressed types. Like mp3, jpeg, etc Example: jpg,jpeg,mp3,ogg,avi,mpeg |
HTTP upload
| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.HttpUpload.ConnectionTimeOut | integer | Http connection timeout. | 3000 |
| Upload.HttpUpload.UserAgent | String | HTTP User-Agent header value. #BROWSER# placeholder will be replaced by the user-agent string of browser where JavaPowUpload launched. | #BROWSER# |
| Upload.HttpUpload.SendTestRequest | booleam | It detremines whether JavaPowUpload will send test request to http server. We recommend set to true the value of this parameter if your server require authentication. It will allow JavaPowUpload to preform authentication with "cheap" methods, like empty HEAD or POST requests. | false |
| Upload.HttpUpload.TestRequestMethod | String | It detremines which http method is used to perform test request to a server. Valid values: Head, Post. | Head |
| Upload.HttpUpload.FormName | string | A name of the html form values of which will be automatically added to the request headers, post fields or to the query string. | |
| Upload.HttpUpload.CustomHeaders | string | Array of the custom header names and values that will be added to the request separated by ; Example: headerName1=value1;headerName2=value2 |
|
| Upload.HttpUpload.CustomPostFields | string | Array of the custom fields and values that will be added to the request separated by ; Example: filedName1=value1;FieldName2=value2 |
|
| Upload.HttpUpload.SendBrowserCookie | boolean | It determines whether JavaPowUpload will send browser cookies. | true |
| Upload.HttpUpload.ExpectContinueHeader | boolean | It determines whether JavaPowUpload will include Except: 100 Continue header. | true |
| Upload.HttpUpload.ChunkedUpload.Enabled | boolean | It determines whether JavaPowUpload should use chuncked mode for file uploads. Please note: this method is not RFC compliant, so you should use a specific script on the server side (php and asp.net samples are included in the distribution package). | false |
| Upload.HttpUpload.ChunkedUpload.ChunkSize | integer | Size of chunk in bytes. If the parameter is set to -1 , JavaPowUpload will automatically increase the chunk size to an optimal value. | -1 |
| Upload.HttpUpload.ChunkedUpload.MaxChunkSize | integer | Maximum chunk size. If the chunkedUpload.chunkSize parameter is set to -1, the value of this parameter is used to a limit maximum size of a chunk. It should be less than the request or the file size limitation on the server side . | 2097152 |
| Upload.HttpUpload.SendFileMD5 | boolean | It determines whether JavaPowUpload will send MD5 hash of file. | false |
| Upload.HttpUpload.HeadersPrefix | string | A prefix of http xtra headers. | ElementIT |
| Upload.HttpUpload.MaxFilesCountPerRequest | integer | It determines how many files JavaPowUpload will send in one request. | -1 |
| Upload.HttpUpload.MaxFilesSizePerRequest | long | Maximum size of files (e.q. request size). | -1 |
| Upload.HttpUpload.JavaPowUploadIDHeader | string | Name of JavaPowUpload ID header. | X-JavaPowUploadID |
| Upload.HttpUpload.AcceptSelfSignedCertificates | boolean | It deterimines whether JavaPowUpload should accept a self signed (not verified) ssl certificate. | false |
| Upload.HttpUpload.AddFormValuesToPostFields | boolean | It determines whether JavaPowUpload will add form (specified by the HttpUpload.FormName parameter) values to the request post fields. | true |
| Upload.HttpUpload.AddFormValuesToQueryString | boolean | It determines whether JavaPowUpload will add form (specified by the HttpUpload.FormName parameter) values to the request query string. | false |
| Upload.HttpUpload.AddFormValuesToHeaders | boolean | It determines whether JavaPowUpload will add form (specified by the HttpUpload.FormName parameter) values to the request headers. | false |
HTTP post fields
| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.HttpUpload.FieldName.ThumbnailFilePath | string | It is used when files are uploaded with the HTTP POST method. Pattern for the file path (path in JavaPowUpload tree) field name. | ThumbnailPath_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailRealFilePath | string | It is used when files are uploaded with the HTTP POST method. Pattern for the real file (path on user machine) path field name. | ThumbnailRealFilePath_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailFileSize | string | It is used when files are uploaded with the HTTP POST method. Pattern for the file size field name. | ThumbnailFileSize_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailFileMD5 | string | It is used when files are uploaded with the HTTP POST method. Pattern for the file MD5 field name. | ThumbnailFileMD5_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailFileIndex | string | It is used when files are uploaded with the HTTP POST method. Pattern for the file index field name. | ThumbnailFileIndex_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailBody | string | It is used when files are uploaded with the HTTP POST method. Pattern for the file body field name. | ThumbnailBody_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailRotateAngle | string | Pattern for the image rotation angle field name. | ThumbnailRotateAngle_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailCropX | string | Pattern for field name that contain x coordinate of crop rectangle. | ThumbnailCropX_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailCropY | string | Pattern for the field name that contains y coordinate of the crop rectangle. | ThumbnailCropY_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailCropWidth | string | Pattern for the field name that contains width of the crop rectangle. | ThumbnailCropWidth_#COUNTER# |
| Upload.HttpUpload.FieldName.ThumbnailCropHeight | string | Pattern for the field name that contains height of the crop rectangle. | ThumbnailCropHeight_#COUNTER# |
| Upload.HttpUpload.FieldName.FilePath | string | Pattern for the file path (path in the JavaPowUpload tree) field name. | FilePath_#COUNTER# |
| Upload.HttpUpload.FieldName.RealFilePath | string | Pattern for the real file (path on user machine) path field name. | RealFilePath_#COUNTER# |
| Upload.HttpUpload.FieldName.FileSize | string | Pattern for the file size field name. | FileSize_#COUNTER# |
| Upload.HttpUpload.FieldName.FileMD5 | string | Pattern for the file MD5 field name. | FileMD5_#COUNTER# |
| Upload.HttpUpload.FieldName.FileLastModified | string | Pattern for the last modified field name. | FileLastModified_#COUNTER# |
| Upload.HttpUpload.FieldName.FileIndex | string | Pattern for the file index field name. | FileIndex_#COUNTER# |
| Upload.HttpUpload.FieldName.FileBody | string | Pattern for the file body field name. | FileBody_#COUNTER# |
| Upload.HttpUpload.FieldName.FileDescription | string | Pattern for the file description field name. | FileDescription_#COUNTER# |
| Upload.HttpUpload.FieldName.FileCustomPostField | string | Pattern for the name of the post fields specified for individual files (UploadItem object).#FIELDNAME# - name of the form field. #COUNTER# - file counter in a request. | #FIELDNAME#_#COUNTER# |
| Upload.HttpUpload.FieldName.EmptyFolder | string | Form field name pattern for empty folders. #COUNTER# is a counter of empty folders started from 0. | EmptyFolder_#COUNTER# |
Upload to Amazon S3
Please read tutorials section of documentation to learn how to generate parameters for Amazon S3 upload feature. Do not fill them by self.| Parameter name | Type | Desciption | Default value |
|---|---|---|---|
| Upload.AmazonS3.AccessKeyId | String | Access Key ID to perform requests to Amazon. | |
| Upload.AmazonS3.Policy | String | Encoded policy. | |
| Upload.AmazonS3.Signature | String | Signature of request. | |
| Upload.AmazonS3.Acl | String | Permissions to be set for uploaded file. Valid values are: private public-read public-read-write authenticated-read |
public-read |
| Upload.AmazonS3.Key | String | Name of uploaded file. Use #FILENAME# placeholder for original file name. This parameter helpfull if you need to upload files into some subfolder of your bucket. Example: 'uploads/#FILENAME#' |
#FILENAME# |
| Upload.AmazonS3.ContentType | String | Content type of uploaded files. Use #AUTODETECT# placeholder to allow MultiPowUpload automatically detect content type. | #AUTODETECT# |