 |
 |
:: installation, setup, and configuration guide
INSTALL:
Download the latest version of uploadSmart from our website. Unzip the downloaded file. Upload the unzipped files to your own website.
SETUP:
Although javascript is part of the recommended method of adding uploadSmart in your web pages, please note that uploadSmart itself is free of any dependency on javascript. If you prefer, you can still use standard object/embed methods of adding uploadSmart to your web pages. Otherwise, to simplify setup, minimize code hassles, and avoid issues arising from recent changes to the Internet Explorer web browser, we strongly recommend using the following javascript-based method of adding uploadSmart to your web pages.
Here's a quick overview of uploadSmart's basic configuration code:
 |
 |
 |
 |
<SCRIPT type="text/javascript" src="/swfobject.js"></SCRIPT>
<DIV id="uploaderID"></DIV>
<SCRIPT type="text/javascript">
var US = new SWFObject("/uploadsmart.swf","null","width","height","6","bgcolor");
US.addParam("quality","high");
US.write("uploaderID");
</SCRIPT>
|
|
 |
 |
 |
 |
The code above is divided into three sections, color-coded as follows for your reference:
- ###### - This code loads the swfobject.js javascript helper file (required only once per page)
- ###### - This code should be placed exactly where you want uploadSmart to appear on the page
- ###### - This code will be edited where bold to configure each uploader to your liking
Each section of the code can be anywhere you like on the page, but they must appear in the order shown above. If adding multiple instances of uploadSmart to a single web page, be sure to use a unique uploaderID for each instance.
CONFIGURE:
First, the following basic parameters must be defined in the above code where indicated.
Required:
width
Uploader width in pixels
Type: integer
Default: null
Example: 480
height
Uploader height in pixels
Type: integer
Default: null
Example: 53
Note: height of 53 pixels is recommended when in SINGLE mode
bgcolor
Uploader background color as hexadecimal value
Type: string
Default: null
Example: #FFFFFF
The following additional parameters can then be sent to uploader.swf using a query string. See example below.
Required:
key
16-character license key (required to remove evaluation restrictions)
Type: string
Default: null
Example: key=1234567890ABCDEF
uploadurl
Relative path to the script that will process the uploaded file(s)
Type: string
Default: null
Example: uploadurl=/scripts/uploadhandler.php
Note: relative path is relative to the location of uploadsmart.swf
Optional:
mode
Switch that designates single or multi file upload mode
Type: string
Options: single | multi
Default: single
Example: mode=multi
filetypes
Comma-separated list of allowed filetypes by extension
Type: string
Default: null (all filetypes allowed)
Example: filetypes=gif,jpg,pdf
maxfilesize
Maximum allowed filesize for each uploaded file in kilobytes
Type: integer
Default: 0 (no limit)
Example: maxfilesize=10240
maxfilenum
Maximum allowed number of files that can be uploaded simultaneously in multi mode
Type: string
Default: 0 (no limit)
Example: maxfilenum=5
redirect
URL to redirect to upon successful completion of upload
Type: string
Default: null
Example: redirect=/uploadsuccess.php
target
Window or frame to target if "redirect" URL is defined
Type: string
Default: _self
Example: target=_self
Optional Colors:
progressbg
Background color of upload progress indicator
Type: string
Default: #CCCCCC
Example: progressbg=#CCCCCC
Note: should have sufficient contrast with bgcolor
progresscolor
Foreground color of upload progress indicator
Type: string
Default: #666666
Example: progresscolor=#666666
Note: should have sufficient contrast with progressbg
statuscolor
Color of upload status messages
Type: string
Default: #808080
Example: statuscolor=#808080
Note: should have sufficient contrast with bgcolor
errorcolor
Color of upload error messages
Type: string
Default: #CC0000
Example: errorcolor=#CC0000
Note: should have sufficient contrast with bgcolor
EXAMPLE OF CONFIGURED CODE:
Here's an example of what your uploadSmart code might look like with various options set in the query string. Please note that this example includes a sample license key. A license key is required if you wish to disable evaluation restrictions and can be purchased here.
GOT QUESTIONS? NEED HELP?
We want you to experience all of the unique benefits uploadSmart has to offer, and we're happy to assist you in any way we can. Please send questions to support@uploadsmart.com, and we'll get back to you well within 24 hours.
|
|
 |
 |