README

Filament Recycle Bin

Central soft-deletes recycle bin for Filament v5. Register once, then restore or permanently delete trashed records from every SoftDeletes model in one place.

Requirements

Installation

composer require muazzambuilds/filament-recycle-bin

Publish config (optional):

php artisan vendor:publish --tag=filament-recycle-bin-config

Register the plugin:

use MuazzamBuilds\FilamentRecycleBin\RecycleBinPlugin;

$panel->plugin(
    RecycleBinPlugin::make()
        ->discoverModels() // scans app/Models for SoftDeletes
);

Or register models explicitly:

use App\Models\Post;
use App\Models\Comment;

$panel->plugin(
    RecycleBinPlugin::make()
        ->models([
            Post::class,
            Comment::class,
        ])
);

Usage

Open Recycle Bin in the panel navigation.

From there you can:

• Search and filter trashed records by model type
• Restore a single record or selected rows
• Permanently delete a single record or selected rows
• Empty the entire bin for registered models

Authorization

RecycleBinPlugin::make()
    ->authorize(fn (): bool => auth()->user()->isAdmin());

Configuration

// config/filament-recycle-bin.php
return [
    'navigation_group' => null,
    'navigation_sort' => -1,
    'navigation_icon' => 'heroicon-o-trash',
    'title_attributes' => ['title', 'name', 'label', 'email', 'subject', 'slug'],
    'per_model_limit' => 500,
];

License

MIT — see LICENSE.