U-Upload Cart Secure Documentation

1 Overview

1.1 Introduction
1.2 Features
1.3 Known Issues

2 Installation

2.1 Deploying to a web server
2.2 Embedding the applet into your page
2.3 Minimum configuration

3 Using U-Upload Cart Secure

3.1 Minimum System Requirements
3.2 User Interface
3.3 Running U-Upload
3.4 Directory browsing
3.5 Selecting files and directories
3.6 Uploading files

4 Configuring U-Upload Cart Secure

4.1 Connection parameters
4.2 Proxy parameters
4.3 Functionality related parameters
4.4 Color settings
4.5 Error URL parameters
4.6 Language settings and internationalization

5 Advanced Features

5.1 Advanced file selection
5.2 Loading U-Upload dynamically
5.3 Integrating U-Upload with your web applications

6 Support

6.1 Support forums
6.2 Other support options

7 Version History

7.1 Version History




1 Overview

1.1 Introduction

U-Upload Cart Secure is an FTP file upload applet with over 50 customizable parameters and an advanced file selection interface. Using U-Upload Cart Secure's parameters, you can create a fully customized and simple to use file/image upload site for your users.

Consult section 2 of this document for configuration and installation notes

Please also review the Readme and License files.

1.2 Features

The following is a list of the main features of U-Upload Cart Secure.

  • Tailored for Print/Image Upload
  • Image file preview
  • Advanced file selection interface
  • Maintain all resource forks on Mac using Mac Binary encoding on Mac Classic, and DMG format on OS X

1.3 Known Issues

  1. Parameter "mode" in uuploadcartsecure.js file.

    The "mode" parameter in uuploadcartsecure.js file, when set to "macbin" for Mac, will not function for   Mac OS 10.2 or higher. Setting  mode parameter to "macbin" will transfer any Windows or Mac file in data mode. See Section 4.3 for a more complete description. As of v1.3, Mac OSX can now maintian resource forks using the "autoDmg" parameter.

  2. Opera browser on Mac (all versions) behaves erratically, and is not supported.
  3. Firefox on Mac OSX is not yet officially supported although it may function. Until the Java Embedding Plug-in v1.0 is released this will continue to be the case.
  4. Network interruptions for Mac Classic (Mac OS 9.1 and Mac OS 10.1.5)

    With the network cable unplugged, Mac Classic will auto resume upload of the same file irrespective of any  waitRetry or waitRetries parameter set in the uuploadcartsecure.js file. Seesection 4.1

2 Installation

2.1 Deploying to a web server

  1. Extract the contents of uuploadcartsecure.zip to your local hard disk using a zip utility
  2. Create a directory on your web server. For example /uupload.
  3. Upload all files extracted in Step 1 to the directory you created on the web server in Step 2.
     Important:
    When uploading files make sure that you upload files in binary mode.
  4. Go to test page located at the URL http://yourserver.com/uupload/index.html, where yourserver.com is replaced by your domain name. Example: http://www.utechsoft.com.com/uupload/index.html
  5. To customize the functionality of U-Upload Cart Secure, edit the file uuploadcartsecure.js with a text editor such as Notepad. Each of the customizable parameters is defined below in Section 4
  6. Upload the new uuploadcartsecure.js to your web server.

2.2 Embedding the applet into your page

Embedding the applet into your webpage is simple. In an appropriate spot of your HTML, add the following line:

<script language="javascript" src="uuploadcartsecure.js"></script>

In the above example, uuploadcartsecure.js must be in the same directory as your page. You may instead set the "src" parameter to indicate a path to the script.

To customize U-Upload Cart Secure, you will typically edit "uuploadcartsecure.js" with an HTML/text editor and set your variables appropriately. Most variables are fairly self-explanatory, but this document provides full descriptions of each. The tables beginning in Section 4.1 serve as a guide to customizing U-Upload Cart Secure's parameters.

2.3 Minimum configuration

U-Upload Cart Secure  requires a minimum configuration in order to function. You must setup the "server", "user" and "pass" parameters so U-Upload Cart Secure can connect to your FTP server and upload files. To do this you must edit file uuploadcartsecure.js with a text editor and set the values to reflect your FTP server. For example:

//Connection related values

var server = "ftp.yourserver.com";
var port = "";
var user = "username";
var pass = "password";

Additional configuration parameters are described in Section 4

3 Using U-Upload Cart Secure

3.1 Minimum System Requirements

The minimum system requirements for using U-Upload Cart Secure are as follows:

  • Operating Systems: Windows 98/2000/XP/ME, Mac OS 8.x, 9.x, 10.x, Linux, Unix
  • Browser: Internet Explorer, Netscape Navigator, Opera. Mozilla, Safari, Firefox
  • Browser Java VM: Java 1.1 or above enabled for Lite and Pro, Java 1.4 or above for Secure
  • FTP server (must be accessible from your machine)

3.2 User Interface

Below is a screen shot of the U-Upload Cart Secure user interface. Depending on your Operating System and browser, as well as the parameters you have configured, your display may differ slightly.

Fig 3.1 The U-Upload Cart Secure interface
U-Upload Cart UI
  1. Directory Listing - Displays the files / directories within a directory on local machine.
  2. Selection Preview Box -This box will let you preview a image file before uploading onto the ftp server.
  3. Upload button - This button will upload files in the cart to the ftp server.
  4. Add, Add All, Remove, Remove All buttons.
Add all button This button will let you add all the files from browse pane to U-Upload Cart Secure.
Add single button This button will let you add a single file from browse pane to U-Upload Cart Secure. If a folder is selected, this button will add the entire contents of the folder to U-Upload Cart Secure.
Remove button This button will let you remove a single file from U-Upload Cart Secure. This button will also remove an entire folder from U-Upload Cart Secure.
Remove all button This button will let you remove all files and/or folders from U-Upload Cart Secure.
Help button This button will display the U-Upload Cart Secure usage instructions.

3.3 Connecting to an FTP server

To load U-Upload Cart Secure, use your web browser to open the test page you uploaded during installation. See Deploying to a web server. Upon loading U-Upload Cart Secure  a dialog will be presented similar to the one shown below asking you to confirm that you trust the certificate used to sign the applet. The dialog may vary depending on the browser you use. You must accept this dialog for the applet to continue loading. To avoid this dialog from being displayed each time you connect click on the "Always trust content from Unlimi-Tech Software Inc." checkbox in IE, or on the "Always" button if you use Sun's Java Plugin. This dialog ensures that U-Upload Cart Secure is a trusted application, and you wish to allow it to run with full permissions.

WINDOWS 2000

Win2K Certificate
Fig 3.2.1 Internet Explorer with Microsoft VM security warning

Plugin Security Warning
Fig 3.2.2 Sun Java Plugin security warning

WINDOWS XP

IE Security Toolbar
Fig 3.2.3 Internet Explorer with security warning
IE Security Toolbar
Fig 3.2.4 Sun Java Plugin security warning
IE Security Toolbar
Fig 3.2.5 Microsoft Java Plugin security warning

MAC OS X

Security warning on Mac OSX Safari
Fig 3.3 Safari Browser with security warning

Once you have accepted the certificate dialog, U-Upload Cart Secure will continue loading.

3.4 Directory browsing

When U-Upload Cart Secure is loaded, U-Upload Cart Secure will display a list box similar to the one displayed in Figure 3.4 below. Folders are identified by the folder icon and files are identified by the file icon . To see the contents of a sub folder, double click on its icon. You may return to a parent folder by clicking on the parent folder icon .

Directory browsing may also be done using the keyboard using the up/down arrows and the Enter key. You may quickly move the list to a file beginning with a certain letter by pressing the first letter of that file on your keyboard. Pressing Enter on a folder will automatically enter that folder for browsing.

Fig 3.4 U-Upload Cart Secure browse list box
U-Upload Cart file list

You may browse using the up/down arrow keys on your keyboard. Quickly move to a file beginning with a certain letter by pressing the first letter on your keyboard. Pressing ENTER on a folder will automatically open that folder for browsing. Pressing ENTER with a file selected will initiate an upload or download depending on whether you are browsing the local or remote directory.

U-Upload Cart Secure provides quick access to the Desktop and My Documents folders for Windows users, or the Home and Finder folders for Mac users.

3.5 Selecting files and directories

To select a file or folder, click on the item in the directory listing using your mouse. You may select a multiple of files by holding down the SHIFT key and selecting the first and last file in the desired range. Alternatively you may select multiple items by holding the CTRL key and selecting each item using your mouse. When you have selected the files you wish to upload, click on the Add button. Mac OS 9.x users may use the left and right arrow buttons to select multiple files. Alternatively, you can select the files by using drag and drop feature of U-Upload Cart Secure. Simply drag the desired files into the Upload Cart.

3.6 Uploading Files

To upload the files you have selected, simply click on the "Upload" button and the file upload should be initiated. Depending on your configuration, you will see a progress status dialog similar to the one in Figure 3.5 below. Once the upload is complete, depending on the configuration, U-Upload Cart Secure may redirect to another web page.

Transfer dialog
Fig 3.5 Progress status

4 Configuring U-Upload Cart Secure

These settings can be configured in uuploadcartsecure.js. Note that every time you change these settings, you will need to upload the modified uuploadcartsecure.js file.

4.1 Connection parameters

These parameters control how U-Upload Cart Secure will establish the connection to the FTP server. Please note that some parameters are only available in certain versions. The U-Upload Cart Secure version that supports the particular parameter is noted under the description of each parameter.

Connection-related Settings
server

The host name or IP address of the FTP server.

Default value: ""
Valid values: "<valid hostname or IP address>"

port

The port number of the FTP server. Typically, FTP uses port 21.

Default value: "21"
Valid values: "<valid port number>"

pass

The password for the FTP server account.

Default value: ""

user

The username for the FTP server account.

Default value: ""

passive

If set to "true", all data connections will be outgoing. U-Upload Cart Secure works through firewalls when this value is set to "true". If you are using an FTP proxy, set this value to "false".

Default value: "true"
Valid values: "true", "false"

encrypt

If set to "true" you must pass encrypted user/pass/server parameters to U-Upload Cart Secure, which will decrypt them and perform the login. The encryption is based on a key value that is specified by the "ek" parameter below. To encrypt parameters you can use encrypt.html that was downloaded with U-Upload Cart Secure. This provides at least some measure of protection from prying eyes, and people who love to snoop through your HTML.

Although this seems very un-secure to include the encryption algorithm along with the applet, keep in mind this is only a way to hide login credentials from users who try to view the HTML source of your page. Determined hackers will easily be able to sniff the network to retrieve user and password info regardless of the encryption done in the HTML.

Default value: "false"
Valid values: "true", "false"

ek

This parameter works in conjunction with the "encrypt" parameter. This is the key that is used to encode/decode the string value you pass to the user, pass, and server parameters. Here is an example configuration. In this example, the server/user/pass strings are 192.168.1.100/anonymous/uftp@uuploadcartsecure.com respectively. This illustrates how the parameters will look to anyone who inspects the connection values in your HTML:

var server = "8I7BLHN;8I8@5";
var port = "21";
var pass = "|vy&[)&yp*p&jx#((;j,t";
var user = "h~t$6!=$z";
var autoconnect = "true";
var autoreconnect = "true";
var passive = "true";
var encrypt = "true";
var ek = "encryptkey";

Default value: ""
Valid values: "<string value>"

connecttimeout

This value (in milliseconds) specifies how long U-Upload Cart Secure will try to connect to an FTP server before giving up and timing out.

Default value: "20000"
Valid values: "<integer value>"

sotimeout

This value (in milliseconds) specifies how long a data connection will wait to read data before giving up and timing out.

Default value: "-1" means no timeout
Valid values: "<integer value>"

waitRetry

This value (in milliseconds) specifies how long U-Upload Cart Secure 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>"

maxRetries

This value specifies how many times U-Upload Cart Secure will try, if a transfer error occurs, to reconnect and resume the transfer.

Default value: "1"
Valid values: "<integer value>"

useSerfo

If set to true, U-Upload Cart Secure will attempt to open an FTP connection through the Service Forwarding Agent at the URL specified by the "SerfoLocation" parameter below.

If set to auto, U-Upload Cart Secure will first attempt to open a regular FTP connection, and if it fails, it will retry through the Service Forwarding Agent at the URL specified by the "SerfoLocation" parameter below.

Default value: "false"
Valid values: "true", "false", "auto"

serfoLocation

The location of the Service Forwarding Agent servlet. Please visit http://www.utechsoft.com/uftps for more information.

Default value: ""
Valid values: "<valid URL>"

4.2 Proxy settings

These parameters allow you to configure U-Upload Cart Secure to connect through a SOCKS4 or FTP proxy server. Please contact your network administrator or ISP to determine if you use a proxy server for FTP.

Proxy server related settings. (Internet Explorer Only)
autodetectproxy

If this value is set to "true", U-Upload Cart Secure will automatically attempt to detect Internet Explorer's Proxy setup and use it when connecting to FTP servers. This will detect both SOCKS 4 proxy settings, and FTP proxy settings.

Default value: "false"
Valid values: "true", "false"

socksproxy

If this value is set to "true", U-Upload Cart Secure will use the SOCKS proxy server and port specified by the "socksProxyHost" and "socksProxyPort" parameters.

Default value: "false"
Valid values: "true", "false"

socksProxyHost

SOCKS proxy server location.

Default value: ""
Valid values: "<valid hostname or IP address>"

socksProxyPort

SOCKS proxy server port.

Default value: ""
Valid values: "<valid port number>"

ftpproxy

If this value is set to "true" and socksproxy is set to "false", U-Upload Cart Secure will use the FTP proxy server and port specified by the "ftpProxyHost" and "ftpProxyPort" parameters.

Default value: "false"
Valid values: "true", "false"

ftpProxyHost

FTP proxy server location.

Default value: ""
Valid values: "<valid hostname or IP address>"

ftpProxyPort

FTP proxy server port.

Default value: ""
Valid values: "<valid port number>"

4.3 Functionality-related settings

These parameters determine how U-Upload Cart Secure will behave under certain circumstances after a connection is established. Please read the descriptions carefully before attempting to use these settings.

Functionality related settings
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 Cart Secure 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:Setting macbin will still transfer windows files in data mode.

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 Cart Secure will automatically browse this local directory when first loaded into the browser. For example, "c:\\windows" on a Windows machine or "/etc" on Mac or Unix.

Default value: ""
Valid values: "<valid local directory>"

remotedir

U-Upload Cart Secure 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>"

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>

rezip

If set to "true", U-Upload will re-zip files that are already in Zip format.

Default value: "false"
Valid values: "true", "false"

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"

createdirectoryonstartup

This parameter specifies a remote directory that should be created when an FTP connection is established.

Default value: ""
Valid values: "<valid remote directory>"

confirmoverwrite

If this value is set to "true", U-Upload Cart Secure 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 set to false, U-Upload Cart Secure will always overwrite.

Default value: "false"
Valid values: "true", "false"

callurlaftertransfer

U-Upload Cart Secure will redirect to this URL when the transfer is complete and was successful. The url will be appended with a common base folder of all the files uploaded and total size of all uploaded files.

NOTE: if you are simply testing with a URL like http://www.utechsoft.com, you should append a / on the end to avoid 404 errors.

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 Cart Secure 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 Cart Secure 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 Cart Secure 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...

othererrorurl

U-Upload Cart Secure will redirect to this URL if any other errors occur. This may include login or connection 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 executed 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>"

maxfiles

This parameter specifies the maximum number of files that can be uploaded onto the ftp server.

Default value: "1000"
Valid values: "<valid numbers>"

maxsize

This parameter specifies the limit on the size of a file which can be uploaded onto the ftp server.

Default value: "104857600"
Valid values: "<number>"

extensions

This parameter specifies the file filter for U-Upload Cart Secure directory list box. Only those files of extension type as specified are listed on the directory list box. If more than one type of extension is specified, they have to be delimited by a comma (,).

Note: In order for this parameter to function properly wild card asterisk (*) and dot (.) must not be preceded with the extension. For example:

Valid values: "jpg,bmp,txt" // legal
Invalid values: "*.jpg,*.bmp,*.txt>" // illegal

Default value: ""
Valid values: "<extension 1, extension 2,...,extension n>"

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>"

delimiter

Used in conjunction with postURL parameter, this parameter specifies the delimiter in between the list of files to the url as set for postURL parameter.

Default value: "#,#"
Valid values: "<valid delimiter>"

sendLogsToURL

If set to a valid URL, U-Upload Cart Secure will do an HTTP POST to the specified URL with a log of the FTP session when the applet is terminated (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>"

postURL

If set to a valid URL, U-Upload Cart Secure 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 files uploaded to the FTP server. The parameters will be called "f", "baseDir", and "totalSize" respectively.

Default value: ""
Valid values: "<valid URL>"

maintainpathinfo

If this parameter is set to "true", all path info is maintained when files are uploaded. Otherwise the path info is not included. This parameter will also maintian the absolute path info regarding target file of uploaded windows shortcut (.lnk) files.

Default value: "true"
Valid values: "true", "false"

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 with an underscore character.

Default value: "false"
Valid values: "true", "false"

removePathsFromPostData

If set to true, U-Upload will strip path information from the file data that is sent to the URL specified in the postURL parameter.

Default value: "false"
Valid values: "true", "false"

autoDmg

If set to true, on Mac OS X 10.1 or higher U-Upload will create a DMG disk image that contains all selected files and upload the DMG to the FTP server. The DMG file maintains all resource forks.

Default value: "false"
Valid values: "true", "false"

dmgFileName

When using the "autoDmg" parameter, this allows you to specify the name of the DMG file that is created and uploaded to the FTP server.

Default value: "files.dmg"
Valid values: "<valid filename>"

postArchiveContents

If set to "true", this will post the contents of any Zip or DMG file created rather than posting the name of the archive itself. This is used in conjunction with the "postURL" parameter.

Default value: "false"
Valid values: "true", "false"

addAllFilesAndDirectories

By default, clicking the "Add all" button will add all files and directories in in the current working directory into the upload queue. Setting this value to false will force U-Upload to only add files and not directories.

Default value: "true"
Valid values: "true", "false"

showThumbnails

If set to "true", U-Upload Cart Secure will show thumbnails of image file son the left hand browse pane while the use is browsing.

Default value: "false"
Valid values: "true", "false"

thumbsPerPage

This parameter limits the number of thumbnails per page to improve browsing speeds.

Default value: "5"
Valid values: "<valid integer>"

thumbSize

This specifies the maximum size of the side (in pixels) of the thumbnails displayed in the right hand pane.

Default value: "100"
Valid values: "<valid integer>"

checksize

If set to "true", the file size will be verified after upload is complete. This relies on the SIZE command being implemeneted on the FTP server. If you see errors with this feature enabled, your FTP server likely doesn't support the SIZE command.

Default value: "false"
Valid values: "true", "false"

4.4 Color and Interface settings

These parameters control the various visual elements of the U-Upload Cart Secure interface. They allow you to blend the color scheme of U-Upload Cart Secure with that of your existing web page.

UI related settings
language

U-Upload Cart Secure allows you to customize the language of the text on the interface. To do this, edit the contents of "lang_en.txt" which is included in the download archive. Save the file with an appropriate language code. Example for French might be "lang_fr.txt". This parameter should then be set to "fr".

Default value: "en"
Valid values: "<language code>" - There must also be a definition file named lang_<language code>.txt in the same directory as uuploadcartsecure.jar.

bgcolor

Allows you to change the background of the applet using standard RGB (Red, Green, Blue) values separated by a comma. For example white = 255,255,255

Default value: "255,255,255"
Valid values: "<valid RGB values between 0 and 255>"

width

Width of the U-Upload Cart Secure applet.

Default value: "500"
Valid values: "<valid integer (in pixels)>"

height

Height of the U-Upload Cart Secure applet.

Default value: "150"
Valid values: "<valid integer (in pixels)>"

showlocaladdressbar

This parameter toggles the visibility of localaddressbar on top of directory list box to be on or off.

Default value: "true"
Valid values: "true", "false"

showpreview

This parameter toggles the visibility of selection preview box to be on or off.

Default value: "true"
Valid values: "true", "false"

uploadButtonLocation

This parameter specifies the placement of Upload button on Upload Cart applet. In this version of Upload Cart Upload Button can only be placed on top or bottom of the applet. Invalid value if specified will be overridden with the default value of this parameter.

Default value: "NORTH"
Valid values: "NORTH", "SOUTH"

4.5 Error Page URLs

These parameters allow you to define your own error pages for different types of errors that can occur when a user attempts to load U-Upload Cart Secure.

Customizable Error Pages
errNavWin

This error page will be called when the user is running Windows and their Netscape version is not sufficient to run U-Upload Cart Secure.

Default value: ""
Valid values: "<valid URL>"

errIEWin

This error page will be called when the user is running Windows and their Internet Explorer version is not sufficient to run U-Upload Cart Secure.

Default value: ""
Valid values: "<valid URL>"

errIEWinVM

This error page will be called when the user is running Windows with Internet Explorer and the Microsoft VM for Java is not sufficient to run U-Upload Cart Secure.

Default value: ""
Valid values: "<valid URL>"

errNavUnix

This error page will be called when the user is running Unix and their Netscape version is not sufficient to run U-Upload Cart Secure.

Default value: ""
Valid values: "<valid URL>"

errIEMac

This error page will be called when the user is running Mac OS and their Internet Explorer version is not sufficient to run U-Upload Cart Secure.

Default value: ""
Valid values: "<valid URL>"

errNavMac

This error page will be called when the user is running Mac OS, and their Netscape version is not sufficient to run U-Upload.

Default value: ""
Valid values: "<valid URL>"

errOperaWin

This error page will be called when the user is running Opera browser and the version is not sufficient to run U-Upload Cart Secure.

Default value: ""
Valid values: "<valid URL>"

rejectPermissionURL

This error page will be called when the user rejects the security certificate or does not grant the permissions required for U-Upload Cart Secure to run.

Default value: ""
Valid values: "<valid URL>"

4.6 Secure FTP Settings (secure version only)

U-Upload Cart Secure's language settings allow you to customize the text on the applet. This can be accomplished by modifying the text elements provided in the lang_en.txt file. Alternatively if you wish to provide support for multiple languages you may create a separate language file for each language you wish to support. Using this method you can dynamically load the language file based on the "language" parameter provided to U-Upload Cart Secure.

For example, if you wish to create a language file that contains the text elements for the German language then follow these steps:

  1. Copy the default lang_en.txt file to a new file named lang_de.txt
  2. Update the text element values in lang_de.txt providing the German equivalents.
  3. Adjust the language parameter of U-Upload Cart Secure with the value of "de".
  4. Upload lang_de.txt and the modified uuploadcartsecure.js files to the web server directory that contains U-Upload Cart Secure.

Note: If no language parameter is provided then the default lang_en.txt file is used.

5 Advanced Features

5.1 Advanced file selection interface

U-Upload Cart Secure will let you automatically preview any image files before uploading the same. If there is no preview available U-Upload Cart Secure will display the default preview for non image file.See Section 3.2 for selection preview box.

5.2 Loading U-Upload Cart Secure dynamically

In some cases, it may be desirable to load the U-Upload Cart Secure applet dynamically using JavaScript or using a server side scripting language such as JSP, PHP or ColdFusion. If this is the case, you may want to move the contents of uuploadcartsecure.js into your dynamic page by cutting and pasting the entire source in between two <script> tags. You can then replace the variable values with values obtained from your dynamic page. Here is an example:

<%
String username = "anonymous" ;
String password = "uftp@nlimitedftp.com" ;
String hostname = "ftp.sun.com" ;
String port = "21" ;
%>

<script>

// Connection related values


var server = " <%= hostname %> " ;
var port = " <%= port %> " ;
var pass = " <%= password %> " ;
var user = " <%= username %> " ;

...

</script>

5.3 Integrating U-Upload Cart Secure with your web application

Further to loading U-Upload Cart Secure  dynamically, you may want to fully integrate U-Upload Cart Secure into your web application's workflow. To do this we provide a way to automatically redirect after the upload is complete. This allows you to use U-Upload Cart Secure as a means to move the files to your FTP server. There are 4 URLs you can use to redirect after uploads are complete. "callurlaftertransfer", "transfererrorurl" , "transfercancelurl", "othererrorurl". All of these are described in Section 4.3.

U-Upload also provides the "postURL" and "sendLogsToURL" parameters, also described in Section 4.3.

6 Support

6.1 Support Portal

Our support web site is available 24/7 is a great place to get answers: http://support.filecatalyst.com Be sure to search the knowledge base as well as visit the forums (one of the buttons in the header).

6.2 Phone, email and chat support

Phone and live chat are available 9am - 5pm EST.

7 Version History

7.1 Version History

New features and bugs fixed in version 1.3.1

New features and bugs fixed in version 1.3.0

New features and bugs fixed in version 1.2.2

New features and bugs fixed in version 1.2.1

New features and bugs fixed in version 1.2

New features and bugs fixed in version 1.0.1