Plugins
Matinee
OEmbed field for Filament Panel and Form Builders.
Form Builder
Form Field
Panel Builder
Dark theme support
Yes
Multi language support
Yes
Compatible with the latest version
Supported versions: 3.x
Documentation

OEmbed and Video field for Filament Panel and Form Builders

Latest Version on Packagist Total Downloads

table repeater opengraph image

#Installation

You can install the package via composer:

composer require awcodes/matinee

Important: If you have not set up a custom theme and are using a Panel follow the instructions in the Filament Docs first. The following applies to both the Panels Package and the standalone Forms package.

Add the plugin's views to your tailwind.config.js file.

content: [
'./vendor/awcodes/matinee/resources/views/**/*.blade.php',
]

Rebuild your custom theme.

npm run build

#Preparing your model

Matinee stores its content as JSON data in a single column on your model. So, it is vital that you cast the column to an array or json object in your model.

protected $casts = [
'video' => 'array', // or 'json'
];

#Usage

use Awcodes\Matinee\Matinee;
 
Matinee::make('video')

#Forcing the preview to show

use Awcodes\Matinee\Matinee;
 
Matinee::make('video')
->showPreview()

#Custom Providers

Matinee comes with a Provider for YouTube and Vimeo, but you can add your own by creating a class and passing it into the providers modifier on the field.

use Awcodes\Matinee\Providers\Concerns\IsMatineeProvider;
use Awcodes\Matinee\Providers\Contracts\MatineeProvider;
 
class CustomProvider implements MatineeProvider
{
use IsMatineeProvider;
 
public function getId(): ?string
{
return 'custom';
}
 
public function getDomains(): array
{
return [
'custom.com',
];
}
 
public function getOptions(): array
{
return [
'controls' => 1,
'title' => 0,
];
}
 
public function convertUrl(?array $options = []): string
{
return 'https://www.custom.com/embed/' . $this->getId() . '?' . http_build_query($options);
}
}

Then you can use it by passing it into the providers modifier on the field instance or globally in the register method of a service provider with the configureUsing() method.

use Awcodes\Matinee\Matinee;
 
Matinee::make('video')
->providers([CustomProvider::class])

#Rendering the video

You are free to render the video in any way you see fit, but Matinee comes with a blade component you can use for convenience.

<x-matinee::embed :data="$data" />

The stored data will take the following shape:

{
"width": "16",
"height": "9",
"responsive": true,
"url": "https:\/\/www.youtube.com\/watch?v=N9qZFD1NkhI",
"embed_url": "https:\/\/www.youtube.com\/embed\/N9qZFD1NkhI?controls=1&start=0",
"options": {
"controls": "1",
"nocookie": "0",
"start": "00:00:00"
}
}

#Testing

composer test

#Changelog

Please see CHANGELOG for more information on what has changed recently.

#Contributing

Please see CONTRIBUTING for details.

#Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

#Credits

#License

The MIT License (MIT). Please see License File for more information.

Adam Weston

Adam is a full-stack web developer (with a focus on Laravel) who has been coding for close to 20 years. He is a core Filament team member as well and has authored numerous plugins for Filament such as Curator, Tiptap Editor and Table Repeater, to name a few. You can learn more about Adam on his website.

14
Plugins
1,313
Stars
More from this author
Featured Plugins