Filament Attachmate

This package provides attachment management using a polymorphic morphMany relationship within Filament. The system allows for the seamless association of attachments with various models, enabling flexible and efficient handling of file attachments across your application.

Installation

You can install the package via composer:

composer require zeeshantariq/filament-attachmate

Filament version compatibility

Use the package version that matches your Filament major version:

• Filament v3: ^1.1 (e.g. v1.1.1)
• Filament v4: ^1.2 (starting from v1.2.0)
• Filament v5: ^1.2 (starting from v1.2.0)

Examples:

# Filament v3
composer require zeeshantariq/filament-attachmate:^1.1

# Filament v4 or v5
composer require zeeshantariq/filament-attachmate:^1.2

The package comes with publishable assets:

Migrations

php artisan vendor:publish --tag="filament-attachmate-migrations"

Configuration

1. Create your model

php artisan make:model MyModel

2. Configure your model to handle morphMany attachments

use ZeeshanTariq\FilamentAttachmate\Core\InteractsWithAttachments;
// ...

class MyModel extends Model
{
    use InteractsWithAttachments;
    
    // ...
}

3. Configure the Filament resource

• In your form Filament resource declaration you need to add AttachmentFileUpload::make() so your users can upload the attachments.

use ZeeshanTariq\FilamentAttachmate\Forms\Components\AttachmentFileUpload;

public static function form(Form $form): Form
{
    return $form
        ->schema([
            // ...

            AttachmentFileUpload::make(),
        ]);
}

4. Configure the Filament resource The last configuration needed, is to add HandleAttachmets trait to the CreateRecord components of your model

CreateRecord component

use ZeeshanTariq\FilamentAttachmate\Core\HandleAttachments;

class CreateMyModel extends CreateRecord
{
    use HandleAttachments;

    // ...
}

5. Configure the Filament resource The last configuration needed, is to add HandleAttachmets trait to the EditRecord components of your model

EditRecord component

use ZeeshanTariq\FilamentAttachmate\Core\HandleAttachments;

class EditMyModel extends EditRecord
{
    use HandleAttachments;

    // ...
}

Changelog

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

Contributing

Please see CONTRIBUTING for details.

Credits

• zeeshan

License

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