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
{ "state" : "uploading", "received" : 35587, "size" : 716595, "speed" : 35587, "started_at": 1296568823, "uuid" : "12345678" }
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.
