 |
Краткое описание | Создание пользовательских боковых меню для выбранных групп |
 |
Предпросмотр | Присоединитесь к группе создателей тем, а затем просмотрите здесь |
 |
Репозиторий | https://github.com/Lillinator/discourse-group-sidebar-menus |
 |
Руководство по установке | Как установить тему или компонент темы |
 |
Новичок в темах Discourse? | Начинающее руководство по использованию тем Discourse |
Установить этот компонент темы
Обзор
Этот компонент темы Discourse предоставляет администраторам форумов возможность создавать пользовательские боковые меню, доступные только членам выбранных групп.
Ключевые особенности:
- Отображение меню на основе групп — разделы меню отображаются в боковой панели только для авторизованных пользователей
- Конфигурация на основе объектов — удобный интерфейс настроек для создания меню
- Несколько разделов — создание неограниченного количества разделов меню для разных групп (в разумных пределах)
- Ссылка на быстрое редактирование администратором — значок карандаша в заголовках меню ведет администраторов напрямую к настройкам компонента
Примеры использования
- Ресурсы и быстрые ссылки только для сотрудников
- Ярлыки для модераторов категорий
- Пользовательские порталы групп (проектные команды, учебные группы, книжные клубы, участники VIP)
- Ссылки на ресурсы родительского или партнерского веб-сайта
Настройки
Разделы меню (menu_sections)
Открывает редактор настроек объектов для конфигурации пользовательских разделов меню групп.
Свойства раздела
| Свойство | Описание |
|---|---|
| Заголовок меню | Заголовок, отображаемый как заголовок раздела боковой панели |
| Разрешенные группы | Группы, которым разрешено просматривать этот раздел меню (максимум: 20 групп на раздел) |
| Ссылки меню | Набор ссылок для отображения в этом разделе (максимум: 20 ссылок на раздел) |
Свойства ссылки
| Свойство | Описание |
|---|---|
| Значок | Название значка FontAwesome (например, circle-info, star, user-group). Возможно, потребуется добавить его в Admin > Все настройки сайта > набор иконок svg |
| Текст | Отображаемая метка для ссылки |
| URL | Целевой адрес ссылки — поддерживает как относительные пути (/faq, /my/preferences), так и абсолютные URL-адреса (https://example.com) |
Установка и конфигурация
- Установите компонент темы согласно инструкции: Installing a theme or theme component.
- Перейдите в
Редактор настроек объектов. - Нажмите кнопку
+ new_menu_section, чтобы настроить первый пользовательский раздел меню. - Задайте новое меню заголовок в поле
Menu title, затем выберите группы, которым вы хотите предоставить к нему доступ. - Нажмите
+ new_menu_section, чтобы добавить еще один раздел, или сохраните изменения.
Скриншоты конфигурации администратора с примером настройки
Свежая установка — перейдите в Редактор настроек объектов.
Примерный сценарий с 2 пользовательскими меню и 3 пользователями, один из которых является администратором:
@Catraлюбит кошек и является членом группыpink, которая будет иметь доступ к менюCat Menu@HelloKittyлюбит собак и является членом группыpurple, которая будет иметь доступ к менюDog Menu@Lillyявляется членом группыpurple, потому что у нее есть собака, а собаки лучше. Однако она также является администратором форума, и администраторы будут иметь доступ к менюCat Menu, потому что за кошками нужен более пристальный надзор
Создайте новое пользовательское меню — для нашего примера создайте Cat menu и добавьте группы, которым разрешен к нему доступ: pink и admins. Затем нажмите кнопку + menu_link, чтобы настроить ссылки для нового меню.
Добавьте ссылки меню — 1. Название значка FontAwesome, 2. текст для отображения ссылки и 3. URL-адрес (относительный или абсолютный). Нажмите кнопку + menu_link, чтобы добавить еще одну ссылку в это меню.
Создайте еще один пользовательский раздел меню под названием Dog menu, предоставьте доступ только группе purple и настройте ссылки:
Скриншоты результата доступа к боковому меню
Пользователь @Catra видит меню Cat! 
Пользователь @HelloKitty видит меню Dog!
Пользователь-администратор @Lilly видит оба меню и может их редактировать! 
Пример конфигурации
Заголовок меню: "Cat Stuff"
Разрешенные группы: team-cat
Ссылки:
- Значок: link
Текст: Видео и фото с кошками
URL: /t/cat-videos-and-photos/123
- Значок: magnifying-glass
Текст: Википедия о кошках
URL: https://en.wikipedia.org/wiki/Cat
Важные замечания
Доступ администратора
Администраторы должны добавить себя в группы, чтобы видеть меню, настроенные для этих групп. Сам статус администратора не дает доступа ко всем пользовательским меню. Это сделано намеренно! Кроме того, администраторы, входящие в разрешенные группы меню, увидят значок карандаша в заголовке раздела, который ведет к настройкам компонента.
Конфигурация групп
- Группа
everyoneне поддерживается — используйте встроенный интерфейс нижнего колонтитула боковой панели для создания глобальных пользовательских меню для всех пользователей, включая анонимных посетителей. - Максимум 20 групп на раздел меню. Если вам нужно больше, создайте дублирующие разделы с разными назначениями групп.
- Пользователи, входящие в несколько групп, увидят все разделы меню, к которым у них есть доступ.
Тестирование и организация
Используйте тестовые учетные записи для проверки правильного доступа для различных комбинаций групп. Ведите учет ваших конфигураций меню, чтобы избежать путаницы по мере роста сложности; для крупных форумов с большим количеством групп рекомендуется использовать матрицу доступа или аналогичную документацию.
Вопросы безопасности
Этот компонент обеспечивает только контроль доступа на уровне интерфейса. Он управляет видимостью меню, но не доступом к ресурсам — этот компонент контролирует только то, что отображается в боковой панели, а не то, кто может получить доступ к самим ресурсам.
Всегда полагайтесь на встроенную систему разрешений Discourse для защиты реальных ресурсов:
- Правильно настройте разрешения категорий
- Установите ограничения видимости тем
- Используйте контроль доступа на основе групп для контента
- Убедитесь, что для доступа к закрытым ресурсам требуется аутентификация
Рекомендации для администраторов:
Настройте разрешения безопасности связанных категорий и членство в группах отдельно — например, ссылка меню на закрытую категорию должна иметь правильно настроенные разрешения этой категории. Администраторы несут ответственность за то, чтобы ссылки на внешние ресурсы были надлежащим образом авторизованы для выбранных групп.
Это был совместный проект с @Moin — ее вклад, вдохновение и отзывы были неоценимы.
) На ваших скриншотах Cat Menu и Dog Menu находятся в боковом меню навигации выше раздела Topics, но моё собственное меню групп отображается в самом низу боковой навигации. Как переместить его выше раздела Topics?