Download the PHP package cybercog/laravel-ban without Composer

Laravel Ban

Introduction

Laravel Ban simplify management of Eloquent model's ban. Make any model bannable in a minutes!

Use case is not limited to User model, any Eloquent model could be banned: Organizations, Teams, Groups and others.

Contents

• Features
• Installation
• Usage
  • Prepare bannable model
  • Prepare bannable model database table
  • Available methods
  • Scopes
  • Events
  • Middleware
  • Scheduling
• Integrations
• Changelog
• Upgrading
• Contributing
• Testing
• Security
• Contributors
• Alternatives
• License
• About CyberCog

Features

• Model can have many bans.
• Removed bans kept in history as soft deleted records.
• Most parts of the logic is handled by the BanService.
• Has middleware to prevent banned user route access.
• Use case is not limited to User model, any Eloquent model could be banned.
• Events firing on models ban and unban.
• Designed to work with Laravel Eloquent models.
• Has Laravel Nova support.
• Using contracts to keep high customization capabilities.
• Using traits to get functionality out of the box.
• Following PHP Standard Recommendations:
  • PSR-1 (Basic Coding Standard).
  • PSR-2 (Coding Style Guide).
  • PSR-4 (Autoloading Standard).
• Covered with unit tests.

Installation

First, pull in the package through Composer:

Registering package

The package will automatically register itself. This step required for Laravel 5.4 or earlier releases only.

Include the service provider within app/config/app.php:

Apply database migrations

At last, you need to publish and run database migrations:

Usage

Prepare bannable model

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

Then insert the following code into migration file:

Available methods

Apply ban for the entity

Apply ban for the entity with reason comment

Apply ban for the entity which will be deleted over time

expired_at attribute could be \Carbon\Carbon instance or any string which could be parsed by \Carbon\Carbon::parse($string) method:

Remove ban from entity

On unban all related ban models are soft deletes.

Check if entity is banned

Check if entity is not banned

Delete expired bans manually

Determine if ban is permanent

Or pass null value.

Determine if ban is temporary

Scopes

Get all models which are not banned

Get banned and not banned models

Get only banned models

Scope auto-apply

To apply query scopes all the time you can define shouldApplyBannedAtScope method in bannable model. If method returns true all banned models will be hidden by default.

Events

If entity is banned \Cog\Laravel\Ban\Events\ModelWasBanned event is fired.

Is entity is unbanned \Cog\Laravel\Ban\Events\ModelWasUnbanned event is fired.

Middleware

This package has route middleware designed to prevent banned users to go to protected routes.

To use it define new middleware in $routeMiddleware array of app/Http/Kernel.php file:

Then use it in any routes and route groups you need to protect:

If you want force logout banned user on protected routes access, use LogsOutBannedUser middleware instead:

Scheduling

After you have performed the basic installation you can start using the ban:delete-expired command. In most cases you'll want to schedule these command so you don't have to manually run it everytime you need to delete expired bans and unban models.

The command can be scheduled in Laravel's console kernel, just like any other command.

Of course, the time used in the code above is just example. Adjust it to suit your own preferences.

Integrations

• Laravel Nova Ban

Changelog

Please see CHANGELOG for more information on what has changed recently.

Upgrading

Please see UPGRADING for detailed upgrade instructions.

Contributing

Please see CONTRIBUTING for details.

Testing

Run the tests with:

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Contributors

Anton Komarev	badr aldeen shek salim	Rick Mac Gillis	AnsellC	Joe Archer
Francisco Solis	Jakub Adamec	Ilia Lazarev	ZeoKnight

Laravel Ban contributors list

Alternatives

• https://github.com/imanghafoori1/laravel-temp-tag

License

• Laravel Ban package is open-sourced software licensed under the Anton Komarev.
• Fat Boss In Jail image licensed under Creative Commons 3.0 by Gan Khoon Lay.

🌟 Stargazers over time

About CyberCog

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

• Follow us on Twitter
• Read our articles on Medium