U-Upload Lite

1 Overview

1.1 Introduction
1.2 Features
1.3 Known Issues

2 Installation

2.1 Deploying to a web server
2.2 Embedding and customizing the applet
2.3 Minimum configuration

3 Using U-Upload

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

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

5 Advanced Features

5.1 Using U-Upload Lite dynamically
5.2 Integrating U-Upload with your web application

6 Support

6.1 Support forums
6.2 Phone, Email, and chat support




1 Overview

This guide is intended to be a complete guide to U-Upload Lite, and will provide information for installing and customizing the applet.

1.1 Introduction

U-Upload Lite provides the same basic functionality as U-Upload Pro and U-Upload Secure from the U-Upload Family, without secure transfer options and with reduced customizability.

Consult section 2 of this document for configuration and installation notes

Please also review the License files.

1.2 Features

The following is a list of the main features of U-Upload Lite:

1.3 Known Issues

 

2 Installation

2.1 Deploying to a web server

  1. Extract the contents of uuploadlite.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: you must upload to your server 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

2.2 Embedding and customizing the applet

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

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

Using this method, uupload.js must be in the same directory as the applet and the page that loads it. You may instead set the "src" parameter to indicate a path to the script, which should still be in the same directory as the applet .jar file.

To customize U-Upload, you will typically:

  1. edit "uuploadlite.js" with an HTML or 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's parameters.
  2. Upload the new uuploadlite.js to your web server.

2.3 Minimum configuration

U-Upload Lite requires a minimum configuration in order to function. You must set the "server", "user" and "pass" parameters so U-Upload can connect to your FTP server and upload files. To do this you must edit the file uuploadlite.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 Lite

3.1 Minimum System Requirements

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

3.2 User Interface

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

U-Upload Pro/Secure UI
Fig 3.1The U-Upload interface
  1. List of selected files - Displays all of the files that have been selected
  2. Browse button -This button allows you to browse your computer and select files you wish to upload.
  3. Send button - This button will initiate the upload of the files that have been selected
  4. Status bar - This shows the current status of the U-Upload applet.

3.3 Running U-Upload

Use your web browser to open the test page you uploaded during installation (index.html). See Deploying to a web server. Upon loading U-Upload 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 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 will continue loading.

3.4 Directory browsing

When you click on the Browse button, U-Upload will display a dialog 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 .

You may browse directories with your keyboard, using the up/down arrows and the Enter key. You may quickly jump to a file beginning with a particular letter by pressing that letter on your keyboard. Pressing Enter while a folder is selected will automatically open that folder for browsing. Pressing Enter with a file selected is equivalent to using the Open button.

U-Upload browse window
Fig 3.4 U-Upload browse dialog

3.5 Selecting files

To select a file, click on the item in the directory listing using your mouse. When you have selected the file you wish to upload, click on the Open button.

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 dialog similar to the one in Figure 3.5 below. You may configure U-Upload to redirect to another page upon completion.

Transfer dialog
Fig 3.5 Progress dialog

4 Configuring U-Upload Lite

These settings can be configured in uuploadlite.js. Note that every time you change these settings, you will need to upload the modified uuploadlite.js file to your web server. If end-users see errors after your update, instruct them to refresh or reload their browser.

4.1 Connection parameters

These parameters control how U-Upload will establish the connection to the FTP server. Please note that some parameters are only available in certain versions. The U-Upload 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 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"

4.2 Functionality-related settings

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

Functionality related settings
localdir

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

showdialogs

Toggles the status, and progress dialogs on and off.

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

4.3 Color and Interface settings

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

UI related settings
language

U-Upload 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 uuploadpro.jar,uuploadproMac.jar (For Mac only), uuploadproplugin.jar and uuploadpro.cab.

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

textwidth

Width of the text field in columns. Setting width to 0 (zero) hides text fields.

Default value: "15"
Valid values: "<valid integer (in columns)>"

width

Width of the U-Upload applet.

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

height

Height of the U-Upload applet.

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

4.4 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.

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.

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.

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.

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.

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.

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.

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 to run.

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

4.5 Language settings and internationalization

U-Upload'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.

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 with the value of "de".
  4. Upload lang_de.txt and the modified uupload.js files to the web server directory that contains U-Upload.

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

5 Advanced Functionality

5.1 Using U-Upload Lite dynamically

In some cases, it may be desirable to load the U-Upload 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 uuploadlite.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 = "upload@utechsoft.com" ;
String hostname = "ftp.utechsoft.com" ;
String port = "21" ;
%>

<script>

// Connection related values

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

...

</script>

5.2 Integrating U-Upload with your web application

Further to loading U-Upload dynamically, you may wish to incorporate the applet into your web application. For full integration using HTTP Post and redirects, you should consider upgrading to U-Upload Pro or Secure from the U-Upload Family. To include U-Upload Lite as part of your web application, be sure to include links for the user to move to the next part of your workflow.

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 (click “forums” button in header).

6.2 Phone, email and chat support

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