discourse/plugins/discourse-calendar
Natalie Tay 97f0ddf757
FIX: Avoid reloading post in post events so that the revisor doesn't reset (#39284)
Invoking `post.reload` within the `post_created` or `post_edited` events
may cause data within `revisor.post_changes` to reset.
2026-04-15 20:05:45 +08:00
..
app DEV: Fix deprecations in plugins specs and silence output (#39257) 2026-04-15 00:00:46 +02:00
assets UX: Update styles of event badge on topic list, topic header (#39225) 2026-04-13 15:54:43 -04:00
config FEAT: add images to post event events (#38643) 2026-04-13 09:45:06 -05:00
db/migrate FEAT: add images to post event events (#38643) 2026-04-13 09:45:06 -05:00
jobs FIX: skip topic bump when date is in the past (#36784) 2025-12-18 21:29:06 +01:00
lib FEAT: add images to post event events (#38643) 2026-04-13 09:45:06 -05:00
spec DEV: Don't use fab! for non-ActiveRecord model objects (#39272) 2026-04-15 00:52:34 +02:00
test/javascripts FEAT: add images to post event events (#38643) 2026-04-13 09:45:06 -05:00
vendor/holidays DEV: Add 2026 Eid-ul-Fitr holidays for Ghana (#38742) 2026-03-20 10:36:54 +00:00
.prettierignore
package.json DEV: Add a script for generating external types in discourse-types (#37095) 2026-03-09 20:37:43 +01:00
plugin.rb FIX: Avoid reloading post in post events so that the revisor doesn't reset (#39284) 2026-04-15 20:05:45 +08:00
README.md
tsconfig.json DEV: Add a script for generating external types in discourse-types (#37095) 2026-03-09 20:37:43 +01:00

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.