Skip to content

HFS plugin to show thumbnails for images in place of icons. Works best on "tiles mode" (enable it in frontend's options).

License

Notifications You must be signed in to change notification settings

Feuerswut/hfs-thumbnails

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Changes to the original plugin:

  • AVIF image support (default on, please disable on low-power machines by typing jpeg in the appropriate setting.)
  • Multiple resolutions on request, append &s=(desired-resolution) to get an image with at least that size.
  • The plugin won't actually generate an arbitrary size, but mipmap-style sizes based off the default resolution. (for example: default 256, step size: 2; this will make 64 128 256 512 .. (original image size))
  • these are all saved on disk in file descriptors, since EXIF doesnt really work, it is ignored and the EXIF feature removed.
  • This will allow HFS to act like a pseudo-image-CDN and will give you the option to optimize image delivery as you please.

Thumbnails

HFS plugin to show thumbnails for images in place of icons. Works best on "tiles mode" (enable it in frontend's options).

Plugin "sharp" will be automatically installed because it's necessary for this plugin to work.

image

Extendable

This plugin is extendable: other plugins can add support for more formats without having to care of all details, just the minimum. Let's say you want to create a plugin that adds PDF support to thumbnails. You should do something like:

exports.onDirEntry = ({entry}) => {
    if (entry.n.endsWith('.pdf'))
        entry._th = 1
}

exports.customApi = {
    thumbnails_get({ ctx, path }) {
        if (path.endsWith('.pdf')) {
            const thumbnailImage = ...your code to generate the thumbnail
            return thumbnailImage
        }
    }
}

There's an alternative way to the onDirEntry, and it's to define a frontend_js with this

HFS.onEvent('thumbnails_supported', ({ entry }) =>
    entry.n.endsWith('.pdf') )

About

HFS plugin to show thumbnails for images in place of icons. Works best on "tiles mode" (enable it in frontend's options).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published