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.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
This guide is intended to be a complete guide to U-Upload Lite, and will provide information for installing and customizing the applet.
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.
The following is a list of the main features of U-Upload Lite:
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:
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
The minimum system requirements for using U-Upload are as follows:
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.
 |
| Fig 3.1The U-Upload interface |
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.
 |
| Fig 3.2.1 Internet Explorer with Microsoft VM security warning |
 |
| Fig 3.2.2 Sun Java Plugin security warning |
 |
| Fig 3.2.3 Internet Explorer with security warning |
 |
| Fig 3.2.4 Sun Java Plugin security warning |
 |
| Fig 3.2.5 Microsoft Java Plugin security warning |
 |
| Fig 3.3 Safari Browser with security warning |
Once you have accepted the certificate dialog, U-Upload will continue loading.
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.
 |
| Fig 3.4 U-Upload browse dialog |
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.
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.
 |
| Fig 3.5 Progress dialog |
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.
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: "" |
| port | The port number of the FTP server. Typically, FTP uses port 21. Default value: "21" |
| 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" |
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: "" |
| 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: "" |
| showdialogs | Toggles the status, and progress dialogs on and off. Default value: "true" |
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" |
| 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" |
| textwidth | Width of the text field in columns. Setting width to 0 (zero) hides text fields. Default value: "15" |
| width | Width of the U-Upload applet. Default value: "500" |
| height | Height of the U-Upload applet. Default value: "150" |
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: "" |
| 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: "" |
| 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: "" |
| 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: "" |
| 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: "" |
| 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: "" |
| 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: "" |
| 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: "" |
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:
Note: If no language parameter is provided then the default lang_en.txt file is used.
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>
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.
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).