6081bc2249
For historical reasons, Discourse has a customized Ember resolver. This had a much more fuzzy implementation of 'normalize' and 'findTemplate' functions. This leniency meant that our file naming hasn't always matched Ember conventions. Standardizing our naming will make things easier to understand for developers, and will make adoption of newer ecosystem tooling easier (e.g. route-based bundle splitting in Embroider/vite) This commit adds deprecations to the resolver when this leniency is used, and uses a fully bespoke codemod to rename all of the affected routes/controllers/templates in the Discourse core repository. Backwards-compatibility is maintained for anyone looking up the old names in the resolver. |
||
|---|---|---|
| .. | ||
| app | ||
| assets | ||
| config | ||
| db/migrate | ||
| jobs | ||
| lib | ||
| spec | ||
| test/javascripts | ||
| vendor/holidays | ||
| .prettierignore | ||
| plugin.rb | ||
| 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_startthis DiscourseEvent will be triggered one hour before an event startsdiscourse_post_event_event_startedthis DiscourseEvent will be triggered when an event startsdiscourse_post_event_event_endedthis 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.
