Calendar

ernestdefoe

raw
Calendar forum post · MD

🗓️ Calendar — give your community a heartbeat (and it's free)

Most forums have a quiet problem: people show up when they need something, then disappear. There's no reason to come back tomorrow.

Calendar fixes that. Yes, it's a beautiful, full-featured events calendar — but it's really an engagement engine dressed up as one. Even if you never schedule a single event, it gives your members a dozen little reasons to return every single day.

Built to feel premium. Priced at free.

🔥 The reason to install it, even if you don't need a calendar

These are the features that quietly turn casual visitors into daily regulars:

🔥 Activity heatmaps & streaks — every member profile gets a year-long, GitHub-style contribution graph with current and longest streaks, running totals, and achievement badges to earn. Nothing pulls people back like a streak they don't want to break.
📈 Forum Pulse — a community-wide activity heatmap and "most active members" leaderboard. One glance tells a newcomer the place is alive and buzzing.
⏳ Live countdowns — drop a ticking countdown timer into any post for a launch, a deadline, a watch party. Upcoming events get one automatically.
🕰️ On this day — resurfaces the most-talked-about threads from today's date in years past, breathing new life into old conversations.
🎂 Member celebrations — opt-in birthdays and join-anniversaries appear in a "today's celebrations" spotlight. Small touch, huge warmth. (Birthdays are month and day only — never a year.)
---

📅 And yes, it's a seriously good calendar too

🗓️ Month, week, day & list views with one-tap prev / today / next. Week and day are real time grids with hour lines, a live "now" line, side-by-side overlapping events, and double-click-to-create right on a time slot.
✅ RSVP — members mark themselves Going or Interested, with live counts so everyone can see the buzz building.
🔁 Recurring events — daily, weekly, monthly or yearly, each occurrence showing up neatly on the right day.
🎨 Colour-coded categories — filter the calendar at a glance and give every event its own accent colour.
📍 Locations — every event can carry a location that turns into a one-tap Google Maps link.
🖼️ Cover images — paste a URL, or upload a file directly if you've got FoF Upload installed.
📆 Sync anywhere — a subscribable iCal feed plus per-event downloads and "Add to Google Calendar" links, so events follow your members into Google, Apple Calendar and Outlook.
💬 Comments built in — optionally give each event its own discussion thread, so likes, mentions and notifications all work exactly the way your members already expect.
🌓 Looks right everywhere — it borrows your forum's own colours, so it's perfect in light mode, dark mode, and on custom themes with zero fiddling.
🧩 Upcoming Events widget — shows up on the default theme, and slots in as a first-class widget in Bespoke and a block in Page Builder.
Everything works beautifully on the default theme, and plays nicely with Bespoke and Page Builder when you have them — and quietly steps aside when you don't.

Installation

composer require ernestdefoe/calendar
php flarum migrate
php flarum cache:clear

Then open Admin → Calendar to set your default view, choose your widgets, and create a few colourful categories. That's it — you're live.

Updating

composer update ernestdefoe/calendar
php flarum migrate
php flarum cache:clear

Give it a spin

It's MIT-licensed and completely free, with no required add-ons — install it, schedule something, and watch the streaks start. Questions, ideas and feature requests are always welcome over on the support forum.

Enjoy! 🎉

Karl

Please update the first post with links 🙂

ernestdefoe

Yeah will do as soon as I publish the update to fix some audit items to get it in green.

Edit: Links added.

Akito

ernestdefoe Could you possible to integrate with fof/widget-core and option to hide the Calendar from tab?

ernestdefoe

Akito What do you mean hide Calendar from tab? I can look into adding compatibility for fof/widget=core.

Akito

ernestdefoe

I mean this one so I could replace with the upcoming event widget

ernestdefoe

Akito if you hid it there then how would you add events? That brings up the calendar where the create event button is.

Akito

ernestdefoe

User can click from the widget anyway right?

Or shell I hide with css

ernestdefoe

Akito Yeah kinda stupid to have it in both. How about I have a setting added to hide the Calendar from nav so that way those like you that don't want it to show in the nav can hide it.

ernestdefoe

Akito new version out with fof/widget-core support and hiding the Calendar side nav link.

ClaudiusH

Trying to create a simply annual event and selecting "All day", but it gets rejected asking for an end date later than the start date 🙁

jslirola

I'm thinking of integrating this extension with my community's own code and a separate Flarum dashboard. I'd just need an API endpoint to send events from my backend code. There's nothing like that yet, right?

ernestdefoe

ClaudiusH can you see if there are anything in the error logs so I can track this down and fix it?

jslirola not yet but I can look into adding it.

ClaudiusH

ernestdefoe The problem is that upon switching to "All-day event" the hour:minutes time element of the timestamp does not get cleared. E.g. compare the screenshot from before enabling it:

... and after:

On the UI the timestamp is removed, but internally still kept. That's how the submission keeps failing for some all day events.

Additionally there are three elements missing localization:

Date format, e.g. in German it would be "31. Aug - 6. Sep 2026"
Weekday names and abbreviations are not localized
Timestamp should allow for 24h format

ClaudiusH

Clicking on the RSVP option to attend unfortunately shows a 500 Server error:

POST http://localhost:8080/api/calendar/events/4/rsvp

Illuminate\Database\Eloquent\MassAssignmentException: Add [event_id] to fillable property to allow mass assignment on [ErnestDefoe\Calendar\EventRsvp]. in /var/www/html/vendor/illuminate/database/Eloquent/Model.php:693
Stack trace:
#0 /var/www/html/vendor/illuminate/database/Eloquent/Model.php(323): Illuminate\Database\Eloquent\Model->fill(Array)
#1 /var/www/html/vendor/flarum/core/src/Database/AbstractModel.php(112): Illuminate\Database\Eloquent\Model->__construct(Array)
#2 /var/www/html/vendor/ernestdefoe/calendar/src/Api/Controller/RsvpController.php(43): Flarum\Database\AbstractModel->__construct(Array)
#3 /var/www/html/vendor/flarum/core/src/Http/RouteHandlerFactory.php(37): ErnestDefoe\Calendar\Api\Controller\RsvpController->handle(Object(Laminas\Diactoros\ServerRequest))
#4 /var/www/html/vendor/flarum/core/src/Http/Middleware/ExecuteRoute.php(27): Flarum\Http\RouteHandlerFactory->{closure:Flarum\Http\RouteHandlerFactory::toController():32}(Object(Laminas\Diactoros\ServerRequest), Array)
#5 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\ExecuteRoute->process(Object(Laminas\Diactoros\ServerRequest), Object(Closure))
#6 /var/www/html/vendor/datlechin/flarum-debugbar/src/Http/Middleware/CaptureRoute.php(68): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#7 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Datlechin\FlarumDebugbar\Http\Middleware\CaptureRoute->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#8 /var/www/html/vendor/fof/anti-spam/src/Middleware/CheckRegistrationMiddleware.php(96): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#9 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): FoF\AntiSpam\Middleware\CheckRegistrationMiddleware->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#10 /var/www/html/vendor/ianm/follow-users/src/Middleware/FlushFollowStateCache.php(41): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#11 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): IanM\FollowUsers\Middleware\FlushFollowStateCache->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#12 /var/www/html/vendor/linkrobins/birdseye/src/Capture/CaptureMiddleware.php(46): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#13 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): LinkRobins\Birdseye\Capture\CaptureMiddleware->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#14 /var/www/html/vendor/fof/sitemap/src/Middleware/ApiRobotsHeader.php(29): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#15 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): FoF\Sitemap\Middleware\ApiRobotsHeader->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#16 /var/www/html/vendor/flarum/audit/src/Middleware/LogPasswordResetAttempt.php(43): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#17 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Audit\Middleware\LogPasswordResetAttempt->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#18 /var/www/html/vendor/flarum/audit/src/Middleware/ExtendSetPermissionController.php(26): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#19 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Audit\Middleware\ExtendSetPermissionController->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#20 /var/www/html/vendor/flarum/audit/src/Middleware/SetLoggerActor.php(33): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#21 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Audit\Middleware\SetLoggerActor->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#22 /var/www/html/vendor/flarum/core/src/Http/Middleware/PopulateWithActor.php(27): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#23 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\PopulateWithActor->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#24 /var/www/html/vendor/flarum/core/src/Api/Middleware/ThrottleApi.php(31): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#25 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Api\Middleware\ThrottleApi->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#26 /var/www/html/vendor/flarum/core/src/Http/Middleware/CheckCsrfToken.php(40): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#27 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\CheckCsrfToken->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#28 /var/www/html/vendor/flarum/core/src/Http/Middleware/CheckForMaintenanceMode.php(37): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#29 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\CheckForMaintenanceMode->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#30 /var/www/html/vendor/flarum/core/src/Http/Middleware/ResolveRoute.php(59): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#31 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\ResolveRoute->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#32 /var/www/html/vendor/flarum/core/src/Http/Middleware/SetLocale.php(43): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#33 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\SetLocale->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#34 /var/www/html/vendor/flarum/core/src/Http/Middleware/AuthenticateWithHeader.php(63): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#35 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\AuthenticateWithHeader->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#36 /var/www/html/vendor/flarum/core/src/Http/Middleware/AuthenticateWithSession.php(32): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#37 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\AuthenticateWithSession->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#38 /var/www/html/vendor/fof/impersonate/src/Middleware/DetectImpersonation.php(39): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#39 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): FoF\Impersonate\Middleware\DetectImpersonation->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#40 /var/www/html/vendor/flarum/core/src/Http/Middleware/RememberFromCookie.php(55): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#41 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\RememberFromCookie->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#42 /var/www/html/vendor/flarum/core/src/Http/Middleware/StartSession.php(44): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#43 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\StartSession->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#44 /var/www/html/vendor/flarum/core/src/Api/Middleware/FakeHttpMethods.php(29): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#45 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Api\Middleware\FakeHttpMethods->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#46 /var/www/html/vendor/flarum/core/src/Http/Middleware/ParseJsonBody.php(28): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#47 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\ParseJsonBody->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#48 /var/www/html/vendor/flarum/core/src/Api/Middleware/AddAssetsRevisionHeader.php(49): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#49 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Api\Middleware\AddAssetsRevisionHeader->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#50 /var/www/html/vendor/flarum/core/src/Http/Middleware/HandleErrors.php(43): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#51 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\HandleErrors->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#52 /var/www/html/vendor/flarum/core/src/Http/Middleware/InjectActorReference.php(25): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#53 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\InjectActorReference->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#54 /var/www/html/vendor/datlechin/flarum-debugbar/src/Http/Middleware/CollectProfile.php(83): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#55 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Datlechin\FlarumDebugbar\Http\Middleware\CollectProfile->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#56 /var/www/html/vendor/laminas/laminas-stratigility/src/MiddlewarePipe.php(77): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#57 /var/www/html/vendor/middlewares/request-handler/src/RequestHandler.php(84): Laminas\Stratigility\MiddlewarePipe->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#58 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Middlewares\RequestHandler->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#59 /var/www/html/vendor/middlewares/base-path-router/src/BasePathRouter.php(97): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#60 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Middlewares\BasePathRouter->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#61 /var/www/html/vendor/laminas/laminas-stratigility/src/Middleware/OriginalMessages.php(36): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#62 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Laminas\Stratigility\Middleware\OriginalMessages->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#63 /var/www/html/vendor/middlewares/base-path/src/BasePath.php(73): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#64 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Middlewares\BasePath->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#65 /var/www/html/vendor/flarum/core/src/Http/Middleware/ProcessIp.php(24): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#66 /var/www/html/vendor/laminas/laminas-stratigility/src/Next.php(52): Flarum\Http\Middleware\ProcessIp->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\Next))
#67 /var/www/html/vendor/laminas/laminas-stratigility/src/MiddlewarePipe.php(77): Laminas\Stratigility\Next->handle(Object(Laminas\Diactoros\ServerRequest))
#68 /var/www/html/vendor/laminas/laminas-stratigility/src/MiddlewarePipe.php(66): Laminas\Stratigility\MiddlewarePipe->process(Object(Laminas\Diactoros\ServerRequest), Object(Laminas\Stratigility\EmptyPipelineHandler))
#69 /var/www/html/vendor/laminas/laminas-httphandlerrunner/src/RequestHandlerRunner.php(73): Laminas\Stratigility\MiddlewarePipe->handle(Object(Laminas\Diactoros\ServerRequest))
#70 /var/www/html/vendor/flarum/core/src/Http/Server.php(44): Laminas\HttpHandlerRunner\RequestHandlerRunner->run()
#71 /var/www/html/public/index.php(26): Flarum\Http\Server->listen()
#72 {main}

ClaudiusH

The uploaded cover image for an event is not visible. It is shifted left off the modal. Only the "Remove image" button is shown:

And the "Delete Event" button has too brightly a text color:

And finally: For consistency with how tags are shown elsewhere in Flarum I would recommend to move the category badge into the header of the event model. Here's a mockup:

ernestdefoe

@ClaudiusH @jslirola — all of this is fixed and released. Calendar 2.2.2 is on Packagist now:

composer update ernestdefoe/calendar
php flarum cache:clear

ClaudiusH, thank you for these — screenshots, a stack trace and a mockup is about as good as
a bug report gets, and one of them was a 500 that every single person hitting RSVP would have
been getting.

@jslirola the API endpoints have been there for a little bit but were undocumented. The Readme now specifies the endpoints.

jslirola

ernestdefoe Thank you so much for the quick review and resolution. It will be very helpful when I migrate my community to version 2.0.

PS: I'm also a fan of Opus 5 and use it often. 😃

ernestdefoe

jslirola well I was using Opus 4.8 when I first got into all of this but then they came out with 5 and it is much better and seems to make less mistakes.

ClaudiusH

Thanks for the fixes and improvements.

Unfortunately, I did find some more issues:

In the monthly grid the weekday headers don't align with the calendar grid below if events have longer titles:
Badge is showing inline with no gap with the title. I think it should show above like with discussions:
There is always a vertical layout shift after opening an upcoming events details modal as the countdown is being pushed in. Maybe apply a min-height of 95px on that to lessen that layout reshuffle a bit
On the month calendar grid weekday names are now localized, but not on the weekly:
The category dropdown is cropping characters that extend below the baseline. See the "g" and "y" being slightly cropped: