Automatically display your media (video, audio, pdf, image, ...) with an action in Filament. The package automatically detects the media extension to display the correct player.
You can install the package via composer:
composer require hugomyb/filament-media-action
Optionally, you can publish the view using
php artisan vendor:publish --tag="filament-media-action-views"
Optionally, you can publish the translations using
php artisan vendor:publish --tag="filament-media-action-translations"
Like a classic Filament Action, you can use MediaAction anywhere (Forms, Tables, Infolists, Suffix and prefix, ...).
Simply provide the url of your media in the ->media()
method. The package will then automatically detect your media extension for display.
MediaAction::make('tutorial')
->iconButton()
->icon('heroicon-o-video-camera')
->media('https://www.youtube.com/watch?v=rN9XI9KCz0c&list=PL6tf8fRbavl3jfL67gVOE9rF0jG5bNTMi')
You can customize the modal as you wish in the same way as a classic action (see https://filamentphp.com/docs/3.x/actions/modals).
If there is an existing record, you can access it by passing a closure to ->media()
method.
Example :
MediaAction::make('media-url')
->modalHeading(fn($record) => $record->name)
->modalFooterActionsAlignment(Alignment::Center)
->media(fn($record) => $record->url)
->extraModalFooterActions([
MediaAction::make('media-video2')
->media('https://www.youtube.com/watch?v=9GBXqWKzfIM&list=PL6tf8fRbavl3jfL67gVOE9rF0jG5bNTMi&index=3')
->extraModalFooterActions([
MediaAction::make('media-video3')
->media('https://www.youtube.com/watch?v=Bvb_vqzhRQs&list=PL6tf8fRbavl3jfL67gVOE9rF0jG5bNTMi&index=5')
]),
Tables\Actions\Action::make('open-url')
->label('Open in browser')
->url(fn($record) => $record->url)
->openUrlInNewTab()
->icon('heroicon-o-globe-alt')
])
As shown in the example above, you can chain MediaActions together with ->extraModalFooterActions()
method.
You can customize the modal view by publishing the view using :
php artisan vendor:publish --tag="filament-media-action-views"
Then, in the view, you can access :
$mediaType
: To retrieve the type of your media, which can be “youtube”, “audio”, “video”, “image” or “pdf”.$media
: To retrieve the url of your mediaType | Extensions |
---|---|
Video | mp4, avi, mov, webm |
Audio | mp3, wav, ogg, aac |
Documents | |
Image | jpg, jpeg, png, gif, bmp, svg, webp |
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.