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
| Dependency | Version |
|---|---|
| PHP | ^8.2 |
| Laravel | ^11 / ^12 |
| Filament | ^5.0 |
Installation
composer require muazzambuilds/filament-recycle-binPublish config (optional):
php artisan vendor:publish --tag=filament-recycle-bin-configRegister 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,
];Support
If this package helps you, consider supporting development:
License
MIT — see LICENSE.