Admin Nav

Описание

Плагин заменяет стандартную боковую панель Payload на систему навигации, которую каждый администратор настраивает под себя. Группы и элементы можно перетаскивать, скрывать, переименовывать, менять иконки и вкладывать в подменю через визуальный редактор по адресу /admin/nav-customizer. Расположение сохраняется для каждого пользователя в отдельной коллекции, поэтому сайдбар контент-редактора может отличаться от того, что видит разработчик. Есть сброс к настройкам по умолчанию в один клик. Интеграция работает через хук beforeNavLinks, кастомное admin view и набор REST endpoints в /admin-nav для настроек и живых бейджей. Если defaultNav не задан, плагин автоматически читает коллекции, globals и зарегистрированные admin views из конфига и строит осмысленную структуру, группируя элементы по admin.group и по найденным пакетам плагинов. Элементы навигации фильтруются по read-правилам текущего пользователя: коллекции и globals, к которым у пользователя нет доступа, не отображаются. Конфигурация включает defaultNav для явного задания структуры, collectionSlug и userCollectionSlug для выбора коллекций хранения, endpointBasePath, addCustomizerView, navComponentPath для установки через file: и navFooterSlot для замены стандартной кнопки Customize. Лейблы принимают строку или объект с переводами по языкам, плагин поставляется с французской и английской локализациями с возможностью расширения. Асинхронные badge resolvers на группах и дочерних элементах возвращают счетчики, которые клиент обновляет каждые 60 секунд. Peer-зависимости: Payload 3.x, Next 14, 15 или 16, React 18 или 19. Известная проблема Payload вызывает ошибку createContext в Next 16 с Turbopack при next build. Документированный обходной путь: пометить admin page как force-dynamic и добавить пакет в transpilePackages.

О пакете

Имя пакета

@consilioweb/payload-admin-nav

Последняя версия

0.19.1

Размер

638 кБ

Лицензия

MIT

Загрузок в неделю

144

Последняя публикация

29 сент. 2026 г.