Why these changes ?

HTML_Progress has improved a lot since version 1.1. New features and easy short links comes, but also some functionalities was removed. With release 1.2 HTML_Progress_Model class was removed, making HTML_Progress package much lighter. But don't worry, the feature still exists: see HTML_Progress::setModel method.

How to adjust your code

HTML_Progress::display()

When you coded a loop such as:

<?php
require_once 'HTML/Progress.php';
 
$bar = new HTML_Progress();
 
// ...
 
do {
    $bar->display();
    if ($bar->getPercentComplete() == 1) {
        $break;
    } 
    $bar->incValue();
} while(1)
?>

<?php
require_once 'HTML/Progress.php';
 
$bar = new HTML_Progress();
 
// ...
 
do {
    $bar->display();
    if ($bar->getPercentComplete() == 1) {
        $break;
    } 
    $bar->sleep();
    $bar->incValue();
} while(1)
?>

Of course, you need the HTML_Progress::sleep method only to produce demonstration. In real world the user task should at least enough long to delay and smooth progress meter animation.

HTML_Progress::run()

This new API allows to replace a do-while loop as in above example. Its also allows to call a user-callback defined by HTML_Progress::setProgressHandler and manage both progress meter mode (determinate and indeterminate).

HTML_Progress::hasErrors(), HTML_Progress::getError()

These new API allows to catch HTML_Progress internal errors more easily. See Advanced Error Handling for details.

<?php 
require_once 'HTML/Progress.php';
 
$bar = new HTML_Progress();
$e = $bar->setAnimSpeed(10000);   // < - - - will generate an API error
 
if ($bar->hasErrors()) {
    $err = $bar->getError();
    echo '<h1>Catch HTML_Progress Error</h1>';
    echo '<pre>';
    print_r($err);
    echo '</pre>';
}
?>