Laravel Trash 🗑️

The Laravel "soft delete" functionality is effectively managed through the use of this package. It works like trash in your system.

Installation ⚙️

• You can install the package via composer:

composer require ajaycalicut17/laravel-trash

• Run migrations to create tables for this package:

php artisan migrate

• Check model is "soft delete" able, this package work by using laravel "soft delete" functionality:

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
   use SoftDeletes;
}

• To enable this package for a model, add the Ajaycalicut17\LaravelTrash\Traits\Trashable trait to the Eloquent model:

<?php

namespace App\Models;

use Ajaycalicut17\LaravelTrash\Traits\Trashable;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
   use SoftDeletes, Trashable;
}

• To start listening "trashed" model event, define a $dispatchesEvents property on your Eloquent model:

<?php

namespace App\Models;

use Ajaycalicut17\LaravelTrash\Events\MoveToTrash;
use Ajaycalicut17\LaravelTrash\Traits\Trashable;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use SoftDeletes, Trashable;
+
   /**
    * The event map for the model.
    *
    * @var array
    */
   protected $dispatchesEvents = [
       'trashed' => MoveToTrash::class,
   ];
}

• To override the trash name (Optional):

<?php

namespace App\Models;

use Ajaycalicut17\LaravelTrash\Events\MoveToTrash;
use Ajaycalicut17\LaravelTrash\Traits\Trashable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    use SoftDeletes, Trashable;

    /**
     * The event map for the model.
     *
     * @var array
     */
    protected $dispatchesEvents = [
        'trashed' => MoveToTrash::class,
    ];
+
   public static function trashName(Model $model): string
   {
       return static::class.' '.$model->id;
   }
}

• Publishing the config file (Optional):

php artisan vendor:publish --provider="Ajaycalicut17\LaravelTrash\LaravelTrashServiceProvider" --tag="config"

• To periodically delete the model from the trash, add model:prune Artisan command in your application's App\Console\Kernel class and change the config\trash.php pruning status to "true", you can also enter your pruning period here. (Optional):

use Ajaycalicut17\LaravelTrash\Models\Trash;

/**
 * Define the application's command schedule.
 */
protected function schedule(Schedule $schedule): void
{
   $schedule->command('model:prune', [
       '--model' => Trash::class,
   ])->daily();
}

Usage 🔨

• To get all trash model data:

Trash::all();

• To get all trash model and associated model data:

Trash::with('trashable')->get();

• To restore associated model form trash:

Trash::first()->restoreFromTrash();

• To delete trashed model and associated model:

Trash::first()->deleteFromTrash();

• To delete all trashed model and associated model:

Trash::emptyTrash();

Testing 🧪

composer test

Changelog 🚀

Please see CHANGELOG for more information what has changed recently.

Contributing 🤝

Please see CONTRIBUTING for details.

Credits 🔥

• Ajay A
• All Contributors

License 📃

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