 |
Краткое описание | Right Sidebar Blocks отображает боковую панель справа от списков тем с настраиваемым списком блоков. |
 |
Предпросмотр | Предпросмотр в конструкторе тем Discourse |
 |
Ссылка на репозиторий | 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**
Для заполнения списка лучших участников должно быть включено каталог пользователей. Если ваш список пуст, найдите в настройках администратора параметр
enable user directoryи убедитесь, что он включён.
* Доступно только при использовании плагина Calendar.
** Доступно только при использовании плагина Gamification.
Вы также можете использовать другие компоненты Ember в качестве блоков; вам просто нужно указать правильное имя. Например, ядро включает компонент 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 |
временной период для топ-тем | еженедельно | все, 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, quarterly, monthly, weekly, daily | top-contributors |
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).
Размещено нами? Компоненты тем доступны для использования в наших тарифах Pro, Business и Enterprise.