PHPackages                             imalliar/jquery.progress-bar-timer - 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. imalliar/jquery.progress-bar-timer

ActiveComponent[Utility & Helpers](/categories/utility)

imalliar/jquery.progress-bar-timer
==================================

A simple countdown timer using boostrap 4 progress bar

1368[5 issues](https://github.com/imalliar/jquery.progressBarTimer/issues)[1 PRs](https://github.com/imalliar/jquery.progressBarTimer/pulls)JavaScript

Since Apr 9Pushed 6y ago1 watchersCompare

[ Source](https://github.com/imalliar/jquery.progressBarTimer)[ Packagist](https://packagist.org/packages/imalliar/jquery.progress-bar-timer)[ RSS](/packages/imalliar-jqueryprogress-bar-timer/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

jquery.progressBarTimer
=======================

[](#jqueryprogressbartimer)

### A simple countdown timer using boostrap 4 progress bar

[](#a-simple-countdown-timer-using-boostrap-4-progress-bar)

This plugin provides a simple jquery timer using bootstrap 4 progress bar

Basic Usage
-----------

[](#basic-usage)

1. Include jQuery:

    ```

    ```
2. Include bootstrap:

    ```

    ```
3. Include plugin's code:

    ```

    ```
4. Include the plugin container in your HTML:

```

```

4. Call the plugin:

```
$("#countdown").progressBarTimer({
  timeLimit: 60,
  warningThreshold: 5,
  autostart: false,
  onFinish  : function () { console.log('completed') }
}).start()
```

Default Options
---------------

[](#default-options)

```
{
    timeLimit: 60, //total number of seconds
    warningThreshold: 5, //seconds remaining triggering switch to warning color
    autoStart: true, // start the countdown automatically
    onFinish: function() {}, //invoked once the timer expires
    baseStyle: '', //bootstrap progress bar style at the beginning of the timer
    warningStyle: 'bg-danger', //bootstrap progress bar style in the warning phase
    smooth: false, // should the timer be smooth or stepping
    completeStyle: 'bg-success' //bootstrap progress bar style at completion of timer
}
```

Functions
---------

[](#functions)

```
.start()             // starts the countdown timer
.stop()              // stops the countdown timer, onComplete is not called
.extendTimer(secs)   // extends the current timer by backing up by the number of seconds provided
.addSeconds(secs)    // adds additional seconds to the original timer and restarts if startOverAfterAdding is true

```

Callbacks
---------

[](#callbacks)

```
onComplete					// The function defined in this option is called after the timer completes.

```

Demo
----

[](#demo)

[Demo Page](https://imalliar.github.io/progressBarTimer/index.html)

Contributing
------------

[](#contributing)

[See Contributing](https://github.com/imalliar/jquery.progressBarTimer/blob/master/CONTRIBUTING.md)

License
-------

[](#license)

[MIT License](https://imalliaros.mit-license.org/) © Jacob Malliaros

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance12

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/70a31894e4a4b9f5098371747191e7b4bb157c844b65234e4b07f127a04b5170?d=identicon)[imalliar](/maintainers/imalliar)

---

Top Contributors

[![imalliar](https://avatars.githubusercontent.com/u/11210146?v=4)](https://github.com/imalliar "imalliar (17 commits)")

### Embed Badge

![Health badge](/badges/imalliar-jqueryprogress-bar-timer/health.svg)

```
[![Health](https://phpackages.com/badges/imalliar-jqueryprogress-bar-timer/health.svg)](https://phpackages.com/packages/imalliar-jqueryprogress-bar-timer)
```

###  Alternatives

[xpaw/steamid

SteamID conversion library

17188.5k13](/packages/xpaw-steamid)[open-feature/sdk

PHP implementation of the OpenFeature SDK

39514.9k15](/packages/open-feature-sdk)[sylius/taxonomy-bundle

Flexible categorization system for Symfony.

26388.2k7](/packages/sylius-taxonomy-bundle)[arcanedev/qr-code

QR Code generator

1231.9k1](/packages/arcanedev-qr-code)

PHPackages © 2026

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