Боковая панель обеспечивает быстрый доступ к важным разделам вашего сайта Discourse. Хотя пользователи могут настроить свою собственную боковую панель в соответствии со своими предпочтениями, продуманная настройка по умолчанию особенно помогает новым пользователям и посетителям вашего форума, упрощая навигацию.
В этом руководстве объясняется, как настроить существующие разделы и создать дополнительные разделы в боковой панели. Вы также узнаете, какие настройки можно изменить для конфигурации значений по умолчанию для пользовательских предпочтений, связанных с боковой панелью.
Настройка содержимого по умолчанию для каждого раздела
Раздел «Сообщество»
Верхний раздел вашей боковой панели (без видимого заголовка) называется разделом «Сообщество». Этот раздел виден всем пользователям и содержит основные ссылки для навигации.
Чтобы настроить этот раздел:
- Нажмите Ещё в боковой панели.
- Выберите Настроить этот раздел в нижней части расширенного меню.
Вы можете внести следующие изменения:
- Изменить порядок ссылок, перетащив иконку .
- Изменить иконку, название и ссылку для каждой записи.
- Добавить новые записи в раздел.
Понимание ссылок по умолчанию
Некоторые ссылки по умолчанию имеют специальное поведение:
- Мои сообщения — эта ссылка по умолчанию всегда отображается как «Мои сообщения». Однако:
- Если у пользователя есть один или несколько черновиков, при нажатии на ссылку он переходит к своим черновикам, а не к активности публикаций.
- Если пользователь входит в группу, выбранную в настройке сайта
experimental_new_new_groups, текст ссылки также меняется на «Мои черновики», когда есть черновики.
- Мои сообщения (личные) — видны только пользователям в
personal_message_enabled_groups.- Показывает индикатор непрочитанных сообщений или количество непрочитанных сообщений для вашего личного почтового ящика и почтовых ящиков групп, членом которых вы являетесь.
- Всегда переводит вас в ваш личный почтовый ящик — даже если единственное непрочитанное сообщение находится в групповом ящике.
- Обзор — виден только сотрудникам и модераторам категорий.
- Администрирование — виден только администраторам и модераторам.
- Пригласить — виден только пользователям, имеющим право приглашать других.
Работа с переводами
Ссылки по умолчанию автоматически отображаются на выбранном пользователем языке интерфейса. Однако:
- Настройка текста ссылки по умолчанию перезаписывает его для всех языков.
- Чтобы изменить текст для конкретных языков или скрытых элементов, таких как «Мои черновики», следуйте инструкциям в руководстве по настройке текста в Discourse.
Обработка ссылок, добавленных плагинами
Ссылки, добавленные плагинами, в настоящее время нельзя настроить через редактор боковой панели. Однако вы можете заменить их собственными версиями, используя следующий подход:
- Скройте оригинальную ссылку, добавленную плагином.
- Добавьте собственную ссылку с желаемым поведением и внешним видом.
Некоторые ссылки можно скрыть в настройках плагина. Например, ссылку на предстоящие события можно скрыть, отключив настройку sidebar_show_upcoming_events.
Если такой настройки нет, вы можете скрыть ссылку с помощью пользовательского CSS.
Пример CSS для скрытия или перемещения ссылок плагинов
Полностью скрыть ссылку, добавленную плагином
Этот пример скрывает ссылку, добавленную плагином ActivityPub:
.sidebar-section-link-wrapper[data-list-item-name="activity-pub-about"] {
display: none;
}
Скрыть ссылку только из меню «Ещё»
Полезно, если вы перемещаете ссылку из меню «Ещё», чтобы она всегда была видна:
.sidebar-more-section-content
.sidebar-section-link-wrapper.dropdown-menu__item[data-list-item-name="anniversaries"] {
display: none;
}
Скрыть ссылку только из основного раздела (не из меню «Ещё»)
Полезно, если вы хотите, чтобы ссылка отображалась в меню «Ещё» вместо того, чтобы быть всегда видимой:
.sidebar-section.sidebar-section-wrapper:not(.sidebar-more-section-content)
.sidebar-section-link-wrapper[data-list-item-name="docs"] {
display: none;
}
Для получения дополнительной информации о внесении изменений в CSS на вашем сайте см. руководство по внесению изменений в CSS.
Раздел «Категории»
Вы можете настроить, какие категории будут отображаться по умолчанию в боковых панелях пользователей, в настройке сайта default_navigation_menu_categories. Вы можете перейти туда, выполнив следующие действия:
- Нажмите «Настроить значения по умолчанию» в нижней части раздела категорий (видно только до тех пор, пока не настроены значения по умолчанию).
- Получите доступ к этой настройке через Администрирование > Все настройки сайта и выполните поиск по названию настройки.
Видимость категорий учитывает права пользователей — пользователи увидят в своей боковой панели только те категории, к которым у них есть доступ, даже если вы включите ограниченные категории в значения по умолчанию. Если вы настроите только ограниченные категории как значения по умолчанию:
- Посетители увидят пустой список.
- Зарегистрированные пользователи увидят самые популярные категории (как если бы они сняли выбор со всех категорий).
Опция «Изменить категории боковой панели» в меню рядом с «Категории» настраивает только ваш личный вид, а не значение по умолчанию для всех пользователей.
Раздел «Теги»
Вы можете настроить, какие теги будут отображаться по умолчанию в боковых панелях пользователей, в настройке сайта default_navigation_menu_tags. Вы можете перейти туда, выполнив следующие действия:
- Нажмите «Настроить значения по умолчанию» в нижней части раздела тегов (видно только до тех пор, пока не настроены значения по умолчанию).
- Получите доступ к этой настройке через Администрирование > Все настройки сайта и выполните поиск по названию настройки.
Видимость тегов учитывает права пользователей — теги в скрытой группе тегов не появятся в боковых панелях пользователей, даже если они включены в значения по умолчанию. Если вы настроите только ограниченные теги как значения по умолчанию:
- Все пользователи (включая посетителей) увидят самые популярные теги (как если бы они сняли выбор со всех тегов).
Разделы чата
Все разделы чата доступны только тогда, когда чат включен[1], пользователь имеет право использовать чат[2] и не отключил чат в своих предпочтениях.
Раздел поиска по чату
Поиск по чату управляется настройкой сайта chat_search_enabled.
Раздел «Потоки»
Раздел «Потоки» появляется только для пользователей, являющихся членами хотя бы одного чата, в котором включена потоковая структура.
Раздел «Каналы»
Раздел «Каналы» отображает каналы чата, к которым пользователь присоединился. Пользователи увидят этот раздел, если есть хотя бы один канал, к которому они могут присоединиться на основе прав доступа к категориям. Раздел будет пустым, пока пользователь не присоединится хотя бы к одному каналу.
Вы можете автоматизировать членство в каналах через настройки канала:
- Включите автоматическое добавление участников в настройках канала.
- Новые пользователи, соответствующие критериям, автоматически увидят канал в своей боковой панели.
Раздел «Личные сообщения»
Раздел личных сообщений отображает одно-на-одно и групповые чаты. Чтобы увидеть этот раздел, пользователи должны входить в любую из групп direct_message_enabled_groups.
Вы не можете настроить разговоры по умолчанию для этого раздела. Вместо пустого раздела пользователи увидят кнопку «Начать новое ЛС», заменяющую этот раздел.
Добавление пользовательского раздела
Вы можете создать дополнительные разделы в боковой панели, содержащие пользовательские ссылки. Они появятся после первого раздела и перед разделом категорий. Чтобы добавить новый раздел:
- Нажмите кнопку + в нижней части боковой панели.
- Введите заголовок для вашего раздела.
- Для каждой ссылки, которую вы хотите добавить:
- Выберите иконку.
- Введите название ссылки.
- Укажите целевой URL.
- Нажмите «Добавить еще ссылку», чтобы добавить больше ссылок.
- Установите флажок «Видно всем», чтобы этот раздел отображался для всех пользователей.
- Нажмите «Сохранить», чтобы создать раздел.
Маленькая иконка рядом с заголовком пользовательского раздела видна только администраторам и указывает на то, что раздел виден всем.
Настройка текстовых меток
Вы можете настроить все текстовые метки в боковой панели, включая заголовки разделов:
- Перейдите в Администрирование > Внешний вид > Тексты сайта.
- Найдите текст, который хотите настроить.
Поскольку многие метки боковой панели используют общие слова, найти конкретный ключ текста может быть сложно. Чтобы помочь с этим:
- Используйте функцию подробной локализации, чтобы определить правильный ключ текста.
Настройка значений по умолчанию для пользовательских предпочтений
Пользователи могут настроить свои предпочтения боковой панели по адресу /my/preferences/navigation-menu. Вы можете установить значения по умолчанию для этих предпочтений, используя следующие настройки сайта:
default_sidebar_link_to_filtered_list
Эта настройка контролирует, ведут ли ссылки боковой панели к спискам тем (включая «Все темы» и ссылки в разделах категорий и тегов) к:
- При включении: Списки, отфильтрованные для отображения только непрочитанных или новых тем.
- При отключении: Списки, включающие все темы.
default_sidebar_show_count_of_new_items
Эта настройка контролирует, как отображаются новые элементы в боковой панели:
chat_separate_sidebar_mode
При включении в меню навигации добавляется кнопка чата или форума. Это позволяет пользователям более эффективно переключаться между полноэкранным режимом чата и видом форума. В полноэкранном режиме чата в боковой панели отображаются только разделы, связанные с чатом (например, Мои потоки, Каналы и ЛС). Если установлено значение «всегда», разделы, связанные с чатом, в боковой панели скрываются при просмотре форума. Эта настройка помогает четко разделить опыт работы с форумом и чатом.
Существует настройка сайта default_sidebar_switch_panel_position, которая позволяет решить, должна ли кнопка переключения отображаться в верхней или нижней части боковой панели. Пользователи не могут изменить положение в своих предпочтениях.
Дальнейшая настройка
Вы можете дополнительно улучшить боковую панель на своем форуме, используя компоненты тем. Чтобы изучить доступные варианты, выполните поиск по темам в категории #theme-component::category с тегом sidebar (ссылка). Однако не у каждого компонента есть тема на Meta. Некоторые также были упомянуты в других темах.
Компоненты тем могут добавлять функциональность в вашу боковую панель. Некоторые примеры включают:
- Изменение видимости боковой панели по умолчанию:
- Закрывать боковую панель по умолчанию: GitHub - VaperinaDEV/closed-sidebar-by-default
- Свернуть разделы по умолчанию: GitHub - Arkshine/discourse-collapsed-sidebar- sections-by-default
- Изменить иконки боковой панели и сделать их динамическими: Discourse Dynamic Sidebar Icon
- Изменение порядка разделов боковой панели:
- Дополнительные разделы боковой панели:
- Пользовательские разделы, видимые только для выбранных групп: Discourse Group Sidebar Menus
- Раздел для личных сообщений для отображения прямых ссылок на групповые почтовые ящики: Раздел сообщений для боковой панели
- Компоненты, позволяющие показывать или скрывать определенные разделы для разных групп пользователей, таких как посетители или сотрудники:
- Компоненты, которые отступают подкатегории, такие как:
Связанные ресурсы
- Creating quick access links to Discourse preference pages
- Customize text in Discourse
- Find a translation key with verbose localization