PHPackages                             heimrichhannot/contao-progress-bar-widget-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. heimrichhannot/contao-progress-bar-widget-bundle

ActiveContao-bundle[Utility & Helpers](/categories/utility)

heimrichhannot/contao-progress-bar-widget-bundle
================================================

This bundle offers a dynamic progress bar widget for the Contao CMS.

0.1.3(4y ago)01.5k↑28.6%1[1 PRs](https://github.com/heimrichhannot/contao-progress-bar-widget-bundle/pulls)1LGPL-3.0-or-laterPHPPHP ^7.2||^8.0

Since Sep 14Pushed 4y ago5 watchersCompare

[ Source](https://github.com/heimrichhannot/contao-progress-bar-widget-bundle)[ Packagist](https://packagist.org/packages/heimrichhannot/contao-progress-bar-widget-bundle)[ RSS](/packages/heimrichhannot-contao-progress-bar-widget-bundle/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (4)Dependencies (12)Versions (5)Used By (1)

Contao Progress Bar Widget Bundle
=================================

[](#contao-progress-bar-widget-bundle)

This bundle offers a dynamic progress bar widget for the Contao CMS.

Features
--------

[](#features)

- adds a progress bar widget (currently for the backend only) **for a given database record**
- ajax support (self-auto-updating)
- also display the progress in numbers

Impressions
-----------

[](#impressions)

[![The progress bar widget included in an example data container array](docs/img/widget.png "The progress bar widget included in an example data container array")](docs/img/widget.png)

The progress bar widget included in an example data container array

Installation
------------

[](#installation)

1. Install via composer: `composer require heimrichhannot/contao-progress-bar-widget-bundle`.

Usage
-----

[](#usage)

1. Create the field in the desired data container array (DCA) as usual: ```
    'importProgress'                 => [
        'inputType' => 'huhProgressBar',
        'eval' => [
            // an introduction text for the widget (mandatory)
            'description' => $GLOBALS['TL_LANG']['tl_entity_import_config']['reference']['importProgressDescription'],
            // only show the progress bar but not the numbers below (optional, default false)
            'hideNumbers' => false,
            // hide skipped items from the numbers section (optional, default false)
            'hideSkippedItems' => false
        ]
    ],
    ```
2. The progress is passed via an event listener for the event `LoadProgressEvent`. Register an event listener (or subscriber) as usual in symfony: ```
    use HeimrichHannot\ProgressBarWidgetBundle\Event\LoadProgressEvent;
    use HeimrichHannot\ProgressBarWidgetBundle\Widget\ProgressBar;
    use Terminal42\ServiceAnnotationBundle\Annotation\ServiceTag;

    /**
     * @ServiceTag("kernel.event_listener", event="huh.progress_bar_widget.event.load_progress")
     */
    class LoadProgressListener
    {
        public function __invoke(LoadProgressEvent $event) {
            if (null === ($record = MyModel::findByPk($event->getId()))) {
                return;
            }

            // map the record's state field to the progress bar's expectations
            // of course you can decide yourself in which cases you'd like to pass which state
            switch ($record->state) {
                case 'success':
                    $state = ProgressBar::STATE_SUCCESS;
                    $class = 'tl_confirm';
                    break;
                case 'error':
                    $state = ProgressBar::STATE_FAILED;
                    $class = 'tl_error';
                    break;
                default:
                    $state = ProgressBar::STATE_IN_PROGRESS;
                    $class = '';
            }

            $data = [
                'state' => $state,
                'currentProgress' => $record->importProgressCurrent, // field name depends on your dca
                'totalCount' => $record->importProgressTotal, // field name depends on your dca
                'skippedCount' => $record->importProgressSkipped, // field name depends on your dca
            ];

            // add messages if some are available
            if ($record->importProgressResult) {
                $data['messages'] = [[
                    'class' => $class,
                    'text' => str_replace("\n", '', $record->importProgressResult),
                ]];
            }
        }
    }
    ```

Events
------

[](#events)

EventDescription`LoadProgressEvent`Used for passing in the current progress. See above for further explanation

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

1742d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/28ad3224d8727b622ebd229840eea6b9dbcb83eb0bd609e6ce65b614830ff538?d=identicon)[digitales@heimrich-hannot.de](/maintainers/digitales@heimrich-hannot.de)

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/heimrichhannot-contao-progress-bar-widget-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/heimrichhannot-contao-progress-bar-widget-bundle/health.svg)](https://phpackages.com/packages/heimrichhannot-contao-progress-bar-widget-bundle)
```

###  Alternatives

[codefog/contao-haste

haste extension for Contao Open Source CMS

41668.4k162](/packages/codefog-contao-haste)[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3187.0k6](/packages/codefog-contao-news-categories)[terminal42/contao-node

Node bundle for Contao Open Source CMS

3075.6k5](/packages/terminal42-contao-node)[terminal42/contao-folderpage

Provides a new page type for Contao that allows you to group pages into folders.

18153.4k10](/packages/terminal42-contao-folderpage)[terminal42/contao-url-rewrite

URL Rewrite bundle for Contao Open Source CMS

15100.0k3](/packages/terminal42-contao-url-rewrite)[heimrichhannot/contao-encore-bundle

This bundle brings deep integration for symfony encore into contao. On the one hand, your can prepare your bundles to define own webpack entries, which added with just one command to your webpack entries. On the other hand, this bundle allows you to add encore entries only on the pages you need them for optimizing your website performance.

1016.3k](/packages/heimrichhannot-contao-encore-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)