Adds ability to display a right-sided sidebar to topic list routes. There are two settings included:
blocks: choose the blocks to display and adjust their orderingshow_in_routes: decide which routes to display the sidebar (by default, it will show on all lists except for/categories)
This theme component includes a few blocks you can use in your sidebar:
- popular-tags
- top-contributors
- recent-replies
- category-topics
- custom-html
- subcategory-list
- tag-topics
- top-topics
- category-list
You can also use other Ember components as blocks, you just need to use the correct name. For example, core includes a signup-cta Ember component, and you can use it in the sidebar as is. (Note that you can't use components that expect a set of parameters.)
You can control some features for the provided blocks via parameters.
| name | description | default | value | available for |
|---|---|---|---|---|
| count | limits number of results | varies | number | all except custom-html |
| excerptLimit | limits length of each reply excerpt | 150 | number | recent-replies |
| id | category id | category id (category-list uses comma-separated) | category-topics, category-list | |
| content | contents to display | html | custom-html | |
| scopeToCategory | only shows in category X | category id | popular-tags | |
| excludedTags | list of excluded tags | tagnames | popular-tags | |
| displayInSpecificCategories | list of categories to show the widget | all | comma-separated numbers | popular-tags |
| id | leaderboard id | number | minimal-gamification-leaderboard | |
| tag | which tag to display | tag id | tag-topics | |
| period | time period of top topics | weekly | all, yearly, quarterly, monthly, weekly, daily | top-topics |
| title | title of the block | varies | string | tag-topics, category-list |
| excludedGroupNames | Excludes specified groups | Group names | top-contributors | |
| order | Orders the contributors | likes_received | String (likes_received or likes_given) | top-contributors |
| period | Time period for top contributors | yearly | all, yearly, quarterly, monthly, weekly, daily | top-contributors |
The Discourse Calendar plugin comes with a block called upcoming-events-list that you can use in conjunction with this component. You'll want to ensure the desired route is enabled via the events calendar categories setting in the Calendar plugin settings. The block params use this syntax, for example MMMM D, YYYY.