Somewhat unsurprisingly, Discourse Calendar (and Event) adds both the calendar and event features to your Discourse site. With these, you can create individual topic calendars to track important occasions or timelines, display calendars in categories, add a holiday calendar to mark vacations, absences, or sick days, create interactive event topics, as well as show an easy-access calendar summary of all of your upcoming events.
Calendars
Bespoke calendars can be created in multiple topics, and ones you wish to give higher visibility to can be displayed above a categoryâs topic list.
The Event feature allows interactive elements to be inserted into topics which your members can use to sign up to attend or participate in your communityâs activities. These are all summarised in a dedicated site-wide calendar, with the option to add an easy-access link to your navigation menu. You can find more information on how to create and use this feature in:
This should not be confused with Pavilionâs Events plugin (note the plural)
Calendar Settings
Name
Description
calendar enabled
Enable the discourse-calendar plugin. This will add support for a [calendar][/calendar] tag in the first post of a topic.
holiday calendar topic id
Topic ID of staffs holiday / absence calendar.
holiday status emoji
Defines the emoji used for the holiday status.
delete expired event posts after
Posts with expired events will be automatically deleted after (n) hours. Set to -1 to disable deletion.
all day event start time
Events that do not have a start time specified will start at this time. Format is HH:mm. For 6:00 am, enter 06:00
all day event end time
Events that do not have a end time specified will end at this time. Format is HH:mm. For 6:00 pm, enter 18:00
calendar categories
Display a calendar at the top of a category. Mandatory settings are categoryId and postId. eg: categoryId=6;postId=453[1] Other valid settings: tzPicker[2], weekends[3] and defaultView[4].
calendar categories outlet
Allows to change which outlet should show the category calendar.
working days
Set working days. You can display the availability of a group using the timezones tag in a post, eg: [timezones group=admins][timezones]
working day start hour
Start time of the working day hours.
working day end hour
End time of the working day hours.
close to working day hours extension
Set extension time in working day hours to highlight the timezones.
calendar automatic holidays enabled
Automatically set holiday status based on a users region (note: you can disable specific automatic holidays in plugin settings)
Event Settings
Name
Description
discourse post event enabled
[experimental] Enables to attach an event to a post. Note: also needs calendar enabled to be enabled.
discourse post event allowed on groups
Groups that are allowed to create events.
displayed invitees limit
Limits the numbers of invitees displayed on an event.
display post event date on topic title
Displays the date of the event after the topic title.
use local event date
Use local date after topic title instead of relative time.
discourse post event edit notifications time extension
Extends (in minutes) the period after the end of an event when going invitees are still being notified from edit in the original post.
discourse post event allowed custom fields
Allows to let each event to set the value of custom fields.
events calendar categories
Display an events calendar at the top of a category.
sort categories by event start date enabled
Enable the sorting of category topics by event start date.
disable resorting on categories enabled
Allow categories to disable the ability for users to sort on the event category.
sidebar show upcoming events
Show upcoming events link in the sidebar under âMoreâ. Requires post event enabled
The discourse-post-event/events.json endpoint now has an added parameter to switch between simple and detailed response. To get the detailed response you can add ?include_details=true:
This plugin is promising - but thereâs some features that are missing that prevents us from jumping from Pavilionâs plugin
Display non-all-day events with the start time on the calendar, currently every event looks like an all day event.
âAdd Eventâ button in the composer next to the tag selector (not hidden in the cog)
Limit which categories can have events, and if a events are compulsory in a category
Nice to haves:
Event meta data in the topic only appears/is entered at the top of the topic (instead of where ever the curser is
ability to limit which groups can make events in a category (for example - only âEventPlannersâ group can create events in the âDiscussionâ category, but all users can create non-event topics (or edit topics if the topic is set to Wiki)
is it possible to set who can see the participants (âGoingâ, âInterestedâ and âNot Goingâ) of an event?
We use this great addon but now have second thoughts that it might be good to hide these details for unregistered users / guests / search engines and only show to registered users or even TL1 and up.
I noticed that recently the output of the JSON api at /discourse-post-event/events.json changed. For anybody looking to get the former response back (which includes the recurrence parameter), you can use this url: /discourse-post-event/events.json?include_details=true
Hi! We use Events quite a lot and one feature request that keeps popping up is the possibility to limit the amount of people being able to say the are âGoingâ to a certain number. Any thought on this, or maybe even a plan for implementing it?
One thing thatâs difficult for us is that the background of the calendar is transparent, which is causing issues with clashing theme colors. Is it possible to change the background?
Is there a way to generate an iCal from this? Or perhaps subscribe to this kind of calendar? I would like to parse the calendar and then put those events on a map as well.
That looks interesting! But I was thinking to integrate it with my custom map and then add a layer for âeventsâ. But I donât think there is a json output of the calendar somewhere? I guess I have to check how that other plugin does it and then maybe adopt the used method.
Hi, we had a calendar enabled in a category and it was displayed without problems. Now we have created a subcategory and the calendar is gone. I have checked the settings, and the category is still selected to display the calendar. Is this a bug or am I missing something? (Itâs a private forum and I canât share a link.)
Hello!
First, I wanted to thank you for this stellar plugin. We recently enabled it and itâs already seen a lot of great use and reception. One question I have is if itâs possible to have it display the upcoming events calendar that aggregates all event topics at the top of a chosen category.
For example, we currently have an Events category with a calendar at the top, but that only displays event topics created within that category. Being able to have that master calendar at the top would make it easy for folks to find and alleviate some confusion.
Since the update to 3.2 there is an issue with the holiday calendar. Regular users are marked as âon holidayâ based on national holiday calendars which should not be the case.
We already disabled âcalendar automatic holidays enabledâ but the issue still persists
Quick update! thx to Richard from CommuniteQ we figured that the national holiday calendar is applied to regular users who donât have access to our holiday calendar.
And since a lot of users are accessing via VPN, sometimes foreign nationalj holidays are applied
Is there any way to disable the national holiday calendar status for regular users?
Am I correct in assuming that to create a calendar you simply create a new thread/topic, and paste the following into it:
Name Of Calendar
[calendar]
[/calendar]
Then to add entries to the calendar you simply make a new post in the sam thread with something like the following (by clicking on the insert time/date icon in the post options):
Name of Event/Entry
[date-range from=2024-04-18 to=2024-04-19 timezone="Europe/London"]
This adds the entry to the calendar which is great, however:
Is there any way to add entries to a calendar but let those entires have a dedicated thread/topic as well? (I see you can add events in new threads, but there doesnât appear to be any way to add those events to a calendar).
Is there any way to feature âUpcoming Eventsâ from a specific calendar in the digest emails? Or maybe the left hand column, and with each entry linking to the dedicated thread for that entry?
If this is not currently possible do you have any plans to add it?