PHPackages linkrobins/countdown-widget - 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. linkrobins/countdown-widget ActiveFlarum-extension[Utility & Helpers](/categories/utility) linkrobins/countdown-widget =========================== Countdown widget for fof/forum-widgets-core v1.1.1(1w ago)046↓100%MITJavaScriptPHP ^8.3 Since May 11Pushed 1w agoCompare [ Source](https://github.com/linkrobins/countdown-widget)[ Packagist](https://packagist.org/packages/linkrobins/countdown-widget)[ RSS](/packages/linkrobins-countdown-widget/feed)WikiDiscussions main Synced 1w ago READMEChangelog (3)Dependencies (2)Versions (4)Used By (0) Link Robins Countdown Widget ============================ [](#link-robins-countdown-widget) A configurable countdown widget for [Flarum 2.0](https://flarum.org), built as a widget for [`fof/forum-widgets-core`](https://packagist.org/packages/fof/forum-widgets-core). Same skeleton as [`linkrobins/html-widget`](https://packagist.org/packages/linkrobins/html-widget) and [`linkrobins/markdown-widget`](https://packagist.org/packages/linkrobins/markdown-widget). What it does ------------ [](#what-it-does) Renders a four-box countdown β€” days, hours, minutes, seconds β€” ticking down to an admin-configured moment. When it hits zero, shows a configurable "done" message. Optionally wraps the whole thing in a link. Features -------- [](#features) - **Configurable target** via the browser's native date+time picker (year, month, day, hour, minute) - **Timezone-aware** β€” admin picks the IANA timezone for the target, and every visitor counts down to the same actual instant regardless of where they are - **One tick per second** with smooth Mithril redraws - **Optional title + FontAwesome icon** above the countdown - **Done state** with a configurable message (defaults to πŸŽ‰) when the countdown reaches zero - **Optional link** wrapping the whole widget β€” useful for "launching in… \[click for details\]" - **Theme-friendly** β€” uses Flarum 2's CSS custom properties so colors pick up your theme automatically - **Tabular-numerics font feature** so digits don't jitter as they tick Requirements ------------ [](#requirements) - Flarum **2.0** or later - PHP **8.2** or later - [`fof/forum-widgets-core`](https://packagist.org/packages/fof/forum-widgets-core) installed and enabled Installation ------------ [](#installation) ``` composer require linkrobins/countdown-widget php flarum cache:clear ``` In Flarum admin β†’ **Extensions**, find **Link Robins Countdown** under the **Forum Widgets** category and enable it. Configure the target on its settings page, then go to **FoF Forum Widgets** settings and place the widget where you want it. Settings -------- [](#settings) - **Title** (optional) β€” shown above the countdown - **Icon** (optional) β€” FontAwesome class shown next to the title (e.g. `fas fa-rocket`) - **Target date and time** β€” uses the browser's date picker; covers year, month, day, hour, and minute - **Timezone** β€” IANA name like `UTC`, `America/New_York`, `Europe/London`, `Asia/Tokyo`. There's a "Use my timezone" button that fills this with whatever your browser thinks the local zone is - **Done message** β€” shown when the countdown hits zero (defaults to πŸŽ‰) - **Link URL** (optional) β€” if set, the countdown becomes a clickable link How the timezone math works --------------------------- [](#how-the-timezone-math-works) The target time is stored as a "naive" wall-clock datetime (e.g. `2026-12-31T23:59`) paired with a timezone (e.g. `America/New_York`). At render time, the widget converts that pair into an absolute UTC instant using the browser's `Intl.DateTimeFormat` API, which correctly handles daylight-saving transitions for the target date. Every visitor's browser then counts down to that single instant, so the displayed remaining-time stays consistent across the audience regardless of where each viewer is. This avoids the most common countdown widget bug: "the admin set it for 11pm but my visitors in Tokyo see a different time." License ------- [](#license) MIT ### Health Score 44 β€” FairBetter than 90% of packages Maintenance98 Actively maintained with recent releases Popularity11 Limited adoption so far Community6 Small or concentrated contributor base Maturity50 Maturing project, gaining track record 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. ### Release Activity Cadence Every ~10 days Total 3 Last Release 10d ago PHP version history (2 changes)v1.0.0PHP ^8.2 v1.1.0PHP ^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/6ba4ada28098b217152b5ec67bff43409a54b808d7d038119af6f56715a1c3f9?d=identicon)[linkrobins](/maintainers/linkrobins) --- Top Contributors [![linkrobins](https://avatars.githubusercontent.com/u/213107296?v=4)](https://github.com/linkrobins "linkrobins (4 commits)") ### Embed Badge ![Health badge](/badges/linkrobins-countdown-widget/health.svg) ``` [![Health](https://phpackages.com/badges/linkrobins-countdown-widget/health.svg)](https://phpackages.com/packages/linkrobins-countdown-widget) ``` ### Alternatives [flarum-lang/russian Russian language pack for Flarum. 12127.5k](/packages/flarum-lang-russian)[fof/byobu Well integrated, advanced private discussions. 61112.4k10](/packages/fof-byobu)[flarum/tags Organize discussions into a hierarchy of tags and categories. 38744.9k133](/packages/flarum-tags)[fof/gamification Upvotes and downvotes for your Flarum community 4162.0k6](/packages/fof-gamification)[fof/polls A Flarum extension that adds polls to your discussions 25130.2k9](/packages/fof-polls)[michaelbelgium/flarum-discussion-views Add views to flarum discussions 3155.4k6](/packages/michaelbelgium-flarum-discussion-views) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)