Principles

The Filament Media Library Pro is built on a few core principles that guide its design and development. These principles are useful for anyone considering or using the library.

All actions easily configurable

All Filament actions used in the Media Library are defined in their own class. This means you can easily configure any specific action using their ::configureUsing() method:

php

use RalphJSmit\Filament\Explore\Filament\Actions;

Actions\CreateFolderAction::make();
Actions\CreateFolderBulkAction::make();
Actions\DeleteAction::make();
Actions\DeleteBulkAction::make();
Actions\DownloadAction::make();
Actions\MoveAction::make();
Actions\MoveBulkAction::make();
Actions\RenameAction::make();
Actions\SelectFileAction::make();
Actions\UploadAction::make();

Which can all be directly configured as such:

php

CreateFolderAction::configureUsing(function (CreateFolderAction $action) {
    $action
       ->label('New directory')
       ->successNotificationTitle(function (array $data) {
           return 'Awesome, your directory ' . $data['name'] . ' was created!';
       });
});

Furthermore, you can also easily insert custom actions into all places that you might want them. This includes file actions, empty state actions and bulk actions.

app/Providers/Filament/YourPanelProvider.php

use Filament\Actions\ActionGroup;
use RalphJSmit\Filament\Explore\Filament\Actions\DeleteAction;
use RalphJSmit\Filament\Explore\Filament\Actions\Action;

$plugin
    ->fileActions(fn () => [
        DeleteAction::make(),
        ActionGroup::make([
            Action::make('optimize')
                ->icon(Heroicon::OutlinedSparkles)
                ->action(function (FileData $file) {
                    // ...
                }),
        ]),
    ])

Can power every project

Another core principle that I followed was that the Media Library should be able to power any project. This means projects created from the V1, V2 and V3 of the Media Library with the MediaLibraryItem-structure, projects that already have an existing library of files on a regular Storage-disk, projects that already have an existing library of files on a spatie/media-library-library, or even legacy projects with a wholly different structure.

To learn more about drivers and their details, please read the drivers documentation.

On this page

Filament Plugins

Principles

All actions easily configurable

Can power every project