Rad Upload Applet accepts several configuration parameters and these are explained below. The Plus Edition of the applet includes several additional features, and their configuration is described elsewhere. Please also refer to 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 standard and plus editions. The lite edition has a Factory settings of 512Kb
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 usefull.
- url
-
The location of your server side up load handler script or URL to a folder on your FTP server.
If you are uploading over HTTP, with PHP as your server side scripting language you can use
the sample php script provided with your download, in this case your url will look like http://www.yourhost.com/upload.php . If you wish to make use of SSL encryption, the URL prefix will be https:// instead of http://
Please refer to the reference manual of your preferred server side programming language to determine how to deal 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
session identifier can also be passed in this manner.
Example:
<param name="url" value = "http://67.131.250.71/upload.php">
Example with extra parameters:
<param name="url" value = "https://67.131.250.71/upload.php?param1=hello">
- 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
If you use a webpage 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
- 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="http://www.radinks.com/styles/default.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 when uploading to a FTP server. It is most useful when dealing with
recursive folder uploads over HTTP, specially when the handler is a PHP script.
- 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. This setting has effect only for HTTP uploads and when the full_path parameter is set to yes.
- encode_path
This configuration parameter introduced in version 1.31 supercedes the translate_path parameter described above. The need to encode pathnames may arise if you are using PHP to handle HTTP file uploads. The PHP engine strips out path information unless it is encoded which makes it impossible to create a directory tree. It is also usefull if the files you are handling contain special characters.
The only recognized value for this setting is yes
- props_file
Defines the name of the advanced configuration file for Rad Upload Plus. If you leave this blank the applet will look for a file named radupload.properties in the folder that contains the jar file. If you enter a value it should be a full URL.
example: <param name="props_file" value="http://www.radinks.com/upload/radupload.properties">
For a real world example on how these parameters are used we invite you to look at the HTML source of
our applet demo page.
This documentation is valid for version 2.01, if you have a older version you may be
eligible for a free upgrade.
