Adds the ability to create a dynamic calendar in the first post of a topic.
Go to file
Martin Brennan a034764920
FIX: Destroy calendar popover on navigation (#761)
This fixes an issue where we would show the popover for
a calendar event, but then not destroy it when navigating
to another page, which meant it ended up stuck in the top
left of the page.

This brings the behavior in line with other places we do
`destroyPopover()`, like when the mouse leaves the event
element.
2025-06-27 17:20:17 +10:00
.github/workflows DEV: Update CI workflows (#376) 2023-01-10 18:03:55 +00:00
app FEATURE: Add event location/description and "My Events" filter (#746) 2025-06-25 10:20:38 +02:00
assets FIX: Destroy calendar popover on navigation (#761) 2025-06-27 17:20:17 +10:00
config FEATURE: Add event location/description and "My Events" filter (#746) 2025-06-25 10:20:38 +02:00
db/migrate FEATURE: Add event location/description and "My Events" filter (#746) 2025-06-25 10:20:38 +02:00
jobs DEV: moves translatations under discourse_post_event (#627) 2024-10-23 14:06:09 +11:00
lib FEATURE: Add event location/description and "My Events" filter (#746) 2025-06-25 10:20:38 +02:00
public/javascripts DEV: more explicit filename 2018-12-27 19:48:30 +01:00
spec DEV: skip flakey spec (#760) 2025-06-27 15:29:46 +10:00
test/javascripts FEATURE: Add event location/description and "My Events" filter (#746) 2025-06-25 10:20:38 +02:00
vendor/holidays fix: id holidays: adds missing years to cn_new_lunar_day (#750) 2025-06-20 20:49:49 +08:00
.discourse-compatibility DEV: [gjs-codemod] Convert all templates to gjs (#729) 2025-06-06 11:45:25 +01:00
.gitignore DEV: Clean up the plugin (#426) 2023-08-01 22:32:30 +02:00
.npmrc DEV: Switch to use pnpm (#617) 2024-10-14 13:38:37 +02:00
.prettierignore DEV: Update eslint-config-discourse, use prettier for hbs (#365) 2023-01-04 13:44:33 +01:00
.prettierrc.cjs DEV: update eslint, prettier and template-lint (#465) 2023-10-30 16:39:54 -03:00
.rubocop.yml DEV: Introduce syntax_tree for ruby formatting (#363) 2022-12-29 13:30:41 +01:00
.streerc FEATURE: customizable event colors by tags and adjustable max rows in calendar (#482) 2023-12-01 10:10:34 -04:00
.template-lintrc.cjs DEV: Update linting (#491) 2023-11-29 18:31:03 +01:00
Gemfile DEV: Update linting (#491) 2023-11-29 18:31:03 +01:00
Gemfile.lock DEV: [gjs-codemod] Convert all templates to gjs (#729) 2025-06-06 11:45:25 +01:00
LICENSE DEV: Update license (#694) 2025-02-24 11:20:49 +08:00
README.md Update README.md (#598) 2024-08-12 20:26:56 -04:00
eslint.config.mjs DEV: Update linting (#704) 2025-03-17 10:55:49 +00:00
package.json DEV: [gjs-codemod] Convert all templates to gjs (#729) 2025-06-06 11:45:25 +01:00
plugin.rb FEATURE: Add event location/description and "My Events" filter (#746) 2025-06-25 10:20:38 +02:00
pnpm-lock.yaml DEV: [gjs-codemod] Convert all templates to gjs (#729) 2025-06-06 11:45:25 +01:00
stylelint.config.mjs DEV: Update linting (#704) 2025-03-17 10:55:49 +00:00
translator.yml DEV: Add Crowdin support (#84) 2020-12-22 13:08:54 +01: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.