MediaHub 1.21: File Types and Utilities in the library

A large MediaHub library files into collections well enough. Last month's news images are findable if someone put them in a folder. I wanted a faster way to see how many PDFs are in here, or which files have never been used on a page.

I kept wanting those answers without leaving the library. MediaHub 1.21.1 is the recommended release of this cycle. Sites on 1.20.1 upgrade in place.

File Types

Editors already have a Type filter: image, document, audio, video. On a mixed library that still leaves PDFs and Word docs in one bucket.

File Types is a new sidebar section in the library and in the picker. It groups what you have under Images, Documents, Audio, and Video, with a count per extension under each group. Empty groups stay hidden. YouTube and Vimeo show under Video.

Click an extension to filter the grid to those files. The match is on the filename suffix, because ProcessWire file and image fields have no extension selector of their own. German strings for the new sidebar copy ship in the bundled translation.

Utilities

Filing and labelling are optional. Plenty of assets never get either, and some images never get a focus point or a crop. On a busy site those gaps stay invisible until someone asks why the library feels messy, which is an awkward conversation if you resell the module to a client.

Utilities is a second sidebar section: No Collections, No Labels, Has Crops, No Crops, No Focus Point, and Unused. Each row has a count. Unused sits at the top. An unused asset is one with no live page reference in MediaHub's usage records. Crop pages do not count as uses.

You can combine a utility filter with a collection or a label. They run together.

Section headers (Collections, Labels, File Types, Utilities) now treat the chevron and the label as one click target for expand and collapse. The + buttons on Collections and Labels stay their own control. On refresh, the saved open and closed state applies before the sidebar paints, so the tree no longer flashes fully expanded for a moment.

Image variations on asset detail

From 1.20, a field can generate ProcessWire size variations up front on upload and save. Those files live next to the original in the asset folder. On an image's detail page you can now see them: the original plus every size already on disk, with dimensions, file size, modified time, and a download.

You can delete a variation after a confirm dialog. The original stays. ProcessWire recreates a deleted size the next time a template, a field card, or pre-generated sizes on save asks for it.

Upload queue

Finished cards in the upload queue link through to the new asset. A View Library button sits beside Add more. Clicking the dropzone opens the file picker.

Fixes from 1.20.2 and 1.20.3

Combo fields. Removing an asset from a MediaHub picker inside a Combo field looked like it had worked. Saving the page put the asset back. The removal now saves.

Title and alt on field upload. If you upload into a MediaHub field and type a title or alt in the sidebar before you save the page, those values now go onto the library record. Other uses of the same asset inherit them. Promoting custom fields the same way is still on the list.

The rest of the issue index is in the changelog.

Upgrading

You can upgrade 1.20.1 through the Modules screen. There is no database migration. Refresh Process MediaHub afterwards.

Download

MediaHub 1.21.1 is up for signed-in licence holders. The 1.20.1 zip stays available. Full notes for 1.20.2 through 1.21.1 are in the changelog.