Admin Nav

Über

Dieses Plugin ersetzt die Standard-Sidebar von Payload durch ein Navigationssystem, das jeder Admin-Benutzer selbst konfigurieren kann. Gruppen und Einträge lassen sich per Drag-and-drop neu anordnen, ausblenden, umbenennen, mit anderen Icons versehen und zu verschachtelten Untermenüs zusammenfassen. Die Konfiguration erfolgt über einen visuellen Customizer unter /admin/nav-customizer. Die Layouts werden pro Benutzer in einer eigenen Collection gespeichert, sodass die Sidebar für Redakteure anders aussehen kann als für Entwickler. Ein Klick setzt die Navigation auf die Standardwerte zurück. Die Integration erfolgt über den beforeNavLinks-Hook, eine Custom-Admin-View und REST-Endpunkte unter /admin-nav. Ohne ein konfiguriertes defaultNav liest das Plugin automatisch Collections, Globals und registrierte Admin-Views aus der Payload-Konfiguration und erstellt daraus eine sinnvolle Navigation. Die Einträge werden anhand der read-Berechtigungen des jeweiligen Benutzers gefiltert, sodass Collections und Globals ohne Zugriffsberechtigung nicht angezeigt werden. Konfigurationsoptionen umfassen defaultNav für ein explizites Layout, collectionSlug und userCollectionSlug für die Datenspeicherung, endpointBasePath, addCustomizerView, navComponentPath für file:-Installationen und navFooterSlot zum Austauschen des Customize-Buttons. Labels akzeptieren einen String oder ein Sprachen-Record. Das Plugin liefert französische und englische Übersetzungen mit und ist erweiterbar. Asynchrone Badge-Resolver auf Gruppen und Untereinträge geben Zähler zurück, die der Client alle 60 Sekunden aktualisiert. Als Peer-Dependencies werden Payload 3.x, Next 14 bis 16 und React 18 oder 19 vorausgesetzt. Ein bekanntes Problem verursacht einen createContext-Fehler unter Next 16 mit Turbopack während des next build-Befehls. Die dokumentierte Lösung besteht darin, die Admin-Seite als force-dynamic zu markieren und das Paket zu transpilePackages hinzuzufügen.

Paketinformationen

Paketname

@consilioweb/payload-admin-nav

Neueste Version

0.19.1

Entpackte Größe

638 kB

Lizenz

MIT

Wöchentliche Downloads

144

Zuletzt veröffentlicht

29. Sep. 2026