mode |
Transfer method, can be set to either "data" or "macbin", the default is data. This parameter only works on the Mac OS platform. When the method is set to "macbin" U-Upload Pro will automatically encode each file into a Mac Binary format on MAC. MacBinary format is Internet friendly and allows all Mac files to be transferred to other platforms without any problems. IMPORTANT: "macbin" mode will automatically disable ZIP functions
NOTE: Macbinary will not function in OS X 10.2 or higher.
Default value: "data" (MacOS only)
Valid values: "data" or "macbin" |
localdir |
U-Upload will automatically browse this local directory when U-Upload "Browse..." button is pressed. Example would be "c:\\windows" on a Windows machine or "/etc" on Mac or Unix.
Default value: ""
Valid values: "<valid local directory>" |
remotedir |
U-Upload will automatically switch to this directory on the FTP server after a successful login. Example would be "/initialdir". Note that this directory must already exist, or must be specified to be created with the "createdirectoryonstartup" parameter.
Default value: ""
Valid values: "<valid remote directory>" |
exclude |
Allows you to exclude files or directories who's names contain strings specified in this parameter. For example, if you wanted to exclude all files starting with the letters "re", exclude the Program Files directory, and also hide the D:\\ drive this parameter would be set like this: "*re*,Program Files,D:\\". This parameter also allows you to use wildcards to exclude files of a certain pattern. For example, to exclude files that are numbered file1_of_10.txt you could set this parameter to "file*_of_*.txt".
Default value: ""
Valid values: "<comma delimited list of strings>"
|
createdirectoryonstartup |
This param specifies a remote directory that should be created when an FTP connection is established.
Default value: ""
Valid values: "<valid remote directory>" |
filefilterX |
Where X = 1 to N. You can define as many file filters as you want to using this parameter, as long as each value X is distinct. Here are some examples:
var filefilter1 = "All Files (*.*)";
var filefilter2 = "HTML Files (*.htm,*.html)";
var filefilter3 = "Image files (*.gif,*.jpg,*.png,*.bmp)";
These parameters must be of this form to function properly. Notice there are no spaces between the extensions.
Default value: ""
Valid values: "<type name> (*.<extension1>, *.<extension2>, etc...)" |
showdialogs |
Toggles the status, and progress dialogs on and off.
Default value: "true"
Valid values: "true", "false" |
maintainpathinfo |
If this parameter is set to "true", all path info is maintained when files are uploaded. Otherwise the path info is not included.
NOTE: This feature will not work if you are using the "filesetrename" parameter.
Default value: "false"
Valid values: "true", "false" |
autozip |
If this parameter is set to "true", all selected files will be compressed using ZIP compression.
Default value: "false"
Valid values: "true", "false" |
zipfilename |
Used in conjunction with the "autozip" parameter, this parameter specifies the filename for the compressed archive.
Default value: "files.zip"
Valid values: <valid filename> |
zippathinfo |
If this parameter is set to "true", all path info is maintained in the zip archive. Otherwise the path info is not included.
Default value: "false"
Valid values: "true", "false" |
confirmoverwrite |
If this value is set to "true", U-Upload will prompt you if the file(s) already exist on the FTP server. You will have the choice to overwrite if you want to. If it is set to false, U-Upload will always overwrite.
Default value: "true"
Valid values: "true", "false" |
callurlaftertransfer |
U-Upload Pro will redirect to this URL when the transfer is complete and was successful.
Default value: ""
Valid values: "<valid URL>" |
callurlaftertransfertarget |
Used in conjunction with callurlaftertransfer, this parameter specifies the target for the redirection.
Default value: "-self"
Valid values: "_top", "_blank", "_self", etc... |
transfererrorurl |
U-Upload Pro will redirect to this URL if an error occurred during the file transfer, or the network connection is terminated. This URL is also called if U-Upload has attempted to restart the transfer more than the number of tries specified by the "maxRetries" parameter.
Default value: ""
Valid values: "<valid URL>" |
transfererrorurltarget |
Used in conjunction with transfererrorurl, this parameter specifies the target for the redirection.
Default value: "-self"
Valid values: "_top", "_blank", "_self", etc... |
transfercancelurl |
U-Upload Pro will redirect to this URL if the transfer is canceled.
Default value: ""
Valid values: "<valid URL>" |
transfercancelurltarget |
Used in conjunction with transfercancelurl, this parameter specifies the target for the redirection.
Default value: "-self"
Valid values: "_top", "_blank", "_self", etc... |
redirectfilenotexisturl |
U-Upload Pro will redirect to this URL if, when the Send button is pressed, the selected file(s) do not exist.
Default value: ""
Valid values: "<valid URL>" |
redirectfilenotexisturltarget |
Used in conjunction with redirectfilenotexisturl, this parameter specifies the target for the redirection.
Default value: "-self"
Valid values: "_top", "_blank", "_self", etc... |
othererrorurl |
U-Upload Pro will redirect to this URL if any other errors occur. This may include login or connections errors.
Default value: ""
Valid values: "<valid URL>" |
othererrorurltarget |
Used in conjunction with othererrorurl, this parameter specifies the target for the redirection.
Default value: "-self"
Valid values: "_top", "_blank", "_self", etc... |
site |
This is an FTP Site command that will be performed immediately before the upload is initiated. This is useful for connecting to FTP server that require a specific file format to be specified before transferring. Setting this to a value of "help" would result in "SITE help" being sent to the FTP server.
Default value: ""
Valid values: "<valid FTP SITE command>" |
autoupload |
Used in conjunction with "fileset" parameter, if set to "true" U-Upload will automatically begin transferring the files specified in "fileset" once it loads.
NOTE: This parameter only works in licensed versions.
Default value: "false"
Valid values: "true", "false" |
fileset |
This parameter will add files to U-Upload as a semicolon delimited list of full paths to files. When used with the "autoupload" you can completely automate the upload of files. Here is an example:
fileset = "c:\\temp\\file1.exe;c:\\images\\image.jpg;d:\\Program Files\\file2.exe";
or on UNIX or Mac
fileset = "/home/joebloe/web/index.html;/tmp/image.jpg";
You can also specify a widcard value to only upload files of a certain type, for example:
fileset = "/home/joebloe/*.jpg;/tmp/*.gz";
Default value: ""
Valid values: <semicolon delimited list of file paths> |
filesetrename |
Used with the "fileset" parameter, this parameter allows you to rename files as they are transferred to the FTP server. A valid value for this parameter will be a semicolon delimited list of remote file names. Note: no path is required for these values as they will be stored in the directory specified in the "remotedir" parameter. Note that the number of values in the list must be equal to the number of values in the "fileset" parameter or this parameter will be ignored. It will also be ignored if you use wildcards in the fileset parameter. If this parameter is set, the "maintainpathinfo" parameter is automatically disabled. Here is an example usage:
filesetrename = "file1.exe;image.jpg;file2.exe";
Default value: ""
Valid values: <semicolon delimited list of filenames> |
maxfiles |
Uploads will be limited to this number of files. If left blank, there is not limit.
Default value: ""
Valid values: <integer value> |
enableResume |
This parameter allows you to control whether U-Upload allows transfers to be resumed. It can be set to "true", the user will be prompted to resume is possible, "false", the user can not resume, and "auto", U-Upload will resume whenever possible without asking.
Default value: "true"
Valid values: "true", "false", "auto" |
appendFilesToURL |
If set to true, the files that were uploaded will be appended to the end of the URL specified in the "callurlaftertransfer" parameter. The parameter name will be specified by the "filesTransferredParameter" parameter. i.e.
If you uploaded the files c:\temp\file1.txt and c:\autoexec.bat and your "callurlaftertransfer" parameter was set to "http://www.unlimitedftp.ca/processfiles.jsp" the the following URL will be called after the transfer is complete:
http://www.unlimitedftp.ca/processfiles.jsp?filesTransferred=file1.txt;autoexec.bat
Default value: "false"
Valid values: "true", "false" |
filesTransferredParameter |
Specifies the name of the parameter used to pass the list of uploaded files to the "callurlaftertransfer" parameter.
Default value: "filesTransferred"
Valid values: "<URL friendly string>" |
showsizeanddate |
If set to true, the browse dialog will display the file name including the file size and date attribute. If set to false, only the file name will be displayed.
Default value: "false"
Valid values: "true", "false" |
showservername |
If set to false, the remote server domain or IP will not be shown in the connecting dialog.
Default value: "true"
Valid values: "true", "false"
Note: If this parameter is disabled, it is recommended that you change the DIALOG.BUSY.CONNECTING entry in the language file to "Connecting" instead of its default value of "Connecting To" |
delimiter |
This will be the delimiter for the files listed in the text field. Note that setting this parameter also effects the "fileset" parameter. The list of files specified in "fileset" must be delimited by the value specified in the "delimiter" parameter.
Default value: ";"
Valid values: "any character" |
removeaccentsandquotes |
If set to true, U-Upload will convert accented characters in a filename to non-accented characters.
Default value: "false"
Valid values: "true", "false" |
removespaces |
If set to true, U-Upload will replace all spaces in a filename to an underscore character.
Default value: "false"
Valid values: "true", "false" |
browsenative |
If set to true, U-Upload Pro will use a native file dialog, rather than the built in file dialog. This allows you to take advantage of the features native dialogs offer, thumbnails for example. However, due to a Java limitation, it will limit you to selecting one file at a time.
NOTE: The "showsizeanddate" parameter is automatically disabled if you set "browsenative" to "true"
Default value: "false"
Valid values: "true", "false" |
useTempName |
This parameter is used in conjunction with the "useSerfo". When uploading via UnlimitedFTP.Secure, files are broken into small pieces and uploaded and reassembled on the FTP server using the APPE command. Setting this parameter to "true" will cause the uploaded file to be stored under a temporary name until the upload is complete. At that time it is renamed to the original filename.
Default value: "false"
Valid values: "true", "false" |
totalProgress |
U-Upload can show the progress of an entire upload, or progress of individual files. By default, the progress of the entire upload is shown.
Default value: "true"
Valid values: "true", "false" |
siteCommandStor |
Setting this parameter allows you to execute a custom SITE command after each file is uploaded. This parameter also accepts wildcards which are automatically replaced by the full path of the file that was just uploaded. Example:
var siteCommandStor = "processfile *";
This would result in U-Upload sending the following command to your FTP server after each file is uploaded:
SITE processfile /pathtofile/filename.txt
Default value: ""
Valid values: "<valid FTP SITE command>" |
postURL |
If set to a valid url, U-Upload will do an HTTP POST to the specified URL with a list of all uploaded files delimited by the delimiter as set.The url will also contain information regarding base directory and total size of all uploaded files onto the ftp server. The parameters will be called "f", "baseDir", and "totalSize" respectively.
Default value: ""
Valid values: "<valid URL>" |
sendLogsToURL |
If set to "true", U-Upload will do an HTTP POST to the specified URL with a log of the FTP session when the applet is exited (browser closed, or page unloaded), or when the page is redirected. The POST will contain a parameter called "logs", and the value will be the FTP session log.
Default value: ""
Valid values: "<valid URL>" |