PHPackages jorisnoo/craft-imageboss - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Image & Media](/categories/media) 4. / 5. jorisnoo/craft-imageboss ActiveCraft-plugin[Image & Media](/categories/media) jorisnoo/craft-imageboss ======================== ImageBoss image CDN integration for Craft CMS with native transform fallback 1.0.3(4w ago)0282↓39%MITPHPPHP ^8.3CI passing Since May 12Pushed 4w agoCompare [ Source](https://github.com/jorisnoo/craft-imageboss)[ Packagist](https://packagist.org/packages/jorisnoo/craft-imageboss)[ RSS](/packages/jorisnoo-craft-imageboss/feed)WikiDiscussions main Synced 4w ago READMEChangelog (4)Dependencies (6)Versions (6)Used By (0) Craft ImageBoss =============== [](#craft-imageboss) [ImageBoss](https://imageboss.me/) integration for [Craft CMS](https://craftcms.com/) with native transform fallback. Requirements ------------ [](#requirements) - PHP 8.3+ - Craft CMS 5 Installation ------------ [](#installation) ``` composer require jorisnoo/craft-imageboss ``` Copy the config file to `config/imageboss.php`: ``` cp vendor/jorisnoo/craft-imageboss/src/config/imageboss.php config/imageboss.php ``` Configuration ------------- [](#configuration) Set your ImageBoss credentials in `.env`: ``` IMAGEBOSS_SOURCE=your-source IMAGEBOSS_TOKEN=your-token # optional, for URL signing IMAGEBOSS_API_KEY=your-key # optional, for cache purging ``` When `IMAGEBOSS_SOURCE` is not set, the plugin falls back to Craft's native image transforms. ### Config Options [](#config-options) OptionDefaultDescription`source``null`ImageBoss source identifier`token``null`HMAC token for URL signing`apiKey``null`API key for cache purging`baseUrl``https://img.imageboss.me`ImageBoss CDN base URL`includeVolumeFolder``true`Include volume folder name in URL path`defaultWidth``1000`Default width for `url()``defaultInterval``200`Step size for srcset generation`presets``[]`Named preset configurations### Presets [](#presets) The plugin supports two approaches for defining presets: config-based and interface-based. #### Option 1: Config-Based Presets [](#option-1-config-based-presets) Define presets in `config/imageboss.php`: ``` 'presets' => [ 'thumbnail' => [ 'min' => 200, // minimum srcset width 'max' => 700, // maximum srcset width 'ratio' => 1, // aspect ratio (optional) 'interval' => 250, // width step (optional) ], 'hero' => [ 'min' => 640, 'max' => 3840, ], 'shareImage' => [ 'min' => 1200, 'max' => 1200, 'ratio' => 1200 / 630, 'format' => 'jpg', // output format (optional) 'quality' => 90, // output quality 1-100 (optional) ], ], ``` #### Option 2: Interface-Based Presets [](#option-2-interface-based-presets) Implement the `ImagePreset` interface on your enum for self-contained presets: ``` use Noo\CraftImageboss\concerns\HasImagePresetHelpers; use Noo\CraftImageboss\contracts\ImagePreset; enum Preset: string implements ImagePreset { use HasImagePresetHelpers; case Default = 'default'; case Thumbnail = 'thumbnail'; case Card = 'card'; case Hero = 'hero'; /** * @return array{min: int, max: int, ratio?: float, interval?: int} */ public function config(): array { return match ($this) { self::Default => ['min' => 320, 'max' => 2560], self::Thumbnail => ['min' => 200, 'max' => 700, 'ratio' => 1, 'interval' => 250], self::Card => ['min' => 300, 'max' => 800, 'ratio' => 4 / 5], self::Hero => ['min' => 640, 'max' => 3840], }; } } ``` The `HasImagePresetHelpers` trait provides convenience methods: ``` Preset::Hero->min(); // 640 Preset::Hero->max(); // 3840 Preset::Card->ratio(); // 0.8 Preset::Thumbnail->interval(); // 250 ``` ### Cache Purging [](#cache-purging) When `IMAGEBOSS_API_KEY` is set, the plugin listens for Craft's `EVENT_AFTER_REPLACE_ASSET` and queues a job that sends a `DELETE` request to the asset's ImageBoss URL. ImageBoss then clears all cached variants of the master image. See the [ImageBoss caching docs](https://imageboss.me/docs/api/caching) for details. Usage ----- [](#usage) ### Twig [](#twig) The plugin registers an `imageboss` template variable and Twig filters. #### Fluent API [](#fluent-api) ``` {# Single URL #} {{ imageboss.from(asset).width(800).url() }} {{ imageboss.from(asset).width(800).ratio(16/9).url() }} {# Responsive srcset with preset #} {{ imageboss.from(asset).preset('hero').srcsetString() }} {# Custom srcset range #} {{ imageboss.from(asset).min(300).max(1200).interval(200).srcsetString() }} {# CDN passthrough (no transform) #} {{ imageboss.from(asset).cdn() }} {{ imageboss.from(asset).cdn({ compression: false }) }} {# Force browser download (standalone or combined with any operation) #} {{ imageboss.from(asset).download(true).url() }} {{ imageboss.from(asset).download('annual-report.pdf').url() }} {{ imageboss.from(asset).width(800).download(true).url() }} {{ imageboss.from(asset).download('annual-report.pdf').cdn() }} {# Animated GIFs (by default only the first frame is processed) #} {{ imageboss.from(asset).width(300).animation().url() }} {{ imageboss.from(asset).width(300).height(300).animation().format('mp4').url() }} {# Placeholder for lazy loading #} {{ imageboss.from(asset).width(800).ratio(16/9).placeholder() }} {{ imageboss.from(asset).preset('card').placeholder('#f0f0f0') }} ``` #### Shorthand Methods [](#shorthand-methods) ``` {# With preset name #} {{ imageboss.url(asset, 'hero') }} {{ imageboss.srcset(asset, 'hero') }} {{ imageboss.placeholder(asset, 'card') }} {{ imageboss.cdn(asset) }} {{ imageboss.cdn(asset, { compression: false }) }} {# With options array #} {{ imageboss.url(asset, { width: 800, height: 600, format: 'webp' }) }} {{ imageboss.url(asset, { width: 300, animation: true }) }} {{ imageboss.srcset(asset, { min: 300, max: 1200, interval: 200 }) }} {{ imageboss.placeholder(asset, { preset: 'card', color: '#e0e0e0' }) }} ``` #### Filters [](#filters) ``` {{ asset | imageboss_url({ width: 800 }) }} {{ asset | imageboss_srcset('hero') }} {{ asset | imageboss_cdn }} {{ asset | imageboss_placeholder({ color: '#e0e0e0' }) }} ``` #### Full Example [](#full-example) ``` {% set result = imageboss.transform(asset, 'hero') %} ``` With a placeholder for lazy loading: ``` ``` ### PHP [](#php) ``` use Noo\CraftImageboss\builders\ImageBossBuilder; // Via the plugin variable $builder = Plugin::$plugin->variable->from($asset); $url = $builder->width(800)->url(); $srcset = $builder->preset('hero')->srcsetString(); $placeholder = $builder->width(800)->ratio(16/9)->placeholder(); ``` ### Builder Methods [](#builder-methods) MethodDescription`width(int)`Set image width`height(int)`Set image height`ratio(float)`Set aspect ratio (width/height)`min(int)`Minimum width for srcset`max(int)`Maximum width for srcset`interval(int)`Width step for srcset`format(string)`Output format override`quality(int)`Output quality 1-100`animation(bool)`Preserve animation for animated GIFs. By default ImageBoss only processes the first frame. Combine with `format('mp4')` to convert to video.`download(bool|string)`Force browser download. `true` keeps the original filename, a string sets a custom one.`preset(string|BackedEnum|ImagePreset)`Apply preset configuration`url()`Generate single URL`srcset()`Generate srcset array`srcsetString()`Generate srcset string`transform()`Get `TransformResult` with `first()`, `last()`, `all()``cdn(array $options = [])`Generate passthrough URL via ImageBoss `cdn` operation (no transform). Falls back to the asset's native URL when no source is configured. Pass `['compression' => false]` to disable ImageBoss compression.`placeholder(?string $color)`Generate SVG data-URI placeholder`aspectRatio()`Get resolved aspect ratioAll setter methods accept `null` safely and return `$this` for chaining. ### Example Output [](#example-output) `url()` returns a single URL: ``` https://img.imageboss.me/your-source/width/800/format:auto/assets/image.jpg ``` `srcsetString()` returns a comma-separated srcset string: ``` https://img.imageboss.me/.../width/640/... 640w, https://img.imageboss.me/.../width/1280/... 1280w ``` When an asset has a focal point set, it's automatically included in the URL: ``` https://img.imageboss.me/your-source/cover/800x450/fp-x:0.25,fp-y:0.75,format:auto/assets/image.jpg ``` Assets without a focal point default to center (`fp-x:0.5,fp-y:0.5`) so cover crops stay centred instead of falling back to ImageBoss's smart-crop. Features -------- [](#features) - Responsive srcset generation with configurable width ranges and intervals - Focal point support from Craft asset focal points - URL signing with HMAC-SHA256 - SVG placeholder generation for lazy loading - Named presets via config or typed enums - Automatic fallback to Craft's native transforms License ------- [](#license) MIT ### Health Score 45 — FairBetter than 91% of packages Maintenance94 Actively maintained with recent releases Popularity16 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~6 days Total 4 Last Release 28d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/0440b6ac994d5566a2ef5886fbac104a73f8458e70dbd20085e241ab0f647e0d?d=identicon)[jorgenoo](/maintainers/jorgenoo) --- Top Contributors [![jorisnoo](https://avatars.githubusercontent.com/u/5810772?v=4)](https://github.com/jorisnoo "jorisnoo (22 commits)") --- Tags imagecmsresponsiveCraftcraftcmscraft-pluginsrcsetimageboss ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/jorisnoo-craft-imageboss/health.svg) ``` [![Health](https://phpackages.com/badges/jorisnoo-craft-imageboss/health.svg)](https://phpackages.com/packages/jorisnoo-craft-imageboss) ``` ### Alternatives [spacecatninja/imager-x Ninja powered image transforms. 29399.9k35](/packages/spacecatninja-imager-x)[nystudio107/craft-imageoptimize Automatically create & optimize responsive image transforms, using either native Craft transforms or a service like imgix, with zero template changes. 232339.5k16](/packages/nystudio107-craft-imageoptimize)[verbb/image-resizer Resize assets when they are uploaded. 126273.9k8](/packages/verbb-image-resizer)[doublesecretagency/craft-googlemaps Maps in minutes. Powered by the Google Maps API. 1269.5k](/packages/doublesecretagency-craft-googlemaps) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)