Nested Docs

Über

Das Plugin erweitert ausgewählte Payload-Collections um eine Eltern-Kind-Hierarchie. Für jede konfigurierte Collection fügt es ein `parent`-Relationship-Feld in der Sidebar sowie ein lokalisiertes, schreibgeschütztes `breadcrumbs`-Array-Feld hinzu. Redakteure wählen ein übergeordnetes Dokument, und das Plugin durchläuft die Vorgängerkette, um den Breadcrumb-Pfad zu generieren und im Dokument zu speichern. Die Breadcrumbs werden über einen `beforeChange`-Hook befüllt und direkt ins Dokument geschrieben, sodass die Hierarchie zur Lesezeit abfragbar ist. Ein `afterChange`-Hook speichert Kind-Dokumente neu, wenn sich das übergeordnete Dokument ändert, und hält so URLs und Labels der Nachfahren synchron. Das `parent`-Feld nutzt `filterOptions`, um das aktuelle Dokument und alle Vorfahren auszublenden, wodurch Zyklen vermieden werden. Jeder Breadcrumb-Eintrag speichert eine Relationship zum Dokument sowie generierte `url`- und `label`-Werte. Beide Werte werden über die optionalen Funktionen `generateURL` und `generateLabel` erzeugt, die die Vorgängerkette, das aktuelle Dokument, die Collection-Konfiguration und den Request übergeben bekommen. Neben dem `collections`-Array mit den Ziel-Slugs lassen sich optional `parentFieldSlug` und `breadcrumbsFieldSlug` überschreiben. Das Plugin kann mehrfach mit unterschiedlichen Collection-Sets registriert werden. Es exportiert die Helfer `getParents`, `createParentField` und `createBreadcrumbsField` für die externe Verwendung. Als Peer-Dependency benötigt es Payload in Version 4.0.0-beta.0, lizenziert unter MIT.

Paketinformationen

Paketname

@payloadcms/plugin-nested-docs

Neueste Version

3.90.2

Entpackte Größe

51 kB

Lizenz

MIT

Wöchentliche Downloads

126.091

Zuletzt veröffentlicht

23. Sep. 2026