A package to moderate Laravel models







A package to moderate Laravel models

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Note: This package is a copy of Laravel Moderation Package by Alex Kyriakidis. I have made this for my personal use as the original package is not maintained anymore. Also, I am a rookie at laravel package development, so don't expect much improvement in the features of the package except for upgrading to support latest versions.


You can install the package via composer:

composer require eightanddouble/laravel-moderator

You can publish the config file with:

php artisan vendor:publish --tag="laravel-moderator-config"

This is the contents of the published config file:

return [
	| Status column
	'status_column' => 'status',
	| Moderated At column
	'moderated_at_column' => 'moderated_at',
	| Moderated By column
	| Moderated by column is disabled by default.
	| If you want to include the id of the user who moderated a resource set
	| here the name of the column.
	| REMEMBER to migrate the database to add this column.
	'moderated_by_column' => null,
	| Strict Moderation
	| If Strict Moderation is set to true then the default query will return
	| only approved resources.
	| In other case, all resources except Rejected ones, will returned as well.
	'strict' => true,

Prepare Model

To enable moderation for a model,

  1. use the EightAndDouble\LaravelModerator\Moderatable trait on the model
  2. Add the
    • status,
    • moderated_by
    • moderated_at

columns to your model's table.

use EightAndDouble\LaravelModerator\Moderatable;

class Post extends Model
    use Moderatable;

Create a migration to add the new columns.

Example Migration:

class AddModerationColumnsToPostsTable extends Migration
	* Run the migrations.
	* @return void
    public function up()
        Schema::table('posts', function (Blueprint $table) {
            //To track who moderated the Model, add 'moderated_by' and set the column name in the config file.

	* Reverse the migrations.
	* @return void
    public function down()
        Schema::table('posts', function(Blueprint $table)

You are ready to go!

From Original Readme

Possible Use Case

  1. User creates a resource (a post, a comment or any Eloquent Model).

  2. The resource is pending and invisible in website (ex. Post::all() returns only approved posts).

  3. Moderator decides if the resource will be approved, rejected or postponed.

  4. Approved: Resource is now public and queryable.

  5. Rejected: Resource will be excluded from all queries. Rejected resources will be returned only if you scope a query to include them. (scope: withRejected)

  6. Postponed: Resource will be excluded from all queries until Moderator decides to approve it.

  7. You application is clean.


Note: In next examples I will use Post model to demonstrate how the query builder works. You can Moderate any Eloquent Model, even User.

Moderate Models

You can moderate a model Instance:





or by referencing it's id




or by making a query.

Post::where('title', 'Horse')->approve();

Post::where('title', 'Horse')->reject();

Post::where('title', 'Horse')->postpone();

Query Models

By default only Approved models will be returned on queries.

To query the Approved Posts, run your queries as always.
//it will return all Approved Posts (strict mode)

// when not in strict mode

//it will return Approved Posts where title is Horse
Post::where('title', 'Horse')->get();

Query pending or rejected models.
//it will return all Pending Posts

//it will return all Rejected Posts

//it will return all Postponed Posts

//it will return Approved and Pending Posts

//it will return Approved and Rejected Posts

//it will return Approved and Postponed Posts

Query ALL models
//it will return all Posts

//it will return all Posts where title is Horse
Post::withAnyStatus()->where('title', 'Horse')->get();

Model Status

To check the status of a model there are 3 helper methods which return a boolean value.

//check if a model is pending

//check if a model is approved

//check if a model is rejected

//check if a model is rejected

Strict Moderation

Strict Moderation means that only Approved resource will be queried. To query Pending resources along with Approved you have to disable Strict Moderation. See how you can do this in the configuration.


Global Configuration

To configuration Moderation package globally you have to edit config/moderator.php. Inside moderator.php you can configure the following:

  1. status_column represents the default column 'status' in the database.
  2. moderated_at_column represents the default column 'moderated_at' in the database.
  3. moderated_by_column represents the default column 'moderated_by' in the database.
  4. strict represents Strict Moderation.

Model Configuration

Inside your Model you can define some variables to overwrite Global Settings.

// To overwrite `status` column define:
const MODERATION_STATUS = 'moderation_status';

// To overwrite `moderated_at` column define:
const MODERATED_AT = 'mod_at';

// To overwrite `moderated_by` column define:
const MODERATED_BY = 'mod_by';

// To enable or disable Strict Moderation:
public static $strictModeration = true;


All the original tests are retained and updated.

composer test


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


Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.



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