Nextcloud

Описание

payload-nextcloud — адаптер хранилища для Payload 3, направляющий файлы из upload-коллекций в экземпляр Nextcloud по WebDAV. Построен на базе `@payloadcms/plugin-cloud-storage` и предоставляет кастомный адаптер, покрывающий загрузку, удаление, генерацию URL и статический обработчик для отдачи файлов обратно через Payload. Аутентификация выполняется по имени пользователя Nextcloud и app-password (рекомендуется вместо пароля аккаунта) или токену. WebDAV-корень файлов вычисляется из настроенного baseUrl, по умолчанию `/remote.php/dav/files/{username}`. Загрузки можно ограничивать поддиректорией через параметр `rootDirectory`, например `/Payload`. Настройки на уровне коллекции позволяют задать удалённую директорию, включить или отключить публикацию URL и выбрать, синхронизировать ли метаданные при загрузке и обновлении. При загрузке плагин сохраняет стандартные WebDAV-свойства файла (fileId, path, size, mimeType, etag, lastModified, permissions, isDirectory) на документе. Прямой WebDAV-URL записывается в `nextcloud.webdav_url`. Опционально через Nextcloud OCS Files Sharing API создаётся публичная ссылка, которая сохраняется в `nextcloud.share_url`. Редактируемые кастомные метаданные синхронизируются в WebDAV через PROPPATCH с настраиваемым пространством имён и картой полей. Группа `sync_status` фиксирует время последней синхронизации и возникшие ошибки. Плагин добавляет поля к коллекциям, указанным в конфигурации, и сохраняет схему при отключении, чтобы миграции оставались консистентными. Требуется Payload 3.37.0 или новее, в рантайме используются пакеты `webdav` и `@payloadcms/plugin-cloud-storage`. Для локальной разработки с самоподписанными сертификатами параметр `verifyTLS` можно отключить, но в продакшене так делать не стоит.

О пакете

Имя пакета

payload-nextcloud

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

0.1.0

Размер

109 кБ

Лицензия

MIT

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

2

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

11 нояб. 2025 г.