The Control Panel is a client of the same engine as template tags and CLI — same settings, GenerationService, and binary resolver.

Deployable truth lives in system/user/config/super_images.php. Settings visualizes that model — it does not edit config in the CP.

File Manager also gets Super Images actions via the cp_js_end hook.

• Selected driver + formats
• Optimizer binary availability (missing optional tools show as neutral, not errors)
• Default storage adapter
• Delivery mode (generateBeforePageLoad)
• Queue hints when a bridge is present
• Shortcuts into Playground and Diagnostics

There is no invented “total derivatives” counter — Super Images does not keep a derivative database table.

Confirms:

• Encoder quality from config
• Which optimizer tool runs per format
• Resolved binary paths + Ubuntu apt install hints (info tooltip) when a driver or binary is missing

Live servers are assumed to be Ubuntu; hints use sudo apt-get install … only (no macOS/Homebrew).

1. Enter a File ID
2. Choose a profile
3. Generate profile previews

Expands that profile’s variants × formats and runs the real pipeline (preview: true).

You get:

• Original summary
• Grid of up to four preview cards (size, duration, % vs original)
• Ready-to-copy template tag for the profile
• Open in new tab link on each preview image

Files land under a preview/ namespace so they never collide with production derivatives.

Retention: cleanup.previewRetentionDays (example default 2).

If every row fails with libvips.42.dylib, see Drivers — auto fallback should select Imagick or GD instead.

Same checks as php eecli.php super_images:doctor.

Grouped sections: Core · Drivers · Optimizers · Storage · Delivery · Queue · Sources.

• Missing optional optimizer binaries (e.g. optipng, pngquant) report WARN, not PASS.
• Overall health shows Healthy when there are no failures — missing optimizers alone do not block generation (native encoders still work).
• Queue warns when autoGenerate.queue is enabled but the BoldMinded Queue add-on is not installed, with a hint to install it and set autoGenerate.queue => true in config.
• Sources lists configured local roots and remote hosts, with hints when allow-lists are empty.

Use this when formats, Imagick, or optimizers look wrong on a server.

Read-only overview of enabled state, profiles, adapters, encoders, optimizers, and sources.

Sources

Shows whitelisted local path roots and remote hosts from sources in config, plus a copy-paste snippet for adding more. File Manager uploads are always allowed. Edit lists in system/user/config/super_images.php — see Configuration.

Derivative naming

Display-only (edit in PHP config):

• File / asset path template
• Local / remote path template
• Transform hash length
• Include upload directory in {folderHash}
• Live example paths and token glossary

Edit under storage.naming in system/user/config/super_images.php. Details: Storage.

• CLI

• Configuration