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—9.5%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 4w 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 46% 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

1787d 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

[heimrichhannot/contao-pwa-bundle

A bundle to provide progressive web app support for contao.

101.2k](/packages/heimrichhannot-contao-pwa-bundle)[metamodels/core

MetaModels core

10156.6k68](/packages/metamodels-core)[codefog/contao-news_categories

News Categories bundle for Contao Open Source CMS

3690.3k6](/packages/codefog-contao-news-categories)[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.8k](/packages/heimrichhannot-contao-encore-bundle)[terminal42/contao-node

Node bundle for Contao Open Source CMS

3078.1k6](/packages/terminal42-contao-node)[madeyourday/contao-rocksolid-frontend-helper

Frontend Editing for Contao. Stop stumbling through the backend and edit the elements you want easily and directly.

10134.5k3](/packages/madeyourday-contao-rocksolid-frontend-helper)

PHPackages © 2026

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