no way to compare when less than two revisions

Differences

This shows you the differences between two versions of the page.


Previous revision
Last revision
progressbar [2010-03-29 14:34] marcos
Line 1: Line 1:
 +====== Progress Bar (Plugin) ======
 +
 +===== What this plugin does =====
 +
 +This plugin displays a progress bar when you are uploading a file through OpenGoo. It requires Perl installed on the server. Uploads are performed through a Perl script that saves the uploaded file to the tmp folder in OpenGoo, along with info about the total size of the file. The GUI periodically calls a PHP script that calculates the progress based on the size of the temporary file and the total size of the file.
 +The progress bar is updated with this info, showing how much of the file has been uploaded.
 +
 +===== How to install this plugin =====
 +
 + 1- Make sure you have installed Perl with CGI, FILE::COPY, FILE::PATH, IO::File
 + 2- Unzip the plugin into your OpenGoo installation
 + 3- Edit file 'cgi-bin/upload.pl' (included with the plugin) and set the correct values for variables:
 + - OG_ROOT:  Path on the server to the OpenGoo installation.
 +             e.g.: /var/www/opengoo
 + - OG_URL:   URL to your OpenGoo installation (must match ROOT_URL defined in config/config.php)
 +             e.g.: http://www.mydomain.com/opengoo/
 + - MAX_SIZE: Maximum allowed upload size in bytes.
 +             e.g.: 10000000  # for 10 MB
 + 4- Copy file 'cgi-bin/upload.pl' to your server's cgi-bin directory. Make it executable.
 + - e.g. on linux:
 + cp cgi-bin/upload.pl /var/www/cgi-bin/upload.pl
 + chmod +x /var/www/cgi-bin/upload.pl
 + 5- Define a constant PROGRESS_UPLOAD_SCRIPT on 'config/config.php' with the URL to the upload script you copied on step 3.
 +     - e.g.: define('PROGRESS_UPLOAD_SCRIPT', 'http://www.mydomain.com/cgi-bin/upload.pl');
 + 6- Define a constant UPLOAD_HOOK on 'config/config.php' with value 'progress'.
 + - i.e.: define('UPLOAD_HOOK', 'progress');
 + 7- Check the installation:
 + a- Browse to <URL to your upload.pl>?check
 + You should get "Script configured correctly!"
 + b- Browse to <URL to your OpenGoo>/index.php?c=progress&a=test
 + You should get a file upload form where you can test your script.
 + c- Try uploading a file on your OpenGoo ;) 
 +===== How to use this plugin =====
 +
 +While uploading a file you will notice a progress showing what percentage of the file has been uploaded.