Nextcloud

Über

payload-nextcloud ist ein Storage-Adapter für Payload 3, der Dateien aus Upload-Collections über WebDAV in eine Nextcloud-Instanz überträgt. Er basiert auf `@payloadcms/plugin-cloud-storage` und implementiert einen eigenen Adapter mit den Methoden handleUpload, handleDelete, generateURL und staticHandler. Die Authentifizierung erfolgt über den Nextcloud-Benutzernamen und ein App-Passwort oder Token. Die WebDAV-Dateiwurzel ergibt sich aus der konfigurierten baseUrl, standardmäßig `/remote.php/dav/files/{username}`. Über die Option `rootDirectory` lassen sich Uploads in ein bestimmtes Verzeichnis wie `/Payload` einschränken. Weitere WebDAV-Optionen umfassen `filesPath`, `timeoutMs`, `verifyTLS` und eigene `headers`. Auf Collection-Ebene stehen `directory`, `exposeUrls`, `fieldGroupName`, `syncOnUpload` und `syncOnUpdate` zur Verfügung. Beim Upload schreibt das Plugin WebDAV-Metadaten auf das Dokument: fileId, path, size, mimeType, etag, lastModified, permissions und isDirectory. Die direkte WebDAV-URL landet in `nextcloud.webdav_url`. Optional erzeugt der Adapter über die Nextcloud OCS Files Sharing API einen öffentlichen Freigabelink und speichert ihn in `nextcloud.share_url`. Eine konfigurierbare custom_metadata-Gruppe lässt sich per WebDAV PROPPATCH mit Namensraum und Field Map abgleichen. Die Gruppe `sync_status` protokolliert Zeitpunkt und Fehler des letzten Synchronisationslaufs. Die Felder werden allen aktivierten Collections hinzugefügt. Das Schema bleibt erhalten, auch wenn das Plugin deaktiviert wird, damit Migrationen konsistent bleiben. Voraussetzung sind Payload 3.37.0 oder neuer sowie die Pakete `webdav` und `@payloadcms/plugin-cloud-storage`. Für lokale Entwicklung mit selbstsignierten Zertifikaten lässt sich `verifyTLS` ausschalten, was in Produktion deaktiviert bleiben sollte.

Paketinformationen

Paketname

payload-nextcloud

Neueste Version

0.1.0

Entpackte Größe

109 kB

Lizenz

MIT

Wöchentliche Downloads

2

Zuletzt veröffentlicht

11. Nov. 2025