 |
Краткое описание | Right Sidebar Blocks отображает боковую панель справа от списков тем с настраиваемым списком блоков. |
 |
Предпросмотр | Предпросмотр в Discourse Theme Creator |
 |
Ссылка на репозиторий | https://github.com/discourse/discourse-right-sidebar-blocks |
 |
Новичок в темах Discourse? | Руководство для начинающих по использованию тем Discourse |
Установить этот компонент темы
Особенности
Компонент включает несколько блоков, которые можно отображать в боковой панели:
- popular-tags
- top-contributors
- recent-replies
- category-topics
- custom-html
- category-list
- subcategory-list
- upcoming-events-list*
- minimal-gamification-leaderboard**
Для заполнения списка «Лучшие участники» (Top Contributors) необходимо включить каталог пользователей. Если ваш список пуст, найдите в настройках администратора
enable user directoryи убедитесь, что он включен.
* Доступно только при использовании с плагином Календарь.
** Доступно только при использовании с плагином Гамификация.
Вы также можете использовать другие Ember-компоненты в качестве блоков, просто нужно использовать правильное имя. Например, в ядре Discourse есть Ember-компонент signup-cta, и вы можете использовать его в боковой панели как есть. Обратите внимание, что вы не можете использовать компоненты, которые ожидают набора параметров, но вы можете создать свой собственный Ember-компонент в отдельной теме и ссылаться на него просто по имени в настройке blocks боковой панели.
Некоторые функции предоставленных блоков можно управлять через параметры.
| имя | описание | по умолчанию | значение | доступно для |
|---|---|---|---|---|
count |
ограничивает количество результатов | варьируется | число | все, кроме custom-html |
excerptLimit |
ограничивает длину каждого отрывка ответа | 150 | число | recent-replies |
id |
идентификатор категории | идентификатор категории (category-list использует разделенные запятыми) | category-topics, category-list | |
content |
содержимое для отображения | html | custom-html | |
scopeToCategory |
показывает только в категории или подкатегории X | идентификатор категории | popular-tags | |
excludedTags |
список исключенных тегов | имена тегов | popular-tags | |
displayInSpecificCategories |
список категорий для отображения виджета | все | разделенные запятыми числа | popular-tags |
id |
идентификатор таблицы лидеров | число | minimal-gamification-leaderboard | |
tag |
какой тег отображать | имя тега | tag-topics | |
period |
период времени для лучших тем | weekly | all, yearly, quarterly, monthly, weekly, daily | top-topics |
title |
заголовок блока | варьируется | строка | tag-topics, category-list, top-contributors |
excludedGroupNames |
исключает указанные группы | Имена групп | top-contributors | |
order |
сортировка участников | Строка (likes_received или likes_given) | top-contributors | |
period |
период времени для лучших участников | yearly | all, yearly, quarterly, monthly, weekly, daily | top-contributors |
includeSubcategories |
включает события подкатегорий | false | false, true | upcoming-events-list |
upcomingDays |
события, начавшиеся до указанного значения | 180 | число | upcoming-events-list |
timeFormat |
формат даты/времени события | LT | формат momentjs | upcoming-events-list |
Настройки
| Имя | Описание |
|---|---|
| blocks | |
| show in routes | Только для продвинутых пользователей: ограничить боковую панель выбранными маршрутами. Примеры: discovery.latest, discovery.unread, discovery.new, discovery.top, tag.show, “c/category-slug” (для категорий), “tag/sample-tag” (для тегов). Если пусто, боковая панель отображается на всех маршрутах списков. |
blocks: выберите блоки для отображения и настройте их порядок
show_in_routes: решите, на каких маршрутах списков тем отображать боковую панель. По умолчанию она будет отображаться на всех маршрутах discovery, кроме /categories.
| Перевод | По умолчанию |
|---|---|
| top_contributors.heading | Лучшие участники |
| top_contributors.view_all | Показать все |
| popular_tags.heading | Популярные теги |
| popular_tags.view_all | Показать все |
| recent_replies.heading | Последние ответы |
| subcategory_list.heading | Подкатегории |
| top_topics.heading | Лучшие темы |
| category_list.heading | Категории |
Скриншоты
Обратите внимание, что компонент поставляется только с очень базовой стилизацией, предполагается, что администраторы, использующие компонент, добавят свою собственную стилизацию в свою тему.
Взаимодействие
При использовании совместно с плагином Discourse Calendar, вы можете добавить блок боковой панели для ваших предстоящих событий. Имя блока — upcoming-events-list, а формат даты можно настроить, следуя этому синтаксису (например, MMMM D, YYYY). Вы также можете настроить, насколько далеко в будущее смотреть, и включены ли события подкатегорий (см. таблицу выше)
