![]() HTML_Progress2 : The Definitive Guide
|
3.1. General questions |
|
|
|
3.1.1. |
What does it cost ? |
You can download and use it for free. But don't delete the copyright notice. You can read terms of the license |
|
3.1.2. |
Do you offer support ? |
YES if there is no answer in this Guide and if you are ready to share some informations such as : your configuration (platform Win *nix mac, PHP version, PEAR packages installed) and perharps your script. |
|
3.1.3. |
I found a bug, what shall i do ? |
You can report it with the bug tracker at PEAR. |
|
3.1.4. |
What is HTML_Progress2_Lite ? |
HTML_Progress2_Lite is less customizable than its father HTML_Progress2, but allows to do almost the same things. This class has no dependency and can be used completely outside the PEAR infrastructure. |
|
3.1.5. |
What is PHP_Compat ? |
PHP_Compat provides missing functionality for older versions of PHP. This class has no dependency and can be used completely outside the PEAR infrastructure. |
|
3.1.6. |
What is HTML_QuickForm ? |
HTML_QuickForm is a PEAR package that provides methods for creating, validating and processing HTML forms. The purpose of Keith Edmunds tutorial is to give the new users of QuickForm an overview of its features and usage patterns. It describes a small subset of available functionality. Don't forget to read also the PEAR Manual, HTML_QuickForm related part. |
|
3.1.7. |
What is HTML_QuickForm_Controller ? |
HTML_QuickForm_Controller is a PEAR package that implements a PageController design pattern, which essentially means that there is a single page processing requests and actions this page performs. This package is used only with the HTML_Progress2_Generator (an interactive tools to create your own progress meter). Don't forget to read also the PEAR Manual, HTML_QuickForm_Controller related part. |
|
3.1.8. |
What is PEAR ? |
PEAR (an acronym for PHP Extension and Application Repository) is a framework and distribution system for reusable PHP components. Don't forget to read also the PEAR Manual and PEAR FAQ. |
|
3.1.9. |
What is PEAR_ErrorStack ? |
PEAR_ErrorStack implements error raising and handling using a stack pattern. This has tremendous advantages over the PEAR_Error Implementation. Don't forget to read also the PEAR Manual, PEAR_ErrorStack related part. |
|
3.2. Troubleshooting guide |
|
3.2.1. |
I saw nothing on my browser screen |
You've forgot to put the necessary styles (CSS) on your HTML document. Add the
Either with the style tags : <?php require_once 'HTML/Progress2.php'; $pb = new HTML_Progress2(); ?> <style type="text/css"> <!-- <?php echo $pb->getStyle(); ?> // --> </style> <?php $pb->display(); ?> Or without the style tags : <?php require_once 'HTML/Progress2.php'; $pb = new HTML_Progress2(); echo $pb->getStyle(false); $pb->display(); ?> |
|
3.2.2. |
The progress meter is running, but i see no changes |
The waiting bar of your favorite browser is running, but you don't see anything on the screen. You've forgot to put the necessary javascript code that manage the progress meter. Add the
Either with the script tags : <?php require_once 'HTML/Progress2.php'; $pb = new HTML_Progress2(); $pb->setAnimSpeed(100); ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3c.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <title>Progress2 Basic example</title> <style type="text/css"> <!-- <?php echo $pb->getStyle(); ?> // --> </style> <script type="text/javascript"> <!-- <?php echo $pb->getScript(); ?> //--> </script> </head> <body> <?php $pb->display(); $pb->run(); ?> </body> </html> Or without the script tags : <?php require_once 'HTML/Progress2.php'; $pb = new HTML_Progress2(); $pb->setAnimSpeed(100); ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3c.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> <head> <title>Progress2 Basic example</title> <?php echo $pb->getStyle(false); echo $pb->getScript(false); ?> </head> <body> <?php $pb->display(); $pb->run(); ?> </body> </html> |
|
3.2.3. |
The progress meter seems to be frozen at 100%, i see no changes |
Using <?php require_once 'HTML/Progress2.php'; $pb = new HTML_Progress2(); $pb->setAnimSpeed(500); ?> <html> <head> <?php echo $pb->getStyle(false); echo $pb->getScript(false); ?> </head> <body> <?php $pb->display(); $pb->run(); ?> </body> </html> |
|
3.3. How to |
|
3.3.1. |
How to include a progress meter in my upload form ? |
Its impossible to do with a pure PHP solution. By the way, there are some mixed solutions that exists on the Web. Here is a short list :
|
HTML_Progress2 : The Definitive Guide | v 1.0.0 : September 23, 2005 |