discourse/plugins/discourse-calendar
Joffrey JAFFEUX ed6beea336
Some checks are pending
Licenses / run (push) Waiting to run
Linting / run (push) Waiting to run
Publish Assets / publish-assets (push) Waiting to run
Tests / core backend (push) Waiting to run
Tests / plugins backend (push) Waiting to run
Tests / core frontend (Chrome) (push) Waiting to run
Tests / plugins frontend (push) Waiting to run
Tests / themes frontend (push) Waiting to run
Tests / core system (push) Waiting to run
Tests / plugins system (push) Waiting to run
Tests / themes system (push) Waiting to run
Tests / core frontend (Firefox ESR) (push) Waiting to run
Tests / core frontend (Firefox Evergreen) (push) Waiting to run
Tests / chat system (push) Waiting to run
Tests / merge (push) Blocked by required conditions
UX: control event display through a site setting (#34795)
Allows admins to set the `calendar_event_display` site setting to decide
how full-calendar should render events.

It accepts the following values:
- auto
- block
- list-item

And will default to: auto
2025-09-13 11:35:52 +02:00
..
app FEATURE: introduce max attendees for events (#34313) 2025-09-01 22:56:19 +02:00
assets UX: control event display through a site setting (#34795) 2025-09-13 11:35:52 +02:00
config UX: control event display through a site setting (#34795) 2025-09-13 11:35:52 +02:00
db/migrate FEATURE: introduce max attendees for events (#34313) 2025-09-01 22:56:19 +02:00
jobs FEATURE: introduce max attendees for events (#34313) 2025-09-01 22:56:19 +02:00
lib FEATURE: allow picking first day of week in calendar (#34670) 2025-09-02 12:44:50 +02:00
spec UX: control event display through a site setting (#34795) 2025-09-13 11:35:52 +02:00
test/javascripts FIX: compute correct date with local time (#34623) 2025-09-01 11:46:34 +02:00
vendor/holidays FIX: Define the typical AFL Grand Final date. (#34768) 2025-09-11 11:21:31 +10:00
.prettierignore
plugin.rb FEATURE: allow picking first day of week in calendar (#34670) 2025-09-02 12:44:50 +02:00
README.md

Discourse Calendar

Adds the ability to create a dynamic calendar in the first post of a topic.

Topic discussing the plugin itself can be found here: https://meta.discourse.org/t/discourse-calendar/97376

Customization

Events

  • discourse_post_event_event_will_start this DiscourseEvent will be triggered one hour before an event starts
  • discourse_post_event_event_started this DiscourseEvent will be triggered when an event starts
  • discourse_post_event_event_ended this DiscourseEvent will be triggered when an event ends

Custom Fields

Custom fields can be set in plugin settings. Once added a new form will appear on event UI. These custom fields are available when a plugin event is triggered.

Holidays

See an incorrect or missing holiday? Familiarize yourself with the holiday definition Syntax. Then make your updates in the vendor/holiday/definitions directory.

Generate updated holidays as follows.

cd vendor/holidays

# Generate holiday definitions
rake generate:definitions

Install the plugin and switch to the discourse root(not the plugin directory).

# Collect all holiday regions into assets/javascripts/lib/regions.js
bin/rails javascript:update_constants

Interactions with Other Plugins

You can use an element of this plugin with the Right Sidebar Blocks component. You'll want to ensure the desired route is enabled via the events calendar categories setting. In Right Sidebar Block's settings, the block name will be upcoming-events-list, and the params use this syntax, for example MMMM D, YYYY.