Media Gallery

Über

Das Plugin ersetzt die Standard-Listenansicht von Payload-Mediensammlungen durch eine Galerieoberfläche. Es wird über `admin.components.views.list.Component` als eigene Admin-Komponente registriert und als `mediaGalleryPlugin` exportiert. Neben der nativen Listenansicht als Fallback bietet es die Layouts Justified, Masonry und Grid, die in einer Layout-Registry verwaltet werden. Die Zielkollektionen werden über die Option `collections` festgelegt, standardmäßig ist das `media`. Jedes Layout rendert Medienkarten mit Hover-Footern für Dateinamen und Metadaten. Der Lightbox-Viewer unterstützt Zoom, Pan, Tastaturnavigation und Touch-Gesten und spielt Bilder, Audio und Video inline ab. Über Quick Edit lässt sich der native DocumentDrawer von Payload direkt aus einer Karte öffnen. Die Mehrfachauswahl funktioniert mit Cmd/Ctrl/Shift-Modifikatoren. Wenn die Zielkollektion `orderable: true` gesetzt hat, lassen sich Karten per Drag-and-Drop über @dnd-kit neu anordnen. Das Plugin ruft dabei den `/reorder`-Endpunkt von Payload auf und aktualisiert die Liste optimistisch. Die Plugin-Optionen umfassen `collections` (Array oder Objekt), `defaultView`, `layouts` (pro Layout aktivierbar, Footer wahlweise bei Hover oder dauerhaft), `lightbox`, `edit` und `disabled`. Die gewählte Ansicht wird pro Kollektion über Payload-Preferences (`getPreference`/`setPreference`) gespeichert. Das Plugin ist als experimentelles Privatprojekt markiert. Es funktioniert nur in der All-Media-Ansicht, nicht in Folders. Die Peer-Dependencies sind Payload ab 3.73.0, @payloadcms/ui ab 3.73.0, Next.js 15 oder 16 und React 18 oder 19.

Paketinformationen

Paketname

@sitebytom/payload-media-gallery

Neueste Version

1.2.0

Entpackte Größe

233 kB

Lizenz

MIT

Wöchentliche Downloads

520

Zuletzt veröffentlicht

3. Feb. 2026