U-Download Documentation

To customize U-Download HTTP, you must edit "udhttpscript.js" with an HTML/text editor. You can then use the following tables as a guide to customizing each of U-Download HTTPs parameters. Then add the following line to your HTML file: <script language="javascript" src="udhttpscript.js"></script> You must also make sure that you either put udhttpscript.js in the same directory as your page, or the src parameter reflects the location of the script file. If you require further assistance with setup, or are interested in related products and customization services, e-mail us at info@utechsoft.com, or visit our website. For information about pricing, or to order U-Download HTTP, click here. Please also review the Readme and License files.

File related settings

urls The list of URLs of files to be downloaded. You can set the delimiter using the "delimiter" parameter. Default value: "" Valid values: "<delimited list of valid URLs of files >" localfilenames A list of filenames. Each of the downloaded files will be renamed to the corresponding value in this list of file names. The first URL to be downloaded, will be renamed to the first filename in this list. If the local filename contain a path, that path will be created as a sub-directory of the path the user selected for download. If this parameter is left blank, or the number of filenames does not match the number or URLs, the files will not be renamed. You can set the delimiter using the "delimiter" parameter. Default value: "" Valid values: "<delimited list of filenames>" localdir This parameter specifies the directory will see when they click the "Browse" button. Default value: "" Valid values: "<valid local path>" createlocaldir This parameter lets you specify a new directory that will be created under the directory the user selects. For example, if the user selected their Desktop folder, and you set "createlocaldir" to "downloads", then a new folder would appear on their desktop called "downloads". Default value: "" Valid values: "<name of the path you want created >"

 

Functional settings

callurlaftertransfer The applet will automatically redirect to this URL when the transfer is successful. The status of the downloads will be appended to the URL(and also the cancel and error URLs) in a parameter called "status". It is a string of integers that map to the status of each file to be downloaded. The possible status's include: SUCCESS = 1 CANCELLED = 2 ERROR = 3 NOTATTEMPTED = 0 For example, if you attempted to download 4 files, and it was cancelled on file number 3, the parameter would look like this: status=1120 If the transfer failed on file 2 the parameter would look like this: status=1300 Default value: "" Valid values: "<valid website URL>" callurlaftertransfertarget The target for the redirection to the URL specified by "callurlaftertransfer" Default value: "_top" Valid values: "_top","_blank","_parent", etc... cancelurl The applet will automatically redirect to this URL if the download was cancelled. Default value: "" Valid values: "<valid website URL>" cancelurltarget The target for the redirection to the URL specified by "cancelurl" Default value: "_top" Valid values: "_top","_blank","_parent", etc... errorurl The applet will automatically redirect to this URL if an error occurred during the download. Default value: "" Valid values: "<valid website URL>" errorurltarget The target for the redirection to the URL specified by "errorurl" Default value: "_top" Valid values: "_top","_blank","_parent", etc... maxretries This value specifies how many times U-Download will try, if a transfer error occurs, to reconnect and resume the transfer. Default value: "1" Valid values: "<integer value>" waitretry This value (in milliseconds) specifies how long U-Download will wait, if a transfer error occurs, before it tries to reconnect and resume the transfer. Default value: "3000" (3 seconds) Valid values: "<integer value>" totalProgress If set to "true", the applet will display the progress of the current file as well as the progress of all files. Note that is relies on the HEAD command to get file sizes before the transfers begin. If you experience delays in the start of the download, you should disable this feature. Default value: "false" Valid values: "<true or false >" progBarGraphic This parameter specifies an image file that will be displayed on the progress dialog. The image file can be GIF or JPG format, and should be 200 pixels wide by 30 pixels high to fit properly. Default value: "" Valid values: "<valid URL to an image file >" delimiter This parameter specifies the delimiter that will be used to separate URLs and filenames passed into U-Download. Default value: "," Valid values: "<any string you want to use for a delimiter >" autodownload If set to "true", the Browse button will be hidden, and upon loading, the applet will automatically launch the browse dialog bypassing the browse button. This parameter is not active unless the software is licensed. Default value: "false" Valid values: "<true or false >"

 

Color related settings

background The background color of the applet itself. Default value: "255,255,255" Valid values: "<valid RGB values between 0 and 255>" buttonTextColor The color of the text on the download button. Default value: "0,0,0" Valid values: "<valid RGB values between 0 and 255>" buttonbackground The background color of the download button. Default value: "81,132,81" Valid values: "<valid RGB values between 0 and 255>"

 

Interface and Layout related settings

buttoncaption This value defines the text on the button. This parameter is not active unless the software is licensed. Default value: "" Valid values: "<text string>" width Default value: "250" Valid values: "<integer value (in pixels)>" height Default value: "50" Valid values: "<integer value (in pixels)>"