README

A custom image field for MoonShine admin panel with built-in image compression, resizing, thumbnail generation and format conversion powered by Intervention Image v3.

Requirements

• PHP 8.2+
• Laravel 10|11|12
• MoonShine 4.x
• GD extension

Installation

composer require chocoway/moonshine-compressed-image

Usage

use Chocoway\MoonshineCompressedImage\Fields\CompressedImage;

CompressedImage::make('Photo', 'photo')
    ->width(1000)
    ->height(800)
    ->aspectRatio()
    ->format('webp')
    ->quality(80)
    ->thumb(200, 200)

Available Methods

Examples

Resize with aspect ratio (recommended):

CompressedImage::make('Photo', 'photo')
    ->width(1000)
    ->aspectRatio()
    ->format('webp')
    ->quality(80)

With thumbnail:

CompressedImage::make('Photo', 'photo')
    ->width(1000)
    ->aspectRatio()
    ->format('webp')
    ->quality(80)
    ->thumb(200, 200)

Thumbnail is saved alongside the original with a thumb_ prefix:

• Original: images/photo.webp
• Thumbnail: images/thumb_photo.webp

Convert to WebP without resizing:

CompressedImage::make('Photo', 'photo')
    ->format('webp')
    ->quality(75)

Strict resize to exact dimensions:

CompressedImage::make('Photo', 'photo')
    ->width(1000)
    ->height(500)
    ->format('jpg')
    ->quality(90)

Compatibility

CompressedImage extends the standard MoonShine Image field, so all built-in File and Image methods are fully supported:

CompressedImage::make('Photo', 'photo')
    ->width(1000)
    ->format('webp')
    ->quality(80)
    ->disk('s3')               // custom filesystem disk
    ->dir('uploads/photos')    // storage subdirectory
    ->multiple()               // upload multiple images
    ->removable()              // allow deleting images
    ->keepOriginalFileName()   // preserve original filename

See the MoonShine docs for the full list of available File and Image methods.

License

MIT