filament-recycle-bin - GitLite

KO | EN

gitlite — search

#javascript #automation #artificial-intelligence #chatbot #awesome #codex #reactjs #python #gemini #svg

filament-recycle-bin

(★ 12)

Central soft-deletes recycle bin for Filament v5 — restore or permanently delete trashed records from one panel page.

File Explorer

ZIP Download

- banner.png
- icon.png
- screenshot.png
- filament-recycle-bin.php
- - RecycleBin.php
- - SoftDeletesModelDiscoverer.php
  - TrashedRecords.php
- FilamentRecycleBinServiceProvider.php
- RecycleBinPlugin.php
- RecycleBinPluginTest.php
- TestCase.php
.gitignore
composer.json
LICENSE
phpunit.xml.dist
README.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`composer`

View Details ▼

A package-based dependency manager for PHP projects.

composer init

Interactively create a `composer.json` file:

composer require {{user/package}}

Add a package as a dependency for this project, adding an entry to `composer.json`:

composer install

Install all the dependencies in this project's `composer.json` and create `composer.lock`:

🔍

`php artisan`

View Details ▼

Laravel's Artisan command-line interface.

php artisan serve

Start PHP's built-in web server for the current Laravel application:

php artisan tinker

Start an interactive PHP command-line interface:

php artisan make:model {{ModelName}} --all

Generate a new Eloquent model class with a migration, factory, and resource controller:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <img src="art/banner.png" alt="Filament Recycle Bin" width="100%">
</p>

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

<p align="center">
  <img src="art/screenshot.png" alt="Recycle Bin panel screenshot" width="100%">
</p>

## Requirements

| Dependency | Version |
|---|---|
| PHP | `^8.2` |
| Laravel | `^11` / `^12` |
| Filament | `^5.0` |

## Installation

```bash
composer require muazzambuilds/filament-recycle-bin
```

Publish config (optional):

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

Register the plugin:

```php
use MuazzamBuilds\FilamentRecycleBin\RecycleBinPlugin;

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

Or register models explicitly:

```php
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

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

## Configuration

```php
// 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:

[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=black)](https://buymeacoffee.com/muazzambuilds)

## License
MIT — see [LICENSE](LICENSE).