cybercog / laravel-nova-ban by antonkomarev

A Laravel Nova banning functionality for your application.
169,456
40
4
Package Data
Maintainer Username: antonkomarev
Maintainer Contact: anton@komarev.com (Anton Komarev)
Package Create Date: 2018-08-23
Package Last Update: 2022-08-26
Home Page: https://komarev.com/sources/laravel-nova-ban
Language: PHP
License: MIT
Last Refreshed: 2024-04-22 03:01:05
Package Statistics
Total Downloads: 169,456
Monthly Downloads: 4,317
Daily Downloads: 24
Total Stars: 40
Total Watchers: 4
Total Forks: 6
Total Open Issues: 2

Laravel Nova Ban

cog-laravel-nova-ban

Introduction

Behind the scenes cybercog/laravel-ban is used.

laravel-nova-ban-preview

Contents

Installation

Pull in the package through Composer.

$ composer require cybercog/laravel-nova-ban

Usage

Prepare bannable model

use Cog\Contracts\Ban\Bannable as BannableContract;
use Cog\Laravel\Ban\Traits\Bannable;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable implements BannableContract
{
    use Bannable;
}

Prepare bannable model database table

Bannable model must have nullable timestamp column named banned_at. This value used as flag and simplify checks if user was banned. If you are trying to make default Laravel User model to be bannable you can use example below.

Create a new migration file

$ php artisan make:migration add_banned_at_column_to_users_table

Then insert the following code into migration file:

<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class AddBannedAtColumnToUsersTable extends Migration
{
    public function up(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->timestamp('banned_at')->nullable();
        });
    }
    
    public function down(): void
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn('banned_at');
        });
    }
}

Apply new migration.

Register Ban Actions in Nova Resource

Register Ban and Unban actions inside your Bannable Model's Resource.

public function actions(Request $request)
{
    return [
        new \Cog\Laravel\Nova\Ban\Actions\Ban(),
        new \Cog\Laravel\Nova\Ban\Actions\Unban(),
    ];
}

Contributing

Please see CONTRIBUTING for details.

Testing

Run the tests with:

$ vendor/bin/phpunit

Security

If you discover any security related issues, please email open@cybercog.su instead of using the issue tracker.

Contributors

| @antonkomarevAnton Komarev | | :---: |

Laravel Nova Ban contributors list

Alternatives

Feel free to add more alternatives as Pull Request.

License

About CyberCog

CyberCog is a Social Unity of enthusiasts. Research best solutions in product & software development is our passion.