==== File upload Progress Indicator ====

The file upload indicator is implemented using the Upload progress module for apache (https://github.com/drogus/apache-upload-progress-module).

Installation/Configuration steps.

1- Download the source code
    
     wget https://github.com/drogus/apache-upload-progress-module.git
    
    Alternate source: wget --no-check-certificate http://github.com/drogus/apache-upload-progress-module/tarball/master
2- Compile the source code and install the module in apache
    
     cd apache-upload-progress-module
     sudo apxs2 -c -i -a mod_upload_progress.c
    
    Please note that to compile the module, you will need threaded development library of apache2
3- Modify apache configuration
   In the VirtualHost configuration of the application add 
   
    <Location />
      # enable tracking uploads in /
      TrackUploads On
    </Location>
    <Location /progress>
      # enable upload progress reports in /progress
      ReportUploads On
    </Location>
  
4- Restart the apache server.
    
==Implementation Details==
In the file upload form action url, append X-ProgressID=<GUID> (make sure that this is the last key-value in the query string of the form action url)
Once the file upload has started, fire Ajax request to /progress?X-Progress-ID=<GUID> to get the status of the upload. 
The status would be in a Json format. Ex <code>{ "state" : "uploading", "received" : 35587, "size" : 716595, "speed" : 35587, "started_at": 1296568823, "uuid" : "12345678" } </code>

state - indicates the current status of the upload. Once the upload is complete, the state would be 'done'

received - indicates the number of bytes received by the server.

size - total size of the file in bytes

started_at - upload start time. (Epoch format)

uuid - The GUID supplied as part of the query string key (X-Progress-ID)

**Issues**
The UI of the file upload is built using the Javascript.  So if a user opts to delete/cancel the upload, it wont be possible at present.  We need to figure out a way to do this.