mlbrgn/laravel-medialibrary-extensions

Extensions designed for use with the Media Library package by Spatie. Adds a single image uploader, multiple image uploader and a modal with carousel

2.3.22 2026-07-29 21:33 UTC

Requires

• php: ^8.1 || ^8.2 || ^8.3
• ext-fileinfo: *
• ext-gd: *
• blade-ui-kit/blade-icons: ^1.8
• davidhsianturi/blade-bootstrap-icons: ^2.1
• illuminate/support: ^10 || ^11 || ^12 || ^13
• intervention/image: ^3.0
• intervention/image-laravel: ^1.0
• spatie/laravel-medialibrary: ^11.0

Requires (Dev)

• barryvdh/laravel-ide-helper: ^3.0.0
• larastan/larastan: ^3.8.0
• laravel/pint: ^1.22
• mlbrgn/laravel-form-components: ^1.0
• orchestra/testbench: ^10.0.0
• orchestra/testbench-browser-kit: ^10.0.0
• pestphp/pest: ^4.0.0
• pestphp/pest-plugin-browser: dev-fix/multipart-form-parser
• pestphp/pest-plugin-drift: ^4.0.0
• pestphp/pest-plugin-type-coverage: ^4.0.0
• spatie/laravel-translatable: ^6.0.0
• symfony/dom-crawler: ^7.0.0

Suggests

• ext-pdo_sqlite: Required for the Media Library Extensions demo database.
• blade-ui-kit/blade-heroicons: Optional: SVG icons from Heroicons
• mlbrgn/imageeditor: Required for the image editor UI (install via npm or yarn).

MIT

• Evertjan Garretsen

• media
• laravel
• views
• blade
• laravel-medialibrary
• Mlbrgn
• laravel-medialibrary-extensions

Published on Packagist.org on 2026-07-29 21:33 UTC

README

This package adds functionality toMedia Library package by Spatie:

• Providing a view to upload multiple media
• Providing a view to upload single media

Requirements

This package assumes that spatie/laravel-medialibrary is installed and its default migration has been run to create the media table.

Installation

1. Install the package using:

  composer require mlbrgn/laravel-medialibrary-extensions

1. Run install command

  php artisan medialibrary-extensions:install

You can configure the path to the translations the Image Editor, provided by this package, uses by adding the following to your app.js (or similar).

ImageEditor.translationsPath = '/js/vendor/image-editor/lang';

The install command will publish the needed assets, config, translation, views, and a policy.

Manual install (without using the install command)

You can also manually install by installing the @mlbrgn/laravel-medialibrary-extensions package

  npm install @mlbrgn/laravel-medialibrary-extensions

And publish the required assets

php artisan vendor:publish --provider="Mlbrgn\MediaLibraryExtensions\Providers\MediaLibraryExtensionsServiceProvider" --tag="assets"

Themes

The provided themes are:

• plain (vanilla css and js)
• bootstrap-5

Publishing

Several assets can be published:

• config
• views
• assets
• policy
• translations

to publish all assets:

  php artisan vendor:publish --provider="Mlbrgn\MediaLibraryExtensions\Providers\MediaLibraryExtensionsServiceProvider" --tag="media-library-extensions-config"

to publish a single tag (group of assets):

php artisan vendor:publish --tag=media-library-extensions-config
php artisan vendor:publish --tag=media-library-extensions-views
php artisan vendor:publish --tag=media-library-extensions-assets
php artisan vendor:publish --tag=media-library-extensions-policy
php artisan vendor:publish --tag=media-library-extensions-translations

Icons

For icons to work, you will have to install a Blade UI Kit package.

The package is configured to use the Blade Bootstrap Icons by default. To display them properly install

   composer require davidhsianturi/blade-bootstrap-icons

You can override the icons in the published configuration file of this package and install another Blade UIKit/Blade-icons package

Testing

This package uses Pest PHP for testing. For more information on how to write tests for this package, see the TESTING.md guide.