The URL
http://cees.crtconsulting.ca/perl/modules/Apache2-UploadProgress-0.2.tar.gz
has entered CPAN as
file: $CPAN/authors/id/C/CE/CEESHEK/Apache2-UploadProgress-0.2.tar.gz
size: 26235 bytes
md5: da726fab802ba49d954c0c9042d0324b
Apache2::UploadProgress allows you to easily add progress monitors to
any of your existing upload forms without having to change any of your
backend code. The tracking of the upload is seemslessly handled
through a PerlPostReadRequestHandler and the updates retrieved through
a content handler (either through AJAX calls, or by refreshing a popup
window). To configure your HTML form, just add an onsubmit handler to
the form, and add an extra empty DIV tag for the progress monitor.
Usage:
In Apache:
PerlLoadModule Apache2::UploadProgress
PerlPostReadRequestHandler Apache2::UploadProgress
In your HTML form:
<script src="/UploadProgress/progress.js"></script>
<link type="text/css" href="/UploadProgress/progress.css"/>
<form action="/cgi-bin/script.cgi"
method="post"
enctype="multipart/form-data"
onsubmit="return startEmbeddedProgressBar(this)">
<input type="file" name="file"/>
<input type="submit" name=".submit"/>
</form>
<div id="progress"></div>
The support files (js/css/xsl) are automatically alliased in Apache so
you do not need to copy them into your web directory, unless you wish
to customize them (see the docs on how to do that).
All the Apache code was written by Christian Hansen, so most of the
credit goes to him. I have helped to piece together the JavaScript,
CSS styles and XSL stylesheets to make it all work as easily and
seemlessly as possible.
There are live demos running at the following URLs:
http://cees.crtconsulting.ca/perl/examples/uploadprogress/embedded.cgi
http://cees.crtconsulting.ca/perl/examples/uploadprogress/popup.cgi
Please limit the size of the files that you are uploading to between
30 and 50K. The upload is artificially slowed down with sleep calls
(~ 8K/sec) so that you will see the progress updates even with small
files. All uploaded files are immediately sent to the bit bucket.
Any and all feedback is welcome (see the TODO file for things
currently in the works), and we would be happy to accept new
styles/scripts/patches to improve look and workings of this module.
Cheers,
Cees Hek
