Nested Docs

Описание

Плагин Nested Docs превращает выбранные коллекции Payload в дерево документов. Для каждой коллекции из массива `collections` он добавляет поле `parent` типа relationship в боковой панели и локализованное поле `breadcrumbs` только для чтения. Редактор выбирает родительский документ, а плагин проходит по цепочке предков и сохраняет breadcrumbs прямо в документе, поэтому иерархия доступна при чтении без пересчёта на лету. Breadcrumbs заполняются в хуке `beforeChange` и записываются обратно в документ. Хук `afterChange` пересохраняет дочерние документы при изменении родителя, чтобы URL и метки потомков оставались актуальными. В поле `parent` настроен `filterOptions`, который исключает сам документ и всех его предков, что предотвращает циклические ссылки. Каждая запись в breadcrumbs хранит связь с документом, а также сгенерированные значения `url` и `label`. Форматирование этих значений управляется функциями `generateURL` и `generateLabel`, которые получают массив документов-предков, текущий документ, конфигурацию коллекции и объект запроса. Имена полей можно переопределить через `parentFieldSlug` и `breadcrumbsFieldSlug`, если в коллекции уже есть поля с такими именами. Плагин можно регистрировать несколько раз для разных наборов коллекций, если нужны независимые деревья. Кроме того, он экспортирует хелперы `getParents`, `createParentField` и `createBreadcrumbsField` для внешнего использования. Peer dependency: Payload 4.0.0-beta.0, лицензия MIT.

О пакете

Имя пакета

@payloadcms/plugin-nested-docs

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

3.85.1

Размер

51 кБ

Лицензия

MIT

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

74,1 тыс.

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

9 июн. 2026 г.