Releases: hans2103/plg_system_imagekit
Releases · hans2103/plg_system_imagekit
Release list
Release v26.19.02
Added
- New Delivery fieldset:
- Image delivery toggle to suspend image rewriting without uninstalling.
- Video delivery toggle — proxies
<video src>,<source type="video/*">, and rewrites<video poster>images. Off by default; enable only after configuring video delivery on the ImageKit account. - Reject paths — one glob pattern per line (
*,**,?,#comments) for site-wide path-based exclusion.
- New Asset proxying fieldset (opt-in, requires a web origin configured on ImageKit):
- Template assets — proxy CSS/JS/fonts under
templates/andmedia/templates/. - Extension assets — proxy CSS/JS/fonts under
media/com_*,media/mod_*,media/plg_*,media/lib_*, and the legacycomponents/,modules/,plugins/,libraries/paths. - Core assets — proxy Joomla core CSS/JS/fonts under
media/system/,media/vendor/,media/legacy/,media/cms/.
- Template assets — proxy CSS/JS/fonts under
- New Status diagnostics panel (custom
StatusField): live configuration overview, sample rewritten image and asset URLs, and a copy-paste plain-text report (no secrets) for support tickets. - Per-image opt-out:
data-ik-skipon any<img>leaves that image alone; the attribute is stripped before the HTML reaches the browser. - Extra transformations setting — comma-separated tokens appended to every image URL after
w/q/f-auto(e.g.pr-true,c-at_maxfor progressive JPEG + max-fit cropping). - Opt-in Strip "-WxH" suffix setting. When enabled, filenames like
photo-300x200.jpgare reduced tophoto.jpgand the dimensions are passed astr:w-300,h-200so ImageKit can serve the canonical original at any size. Off by default to stay safe with extensions whose origin only stores sized variants. srcsetdensity descriptors (2x,3x) now resolve to the correct render width using the<img>'s native width as the base.<picture>/<source srcset>and lazy-loader attributes (data-src,data-srcset) are now rewritten alongside<img>.ImageKitHelper::buildAssetUrl()builds a passthrough (notr:) URL for non-image assets.ImageKitHelper::buildUrl()andbuildSrcset()accept an optionalextraTokensparameter for per-call transformations.
Changed
loading="lazy"is no longer added whenfetchpriority="high"is present. The two are semantically conflicting (LCP hint vs. defer); honouring the author's priority hint matches modern Core Web Vitals guidance.- Original quote style on rewritten attributes (
src=,data-src,srcset,href,poster) is preserved instead of being normalised to double quotes. ImageKitHelper::configure()now also acceptsextraTransformationsandrejectPaths.- Plugin description rewritten to reflect image, video, and optional asset delivery.
- Internals:
declare(strict_types=1)in the helper, typed class constants, and#[\Override]ongetSubscribedEvents()(PHP 8.3 polish).
Installation
- Download
plg_system_imagekit_v26.19.02.zipbelow - In Joomla administrator go to System → Extensions → Install
- Upload and install the ZIP
- Enable the plugin under System → Plugins
- Enter your ImageKit URL endpoint and API keys in the plugin settings
For full documentation see the README
plg_system_imagekit v26.10.02
What's changed
- Added
<updateservers>to the manifest so Joomla automatically registers the update server on install — the plugin now appears in System → Update Sites.
Upgrading
If the plugin is already installed, reinstall using the ZIP below to get the update server registered.
plg_system_imagekit v26.10.01
What's changed
- Plugin now only processes images on the frontend (site client). Administrator pages are no longer affected.
Installation
Download plg_system_imagekit_v26.10.01.zip and install via System → Extensions → Install in Joomla.
Release v26.09.01
Added
- Initial release
onAfterRenderrewrites all local<img>src attributes to ImageKit CDN URLs- Automatic
srcsetgeneration for configured breakpoint widths f-autoformat transformation (WebP / AVIF delivered per browser Accept header)- Configurable output quality, srcset widths, and default
sizesattribute data-ik-widthsattribute support for per-image breakpoint override- Existing
sizesattribute on<img>tags is preserved unchanged - CSS
background-imagedocumentation in plugin settings (Usage tab) - Upload local files or remote URLs to ImageKit via built-in curl client
- List, get details, and delete files in the ImageKit Media Library
- Signed URL generation using HMAC-SHA1
- Zero external dependencies — no Composer, no Guzzle, no vendor directory
Installation
- Download
plg_system_imagekit_v26.09.01.zipbelow - In Joomla administrator go to System → Extensions → Install
- Upload and install the ZIP
- Enable the plugin under System → Plugins
- Enter your ImageKit URL endpoint and API keys in the plugin settings
For full documentation see the README