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.0.9 2025-11-27 00:25 UTC

Requires

• php: ^8.1 || ^8.2 || ^8.3
• blade-ui-kit/blade-icons: ^1.8
• davidhsianturi/blade-bootstrap-icons: ^2.1
• illuminate/support: ^10.0 || ^11.0 || ^12.0
• spatie/laravel-medialibrary: ^11.0

Requires (Dev)

• ext-gd: *
• barryvdh/laravel-ide-helper: ^3.0.0
• larastan/larastan: ^3.8.0
• laravel/pint: ^1.22
• orchestra/testbench: ^10.0.0
• orchestra/testbench-browser-kit: ^10.0.0
• pestphp/pest: ^4.0.0
• 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

• 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

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.

for the image editor to work the NPM package "@mlbrgn/media-library-extensions" needs to be installed.

Install

1. Install the laravel package:

  composer require mlbrgn/laravel-medialibrary-extensions

1. Run install command

  php artisan media-library-extensions:install

1. add @import "media-library-extensions" to your app.js (or similar)

import {ImageEditor} from '@mlbrgn/media-library-extensions'

you can optionally set the path to the translations you want to use, but make sure the translations live in the path you specified.

NOTE: Don't forget to run "npm run build" for the image editor to be built!

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

The install command will publish assets, config, translation, views, and a policy. Also it will install the required @mlbrgn/media-library-extensions package

Manual install (without the install command)

You can also manually install by installing the @mlbrgn/media-library-extensions package

  npm install @mlbrgn/media-library-extensions

And publish the required assets

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

add @import for "media-library-extensions" to your app.js (or similar)

import {ImageEditor} from '@mlbrgn/media-library-extensions'

you can optionally set the path to the translations you want to use, but make sure the translations live in the path you specified.

NOTE: Don't forget to run "npm run build" for the imageeditor to be built!

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

Theme

The default themes are:

• plain
• 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 --provider="Mlbrgn\MediaLibraryExtensions\Providers\MediaLibraryExtensionsServiceProvider" --tag="config"

Icons

For icons to work, you will have to install a Blade UIKit/Blade-icons package.

The package is configured to use 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

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

Testing

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