README

This package extends the functionality of the Filament Spatie Media Library plugin by adding support for translations with Spatie Translatable and compatibility with Filament repeaters.

Installation

You can install the package via composer:

composer require antoinecorbin/filament-advanced-spatie-media-library

Configuration

The package works automatically without additional configuration. It uses the existing Spatie Media Library configuration.

Usage

Basic Usage

use AntoineCorbin\Form\Components\AdvancedMediaLibraryFileUpload;

AdvancedMediaLibraryFileUpload::make('media')

With Translations

To use translations, your model must use Spatie's HasTranslations trait:

use Spatie\Translatable\HasTranslations;

class Post extends Model
{
    use HasTranslations;
    
    public array $translatable = ['media'];
}

In a Repeater

The component works automatically within a Filament repeater:

Repeater::make('sections')
    ->schema([
        AdvancedMediaLibraryFileUpload::make('images')
    ])

Features

Full translation support with Spatie Translatable
Smart media management in repeaters
Automatic abandoned file cleanup
Repeater index updates
Multiple collection support
Image manipulation compatibility
Responsive images support

Advanced Usage

The component automatically handles:

File uploads and organization within repeater fields
Translation management for multilingual media
Media collection management
Custom properties preservation
Automatic cleanup of unused media

Available Methods

AdvancedMediaLibraryFileUpload::make('media')
    ->collection('images') // Set a specific media collection
    ->multiple() // Allow multiple file uploads
    ->responsiveImages() // Enable responsive images
    ->customProperties([]) // Add custom properties to media
    ->withManipulations([]) // Add image manipulations

License

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

antoinecorbin / filament-advanced-spatie-media-library

Maintainers

Details