WebberZone Image Optimizer Developer Reference

The full developer reference for WebberZone Image Optimizer lives at webberzone.dev, a site generated directly from the plugin source. It documents every action and filter hook, every function, and every class and public method in the plugin, with parameters, return types and @since versions. The site is regenerated from each release.

The reference site

• Hooks: all wzio_ action and filter hooks, such as wzio_conversion_args and wzio_delivery_enabled.
• Functions: the wzio_get_option(), wzio_update_settings() and other wrapper functions.
• Classes: every class in the WebberZone\Image_Optimizer namespace, with its public methods.

Conventions

The plugin uses the namespace WebberZone\Image_Optimizer and the prefix wzio throughout. Two design decisions matter when extending the plugin:

Sidecar files, named via Helpers::apply_sidecar_naming(): never by string concatenation. Default is photo.jpg → photo.jpg.webp; the Optimized file naming setting can switch a site to photo.webp instead, and code that assumes append-only will 404 there. The optional third argument forces a strategy rather than reading the setting, which is how the plugin looks for copies under the convention a site is not using. Originals are modified only when Compress original images is enabled, always with a verified backup and a restore path. The unscaled original_image is never touched.

<picture> rewriting, not Accept-header rewriting. The HTML is identical for every visitor; the browser picks the source. Do not rely on server-side content negotiation when extending delivery: it is deliberately not how this plugin works.