v3 local storage plugin for storing files in nested directories

[lkho]

Following up on an old discussion, I finally created a plugin for this.

https://github.com/lkho/payload-custom-path-local-storage

solving some of the problems:

• grouping files from the same blog post into a folder,
• use a date/hashed path structure to prevent too many files in a flattened directory (reproduce the WordPress behavior)
• add a content hash to files for cache busting purpose
• ...

Features / Capabilities

• Supports customizing file paths stored on disk. Paths can be nested subdirectories.
• Adds an endpoint to allow serving files that have slashes in filenames.
  • e.g. /api/media/a/nested/path/file.jpg instead of /api/media/a%2Fnested%2Fpath%2Ffile.jpg
• Hooks to rewrite the urls and thumbnailURLs to match the above endpoint.
• Fully compatible with the built-in image resizing and post deletion cleanup logic.
  • Payload can still clean up the files with nested paths when the parent document is deleted.
  • However, empty directories are not removed.

Please see the repo readme for details

---

PS: I'm still trying to create another plugin (or extend this one) to handle also cloud-storage adapters. Will update if I get it work 😉