README

Filament Relation Manager Repeater

A Filament plugin that adds a Repeater form interface for editing relationship records in Filament's relation managers.
This plugin allows you to edit multiple related records at once using a repeater component.

Installation

composer require zvizvi/relation-manager-repeater

Usage

Add the RelationManagerRepeaterAction to your relation manager's table actions:

use Zvizvi\RelationManagerRepeater\Tables\RelationManagerRepeaterAction;

class PostsRelationManager extends RelationManager
{
    protected static string $relationship = 'posts';

    public function table(Table $table): Table
    {
        return $table
            ->columns([
                //
            ])
            ->headerActions([
                RelationManagerRepeaterAction::make(),
            ]);
    }
}

Advanced Configuration

Since RelationManagerRepeaterAction extends Filament's Action class, all standard Action configurations are available (label, modalWidth, modalHeading, icon, color, etc.).

You can also customize the repeater component using the configureRepeater method. All standard Filament repeater options are available (reorderable, collapsible, cloneable, grid, itemLabel, etc.):

use Filament\Forms\Components\Repeater;

public function table(Table $table): Table
{
    return $table
        ->columns([
            //
        ])
        ->headerActions([
            RelationManagerRepeaterAction::make()
                ->modalWidth('5xl')
                ->modalHeading('Edit Related Records')
                ->configureRepeater(function (Repeater $repeater) {
                    return $repeater
                        ->reorderable()
                        ->collapsible()
                        ->cloneable()
                        ->defaultItems(0)
                        ->maxItems(5);
                }),
        ]);
}

Form Customization

By default, the repeater uses the form schema defined in your relation manager. You can customize which fields are displayed in the repeater by providing a custom schema:

RelationManagerRepeaterAction::make()
    ->configureRepeater(function (Repeater $repeater) {
        return $repeater
            ->schema([
                // Only include specific fields
                TextInput::make('title'),
                TextInput::make('slug'),
                Toggle::make('is_published'),
                // Other fields...
            ]);
    }),

This allows you to display only a subset of fields from your relation manager's form, or even add custom fields specifically for the repeater interface.

How It Works

The plugin creates a modal with a repeater component that loads all related records. When you save the form:

For each record, it determines whether to:
- Delete records that are no longer present
- Update existing records with new data
- Create new records that were added
Shows a success notification

This approach provides a clean interface for managing multiple related records at once.

Screenshots

Relation manager action button:

Action form editor:

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.

zvizvi / relation-manager-repeater

Maintainers

Details