Installation

The Media Library is hosted on a private Composer repository. Run the following command to add the repository to your composer.json:

composer config 'repositories.ralphjsmit/*' composer https://satis.ralphjsmit.com

If you have one of my other premium packages installed already, then you don't need to repeat these lines.

The end result should look something like this:

{
    "repositories": [
        {
            "type": "composer",
            "url": "https://satis.ralphjsmit.com"
        }
    ]
}

Next, run the following command to require the package:

composer require ralphjsmit/laravel-filament-media-library:^4.0

This will install the package. If you receive a question to allow the plugin to run code, select yes. Next, you will be prompted for your username (which is your e-mail) and your password (which is your license key, e.g. 8c21df8f-6273-4932-b4ba-8bcc723ef500).

Composer will ask if you want to store your credentials in your global auth.json. If you want to store the credentials per project and not globally, run the following command to create an auth.json file in the root of your project instead: composer config http-basic.satis.ralphjsmit.com {your_username} {your_password} (ensure not to commit the auth.json file by adding it to your .gitignore file).

If you have a Solo-license and are getting a 403 error, then you probably have run out of device activations. Check your license email for a link to remove an existing activation or upgrade your license.

In order to use the Media Library, you will need to set up a Filament custom theme for all panels that you want to use the Media Library in.

If you don't yet have a custom theme, run the following command:

php artisan make:filament-theme

Please follow the instructions in the command to finish the process and register the custom theme in the panel providers that you want to use the package in.

Next, open up the theme.css file for the custom theme and add the following line:

@import '../../../../vendor/ralphjsmit/laravel-filament-media-library/resources/css/index.css';

You should also add this line to any CSS files that you are using if you are planning to use the Media Library outside a Filament panel. You might need to correct the number of ../ to reach the vendor directory depending on where your CSS file is located.

Next, for each of the panels that you want to use the Media Library in, you will need to register the plugin in the panel provider:

use RalphJSmit\Filament\MediaLibrary\FilamentMediaLibrary;

$panel
    ->plugins([
        FilamentMediaLibrary::make(),
    ])

Next, proceed to the configuration of the driver that you intend to use:

• Media Library Item-driver (default): storing media items is as easy as storing just a single ID, based on Spatie Media Library (instructions).
• Storage/disk-driver: let the Media library run on any filesystem disk supported by Laravel (instructions).
• Spatie Media Library driver: ideal for pre-existing Spatie Media Library libraries (coming soon).
• Custom driver: create your own driver to fit your specific needs (instructions).