This topic highlights basic concepts which you need to grasp to start using File Downloader.
To integrate File Downloader with your website, you always need to do the following steps:
FileDownloader7.jarto your Web server where the website is running.
iuembed.jsscript and add File Downloader to a Web page where you want to use this control.
File Downloader is not a standalone application. It can be interpreted as a "browser add-on" that should be embedded into a page. Here is how to do it.
First, you need to install File Downloader SDK. This SDK contains documentation, demo applications, and redistributable files:
File Downloader SDK can be downloaded from the following location: http://www.aurigma.com/downloads/file-downloader. Here the SDK is available in the following packages:
FileDownloader.exe, Windows-only installer
FileDownloaderNoSetup.zip, ZIP archive
If you downloaded the Windows-only installer, just run the
FileDownloader.exe file and follow the wizard steps. During one of these steps you specify the folder where to install all File Downloader SDK files. Typically this is
C:\Program Files\Aurigma\File Downloader 7.0.9\; you will find all necessary files there.
iuembed.js, and this script functions are used to invoke and configure the control, do the following.
iuembed.jswith the required Web page by inserting the following line in the beginning of this page:
If you encounter problems loading File Downloader, make sure that:
If you prefer not to use Java or ActiveX version of File Downloader, you should disable it using the corresponding property (FileDownloaderWriter.activeXControlEnabled or FileDownloaderWriter.javaAppletEnabled). The following sample disables the Java version of File Downloader, as a result non-Internet Explorer browsers become unsupported by File Downloader:
The next step you need to complete is to prepare a list of downloadable files. The file list is a
plain text file. Each entry in this list corresponds to one file and takes up exactly one line. The
entry consists of four fields separated by pipes (
|). These fields represent:
The order of fields in the entries is important.
Here is a sample file list.
image/jpeg | 174546 | apples.jpg | http://localhost/Fruits/apples.jpg image/jpeg | 134257 | apricots.jpg | http://localhost/Fruits/apricots.jpg image/png | 545675 | avocados.png | http://localhost/Fruits/avocado.png
The file list can be a simple static file or can be generated by a server script on request. The latter approach is used in our samples (see the Samples topic). If the static file is sufficient for your needs, put it somewhere on your Web server.
File Downloader has a number of parameters, but some of them are essential for the proper work of the control, and some are simply intended for customization. In this section we will breifly overview the most important parameters.
The most important parameters are:
Now you can test the Web page with File Downloader.
File Downloader is distributed with a number of demo applications which can be used as code samples. You can find them in the installation folder of File Downloader.
Samples are available for the following platforms:
Below you will find a number of useful links related to File Downloader.
Online demo of File Downloader. You can use it if you want to see File Downloader in action without installing demo applications on your machine.
Information on how to deploy File Downloader on the production server.
Information on how to use license keys obtained upon purchase to remove limitations of the evaluation version.
List of all FileDownloader class members. It will be useful when you start configuring File Downloader parameters.
Reference and programmer's guide to the helper
iuembed.js script. It is highly recommended to familiarize yourself with
this topic before you start editing the File Downloader-related client-side code.
Root topic for the File Downloader manual, which contains a number of articles demonstrating how to use File Downloader for different tasks.