Rad Upload Applet accepts several configuration parameters and the basic settings are explained below. To get started with drag and drop file upload the only setting you need to change is the url (explained below). If you need clarifications on any of these settings please do contact us for a quick answer.
- url : Where to upload
-
As the name suggests, the url parameter should be a URL. It should point to the location of your server side upload handler or to a folder on your FTP server.
If you are uploading over HTTP, you will find that sample handlers are included with the download for both PHP and perl. Handlers for other server side languages can be found in our examples page. When using HTTP your url parameter may look something like http://www.yourhost.com/upload.php . When you want to protect the transfer with SSL, use https:// as the prefix instead of http://
Additional data 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 your URL as
http://www.yourhost.com/upload.php?who=mickey&where=california
session identifiers 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">
- max_upload : How much to upload
-
The max_upload parameter defines the maximum permissable upload size. This setting takes effect only in Rad Upload standard and plus editions. The lite edition has a Factory settings of 512Kb
If you are using PHP on the server please note that the upload_max_filesize setting in the php.ini file takes precedence over this value. Other settings such as maximum script execution time and maximum post data size may aslo effect your ability to carry out large file uploads. Please refer to your web server's configuration guide for details.
Additional documentation on how to prepare your server to accept large file uploads can be found here ..
- message : Applet's apperence
-
The welcome 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 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 : Stylesheet for FTP directory listing.
-
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
- The amount of space on the web page that is occupied by the applet can be changed by editing the height and width attributes. These settings are different from the others because they are in effect attributes of the applet tag used to embed the applet on your web page.
- full_path : Absolute or relative pathnames
-
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 : Windows to Unix pathname translations
-
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 : Protecting path information
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
- ftp_mode : Active or Passive mode FTP
-
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.
- props_file : Advanced configuration 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.22 if you have a older version you may be
eligible for a free upgrade.
The Plus edition, includes several additional features. Detailed explainations on howto use those features are explained in the advanced configuration guide.