jeffersongoncalves/laravel-cms-media

CMS media library integration — collections, conversions and a reusable HasCmsMedia concern wrapping spatie/laravel-medialibrary for the Laravel CMS ecosystem

1.0.0 2026-07-21 10:05 UTC

Requires

• php: ^8.2
• illuminate/contracts: ^11.0|^12.0|^13.0
• illuminate/database: ^11.0|^12.0|^13.0
• illuminate/support: ^11.0|^12.0|^13.0
• spatie/laravel-medialibrary: ^11.0|^12.0
• spatie/laravel-package-tools: ^1.15

Requires (Dev)

• larastan/larastan: ^2.9|^3.0
• laravel/pint: ^1.0
• nunomaduro/collision: ^8.0
• orchestra/testbench: ^9.0|^10.0|^11.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

MIT

• Jefferson Gonçalves

• media
• cms
• laravel
• medialibrary

Published on Packagist.org on 2026-07-21 10:06 UTC

README

Laravel CMS Media

Media library integration for the Laravel CMS ecosystem — thin wrapper around spatie/laravel-medialibrary with config-driven collections and conversions.

Installation

composer require jeffersongoncalves/laravel-cms-media
php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-migrations"
php artisan vendor:publish --tag="cms-media-config"
php artisan migrate

Usage

use JeffersonGoncalves\Cms\Media\Concerns\HasCmsMedia;
use Spatie\MediaLibrary\HasMedia;

class Post extends Model implements HasMedia
{
    use HasCmsMedia;
}

$post->addMediaFromRequest('featured_image')->toMediaCollection('featured_image');

Collections and their thumb conversion are configured in config/cms-media.php — featured_image (single file) and gallery (multiple) ship by default.