Applet Configuration Parameters

Rad Upload can be configured using several parameters and these are explained below. A more up to date version of this document may be available at http://www.radinks.com/upload/docs.php. Please also refer to Rad Upload developer FAQ for additional information on making the most of Rad Upload.

max_upload

The maximum permissible upload size in kilobytes. This setting takes effect only in Rad Upload Plus. Factory settings of 512Kb and 5Mb apply for Rad Upload Lite and Rad Upload Standard Editions.

The upload_max_filesize setting in the php.ini file takes precedence over this value (if you are using php as your server side handler). Other settings such as maximum script execution time and maximum post data size may effect this setting. Please refer to your web servers configuration guide for details.

If you are using PHP you might find our brief configuration guide on the various settings useful.

url

The location of your server side upload handler script in the case of HTTP or a FTP url. For example if you are using HTTP, with PHP as your server side scripting language you can make use of the sample php script provided, in this case your url will look like http://www.yourhost.com/upload.php

Please refer to the reference manual for your preferred server side programming language to determine how to work with uploaded files on the server side. Additional parameters can be passed to the server side handler by embedding them into the URL. For example if your script accepts two additional parameters named, who and where you can modify the above url to be http://www.yourhost.com/upload.php?who=mickey&where=california

You can upload to an FTP server by specifying a url such as ftp://username:password@ftp.yourserver.com . Anonymous FTP can also be used.

message

This is the message displayed on the applet area on startup. It can be simple text message or the contents of a simple web page. In our online demo you will find that the applet displays a coffee mug and our settings for this parameter is http://www.radinks.com/upload/init.html

If you use a web page for your welcome message please make sure it does not contain complex DHTML or javascripts since the Java HTML rendering engine is still rather limited.

If the string value given for message starts with the sequence http:// the applet will attempt to load the URL given at that location. If the message does not start with the http:// sequence it will be considered to be a simple text message.

Example: <param name="message" value = "http://www.radinks.com/"> - loads a web page as welcome message

Example: <param name="message" value = "Welcome to my parlour"> - A plain text welcome message

height, width

The height and width in pixels of the applet.

style

Takes effect only when uploading to an FTP server. The download bundle includes a style sheet (styles.css) that is used to format the response page for FTP uploads. Copy styles.css to your web space and specify it's absolute path name here.

example: <param name="style" value="/styles.css">

height, width

The height and width in pixels of the applet.

ftp_mode

Only takes effect when the File Transfer Protocol is being used. This parameter has only one permissible value - 'active' which causes the FTP data connection to use 'Active Mode'. Not setting this field or setting it to any value other that 'active' results in passive mode data connections being used.

It's recommended that you leave this blank unless you have special firewall configurations that does not allows passive mode connections to be made.

full_path

Only acceptable values are yes and no. defaults to yes. This variable defines whether the full path name or relative path names should be passed to the server.

The setting has no effect for uploads over FTP, it is most useful when dealing with recursive folder uploads over HTTP.

translate_path

Only acceptable values are yes and no. defaults to no. When set to yes the '\' character in the path name will be replaced by '/' character since PHP does not return the full path name when it contains the '\' character.

This setting has effect only for HTTP uploads and when the full_path parameter is set to yes.