Организатор категорий боковой панели

Drew-ART · 21.Ноябрь.2025 00:22:26

Я создал органайзер боковой панели. Некоторое время назад по этому поводу было много обсуждений, и некоторые считали, что он не нужен, но я всегда считал, что мои пользователи не очень технически подкованы или недостаточно хорошо разбираются в работе форума в начале, поэтому я сделал этот выпадающий органайзер для помощи.

Установить этот компонент темы

Вверху есть небольшой переключатель, чтобы пользователи могли переключаться между стандартным видом и этим, выбирая тот, который им больше нравится. Я добавил его, потому что считаю, что многие опытные пользователи захотят настроить свою навигационную боковую панель, но большинство новых пользователей — нет.

Органайзер категорий боковой панели

Компонент темы Discourse, который организует категории боковой панели в настраиваемые сворачиваемые цветные секции с расширенными функциями.

Возможности

10 сворачиваемых секций: Группируйте категории до 10 пользовательских секций
Настраиваемые цвета: Устанавливайте цвета фона и текста для заголовков каждой секции
Градиентные фоны: Опциональный эффект градиентного затухания, как на фото
Значки категорий: Стандартные цветные значки Discourse рядом с категориями можно включать и выключать
Поддержка подкатегорий: Переключатель для каждой секции для показа/скрытия подкатегорий (отступы)
Скрытие категорий: Скрытие определенных категорий из всех представлений
Двунаправленный переключатель: Переключение между пользовательскими секциями и стандартным видом Discourse (кнопка переключения отображается в обоих видах)
Сохранение состояния: Запоминает, какие секции открыты/закрыты, и предпочтение пользователя
Учет прав доступа: Отображает только те категории, к которым у пользователя есть доступ
Несгруппированные категории: Автоматически отображает любые категории без назначения в отдельной секции
Адаптивность для мобильных устройств: Работает на всех размерах устройств

Установка

Перейдите в Администрирование → Настройка → Темы в вашем экземпляре Discourse
Нажмите Установить → Из репозитория Git
Введите: https://github.com/focallocal/sidebar-categories-organizer
Нажмите Установить
Добавьте компонент в вашу активную тему

Настройка

Глобальные настройки

Включить органайзер боковой панели: Включение/выключение пользовательского вида
Показать кнопку переключения: Отображение иконки для переключения между видами (появляется в заголовках как пользовательского, так и стандартного вида)
Показывать значки категорий: Отображение цветных квадратов рядом с названиями категорий
Использовать градиентное затухание: Включение эффекта градиентного фона на заголовках секций (50% сплошной цвет, 50% затухание до прозрачности)
Категории для скрытия: Список слогов категорий через запятую для скрытия из всех представлений (например, staff,private)
Вид по умолчанию: Выбор вида, который загружается по умолчанию (пользовательский или стандартный)

Настройки секций (1-10)

Каждая секция имеет:

Включено: Переключение секции вкл/выкл
Заголовок: Текст заголовка секции
Цвет фона: Выбор цвета фона заголовка секции
Цвет текста: Выбор цвета текста заголовка
Категории: Список слогов категорий через запятую (например, general,support,feedback)
Показывать подкатегории: Переключение для показа/скрытия подкатегорий в этой секции
По умолчанию открыто: Начинается ли секция развернутой или свернутой

Поиск слогов категорий

Слоги категорий находятся в URL:

yoursite.com/c/general/5 → слог: general
yoursite.com/c/feature-requests/12 → слог: feature-requests

Использование

После установки и настройки:

Пользовательский вид: Категории сгруппированы в настроенные секции с цветными заголовками
Развернуть/Свернуть: Нажмите на заголовок секции, чтобы переключить видимость содержимого
Переключение видов: Нажмите на иконку в заголовке для переключения между пользовательским и стандартным видами
- В пользовательском виде: кнопка переключения появляется в заголовке пользовательского вида
- В стандартном виде: кнопка переключения появляется в стандартном заголовке «Категории»
Подкатегории: При включении для секции подкатегории отображаются с отступом ниже родительских категорий
Значки категорий: Маленькие цветные квадраты (если включены) показывают цвет каждой категории
Несгруппированные категории: Любые категории, не назначенные секциям, отображаются в разделе «Другие категории»
Настройки: Ваш выбор вида и состояние открытости/закрытости сохраняются для каждого браузера

Расширенные функции

Градиентные фоны

При включении заголовки секций используют плавный градиент:

50% сплошной цвет (ваш выбранный цвет фона)
50% затухание до прозрачности
Создает современный и стильный вид

Скрытие категорий

Укажите слоги категорий для полного скрытия из боковой панели:

Полезно для категорий только для сотрудников или устаревших категорий
Применяется как к пользовательскому, так и к стандартному виду
Список через запятую (например, staff,private,archived)

Подкатегории

Переключение для каждой секции (не глобально)
Отображение с отступом и шрифтом немного меньшего размера
Уменьшенная непрозрачность для визуальной иерархии
Сохраняет цвета значков категорий

Версия

Текущая: 1.0.1
Минимальная версия Discourse: 3.3.0
Автор: Andy@Focallocal

Лицензия

Лицензия MIT — см. файл LICENSE

Поддержка

Сообщить об ошибках: Issues · focallocal/sidebar-categories-organizer · GitHub

Lilly · 21.Ноябрь.2025 00:43:37

Отличная работа

Совет по настройкам категорий

Вместо того чтобы заставлять администраторов вводить слоганы категорий, вы можете использовать это в вашем файле settings.yml, например:

categories_to_hide:
  type: list
  list_type: category
  default: ""
  description:
    en: "Categories to hide from sidebar completely."

Это создаст настройку, похожую на эту:

Вы также можете сделать то же самое с группами, если захотите создать выпадающий список групп:

groups_this_setting_applies_to:
  type: list
  list_type: group
  default: ""
  description:
    en: "Groups this setting will apply to."

Это создаст что-то вроде этого:

jenmck · 21.Ноябрь.2025 06:11:02

Мне это очень нравится, и это действительно то, о чём я уже думал, так что спасибо!

Вопрос: если у пользователя нет доступа ни к одной категории в определённом разделе, отображается ли сам раздел пользователю?

NateDhaliwal · 21.Ноябрь.2025 06:22:49

Да, так и есть:

github.com/focallocal/sidebar-categories-organizer

javascripts%2Fdiscourse%2Fapi-initializers%2Fsidebar-organizer.js

main


      
          const currentUser = api.getCurrentUser();
          
          // Get categories to hide - handle both list format (array of IDs) and legacy string format
          let hiddenSlugs = [];
          if (settings.categories_to_hide) {
            if (Array.isArray(settings.categories_to_hide)) {
              // New list format: array of category IDs
              hiddenSlugs = settings.categories_to_hide
                .map(id => allCategories.find(cat => cat.id === parseInt(id)))
                .filter(Boolean)
                .map(cat => cat.slug);
            } else if (typeof settings.categories_to_hide === 'string' && settings.categories_to_hide.trim() !== "") {
              // Check if it's pipe-separated IDs (from category picker) or comma-separated slugs (legacy)
              if (settings.categories_to_hide.includes('|')) {
                // New picker format: pipe-separated category IDs
                const idArray = settings.categories_to_hide.split("|").map(s => s.trim()).filter(s => s !== "");
                hiddenSlugs = idArray
                  .map(id => allCategories.find(cat => cat.id === parseInt(id)))
                  .filter(Boolean)
                  .map(cat => cat.slug);
              } else {

@Drew-ART Не должно ли условие там выглядеть как !currentUser || cat.read_restricted?

Drew-ART · 21.Ноябрь.2025 18:52:10

Нет, категория/подкатегория скрыта, если у пользователя нет к ним доступа. Вы также можете вручную скрыть любые из них через настройки.

Drew-ART · 21.Ноябрь.2025 18:53:07

Спасибо, Лилли. Я обновлю это и свои другие недавние компоненты, чтобы сделать их лучше.

Drew-ART · 21.Ноябрь.2025 23:55:11

Компонент обновлён: теперь в нём есть прекрасные выпадающие селекторы категорий.

jenmck · 23.Ноябрь.2025 07:51:41

Понятно, эту часть я уяснил — но речь идёт о самом разделе, а не просто о категории.

Например, если у меня такая структура:

Животные

Коты
Собаки

Облака

Нимбус
Кумулюс

Дни недели

Суббота
Воскресенье

Допустим, у пользователя нет доступа ни к категории «Нимбус», ни к категории «Кумулюс». Будет ли раздел «Облака» всё ещё отображаться у пользователя, но без категорий, вот так:

Животные

Коты
Собаки

Облака

Дни недели

Суббота
Воскресенье

Или раздел «Облака» вообще не будет отображаться, вот так:

Животные

Коты
Собаки

Дни недели

Суббота
Воскресенье

Drew-ART · 24.Ноябрь.2025 02:17:05

Если у пользователя нет прав на просмотр каких-либо категорий в разделе, весь раздел (вкладка) будет скрыт.

Heliosurge · 02.Декабрь.2025 05:06:48

Это довольно круто!

Заставляет меня переосмысливать идеи, ха-ха.

Я рассматриваю возможность использования плагина Doc Categories для создания пользовательских разделов с тематическими меню. Но нужно немного доработать его, чтобы добавить возможность выбора цветов и иконок.

В Markdown есть способ добавить компонент «Установить» в Op.

Что-то изменилось в Meta? На Android здесь не получается выделить текст для цитирования. - О, кажется, проблема решена.

Heliosurge · 02.Декабрь.2025 05:26:12

Привет, Лили, не могла бы ты прислать Markdown для «Установка компонента»?

NateDhaliwal · 02.Декабрь.2025 05:51:19

Вот один для этого компонента:

Установить этот компонент темы

Формат Markdown (замените repoName и repoUrl):

[wrap=theme-install-button repoName="Название компонента" repoUrl="Ссылка на репозиторий GitHub"]
Установить этот компонент темы
[/wrap]

Heliosurge · 02.Декабрь.2025 05:59:14

Спасибо, Нейт. Пытался поискать, но, возможно, использовал слишком общие термины.

NateDhaliwal · 02.Декабрь.2025 06:43:43

О, я не уверен, что это где-то упоминается. Я убрал это из шаблона темы #theme-component .

Heliosurge · 02.Декабрь.2025 21:38:05

Это, безусловно, круто. Meta, возможно, стоит рассмотреть и другие TC zOp, так как они позволяют автоматически вставлять шаблон при создании темы.

Тема		Ответов	Просм.
Nest subcategories under their parent categories in the sidebar UX sidebar	35	3560	05.10.2024
Topic List Sidebars Theme component official , topic-list-sidebars	23	14250	24.02.2026
Showcased Categories Theme component official , showcased-categories	71	10378	08.04.2025
Sidebar with categories Plugin	36	9723	09.06.2020
Category Groups Theme component official , category-groups	18	9051	17.07.2025

Организатор категорий боковой панели

Органайзер категорий боковой панели

Возможности

Установка

Настройка

Глобальные настройки

Настройки секций (1-10)

Поиск слогов категорий

Использование

Расширенные функции

Градиентные фоны

Скрытие категорий

Подкатегории

Версия

Лицензия

Поддержка

Совет по настройкам категорий

Связанные темы