Panorama

Panorama is a media audit and maintenance toolkit for ProcessWire images and files. It helps you inspect usage, find duplicates, clean orphaned media, audit alt text and warm image caches from one admin workspace.

It is made for sites where media can spread across many templates, repeaters, galleries and file fields, and where editors need one reliable place to understand media footprint, spot waste and keep generated image variations under control.

Author: Maxim Semenov
Website: smnv.org
Email: maxim@smnv.org

If this project helps your work, consider supporting future development: GitHub Sponsors or smnv.org/sponsor.

What Panorama Does

• Shows dashboard totals for images, files, media fields, average size, recent uploads and largest files.
• Breaks media usage down by file type, field, page and template.
• Loads thumbnail-heavy dashboard panels in the background so the main page stays responsive.
• Provides a visual Explorer workspace with sidebar filters, gallery mode, page grouping and template grouping.
• Uses one shared media-card grid across Dashboard, Explorer, Duplicates and Audit.
• Opens image/file details in a drawer with owner page, template, field, size, dimensions and variations.
• Cleans generated variations for selected images.
• Finds duplicate files by content hash and estimates reclaimable space.
• Audits images missing description/alt text.
• Finds broken references, orphaned originals and orphaned variations.
• Generates image variations in background warmup batches.
• Supports bulk actions such as delete, regenerate variations, tag changes, ZIP export and CSV export.
• Resolves media ownership through Repeaters, Repeater Matrix and FieldsetPage fields where possible.

Admin Area

Panorama adds a dedicated admin section under Setup > Panorama where site editors can:

• review media footprint and disk usage;
• browse images and files visually;
• filter media by any ProcessWire page selector;
• inspect where media is attached;
• open original files or edit owner pages;
• clean image variations;
• refresh duplicate scans;
• review missing alt text;
• delete cleanup candidates with CSRF-protected confirmations;
• run background image-cache warmup jobs.

Interface

Panorama follows the ProcessWire/AdminThemeUikit admin style and uses pw-design-system CSS variables where available.

The interface uses inline Remix-style SVG icons instead of Font Awesome markup, plain ES modules with no build step, and shared media cards with the same internal structure everywhere:

• preview
• filename
• technical metadata such as size, dimensions, owner page or reclaimable space

Requirements

• ProcessWire >= 3.0.227
• PHP >= 8.3

Installation

1. Copy the Panorama folder into /site/modules/.
2. In ProcessWire Admin, refresh modules.
3. Install Panorama.
4. Open Setup > Panorama and adjust the settings.

Configuration

• Dashboard list size controls how many items appear in Largest files and Recent uploads.
• Default media type sets Explorer to images or files by default.
• Default Explorer view sets the initial Explorer mode: by page, by template or gallery.

File Commander

┌─ Panorama ───────────────────────────────────────────────────────────────┐
│ Panorama.module.php                                                     │
│ Entry point, module info and settings.                                  │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaDashboard.php                                               │
│ Dashboard totals, charts, reports, largest files and recent uploads.    │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaExplorer.php                                                │
│ Gallery, page and template media browsing with detail drawer data.      │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaDuplicates.php                                              │
│ Duplicate scan data, grouped matches and reclaim estimates.             │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaAudit.php                                                   │
│ Missing-description/alt-text reports.                                   │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaCleanup.php                                                 │
│ Broken references, orphaned originals and orphaned variations.          │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaWarmup.php                                                  │
│ Background image variation warmup jobs and batch state.                 │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaBulkActions.php                                             │
│ Delete, regenerate, tag, ZIP export and CSV export actions.             │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaMediaUtilities.php                                          │
│ Media scanning, ownership detection and variation helpers.              │
├─────────────────────────────────────────────────────────────────────────┤
│ src/PanoramaCommon.php / src/PanoramaIcons.php                          │
│ Shared rendering, labels, requests and inline SVG icon helpers.         │
├─────────────────────────────────────────────────────────────────────────┤
│ assets/css/Panorama.css                                                 │
│ Main admin UI layer.                                                    │
├─────────────────────────────────────────────────────────────────────────┤
│ assets/js/dashboard.js / assets/js/async-panel.js                       │
│ Chart rendering and background loading for heavier dashboard panels.    │
├─────────────────────────────────────────────────────────────────────────┤
│ assets/js/explorer.js / assets/js/duplicates.js / assets/js/warmup.js   │
│ Interactive workspaces, drawers, searches and background warmup.        │
├─────────────────────────────────────────────────────────────────────────┤
│ assets/js/icons.js / assets/js/legacy-icons.js                          │
│ Shared inline icons and ProcessWire Inputfield icon conversion.         │
├─────────────────────────────────────────────────────────────────────────┤
│ assets/libs/photoswipe / assets/libs/chart                              │
│ Vendored PhotoSwipe 5 lightbox and Chart.js 4 charts.                   │
└─────────────────────────────────────────────────────────────────────────┘

Orphaned-variation detection is heuristic and based on ProcessWire's generated image variation filename convention.

Author

Maxim Semenov
smnv.org
maxim@smnv.org

License

MIT