Ранее называлось «Discourse Category Sidebars» — название этого компонента темы было обновлено на Topic List Sidebars, так как теперь он поддерживает как категории, так и теги.
 |
Краткое описание | Topic List Sidebars берет тему и применяет ее в качестве боковой панели для списка тем категории или тега. |
 |
Предпросмотр | Предпросмотр в Discourse Theme Creator |
 |
Ссылка на репозиторий | https://github.com/discourse/discourse-topic-list-sidebars |
 |
Новичок в темах Discourse? | Руководство для начинающих по использованию тем Discourse |
Установить этот компонент темы
Возможности
Этот компонент темы берет тему и применяет ее в качестве боковой панели для списка тем категории или тега. Эти боковые панели видны только при ширине браузера 767 пикселей и более (на большинстве планшетов и мониторов).
Что я могу делать с этим компонентом темы?
-
Выберите тему и отобразите ее содержимое в качестве боковой панели для категории или тега.
-
Установите боковую панель для отображения на страницах /latest, /new, /unread и /top, указав
allв качестве имени категории в ваших настройках. -
Выберите, чтобы боковые панели появлялись слева или справа от списка тем.
-
По умолчанию боковая панель категории также отображается для всех ее подкатегорий, если только у подкатегории не определена своя собственная боковая панель (вы можете отключить это, сняв флажок
inherit parent sidebar).
Как настроить?
Выберите свои категории и теги, а также добавьте идентификатор темы (например, example.com/t/example-topic/57), который вы хотите использовать для заполнения содержимого боковой панели.
Я рекомендую создавать темы для боковых панелей в соответствующих категориях/тегах, закрывать тему, чтобы не было ответов, и скрывать ее (чтобы она не появлялась в списке тем).
Обратите внимание, что вы не можете использовать тему из закрытой категории в качестве боковой панели для открытой категории (технически это возможно, но пользователи без доступа к этой закрытой теме просто увидят пустую боковую панель!).
Настройки
| Название | Описание |
|---|---|
| sidebars | Добавление и удаление боковых панелей |
| sidebar side | Выбор: слева или справа |
| inherit parent sidebar | Если флажок установлен, подкатегории наследуют боковую панель своей родительской категории (если у подкатегории не назначена своя собственная боковая панель). Если флажок снят, подкатегории отображают боковую панель только если она указана. |
| stick on scroll | Если флажок установлен, боковая панель имеет фиксированное положение при прокрутке |
Примечания для разработчиков
Каждая боковая панель категории обернута классом, содержащим слаг категории, поэтому для категории персонала это будет .category-sidebar-staff. Вы можете использовать эти классы для стилизации отдельных боковых панелей.
К тегу body на страницах с боковыми панелями также добавляется класс, поэтому вы можете использовать body.custom-sidebar для применения стилей ко всем страницам, на которых есть боковая панель.
Благодарности
Особая благодарность @xrav3nz за создание основы, сделавшей возможным этот компонент!
Размещено у нас? Компоненты тем доступны для использования на наших планах Standard, Business и Enterprise.