Laravel Moderation 
A simple Moderation System for Laravel 5.* that allows you to Approve or Reject resources like posts, comments, users, etc.
Keep your application pure by preventing offensive, irrelevant, or insulting content.
Possible Use Case
-
User creates a resource (a post, a comment or any Eloquent Model).
-
The resource is pending and invisible in website (ex.
Post::all()returns only approved posts). -
Moderator decides if the resource will be approved, rejected or postponed.
-
Approved: Resource is now public and queryable.
-
Rejected: Resource will be excluded from all queries. Rejected resources will be returned only if you scope a query to include them. (scope:
withRejected) -
Postponed: Resource will be excluded from all queries until Moderator decides to approve it.
-
You application is clean.
Installation
First, install the package through Composer.
composer require hootlex/laravel-moderation
If you are using Laravel < 5.5, you need to add Hootlex\Moderation\ModerationServiceProvider to your config/app.php providers array:
'providers' => [
...
Hootlex\Moderation\ModerationServiceProvider::class,
...
];
Lastly you publish the config file.
php artisan vendor:publish --provider="Hootlex\Moderation\ModerationServiceProvider" --tag=config
Prepare Model
To enable moderation for a model, use the Hootlex\Moderation\Moderatable trait on the model and add the status, moderated_by and moderated_at columns to your model's table.
use Hootlex\Moderation\Moderatable;
class Post extends Model
{
use Moderatable;
...
}
Create a migration to add the new columns. (You can use custom names for the moderation columns)
Example Migration:
class AddModerationColumnsToPostsTable extends Migration
{
/**
* Run the migrations.
*
* @return void
*/
public function up()
{
Schema::table('posts', function (Blueprint $table) {
$table->smallInteger('status')->default(0);
$table->dateTime('moderated_at')->nullable();
//To track who moderated the Model, add 'moderated_by' and set the column name in the config file.
//$table->integer('moderated_by')->nullable()->unsigned();
});
}
/**
* Reverse the migrations.
*
* @return void
*/
public function down()
{
Schema::table('posts', function(Blueprint $table)
{
$table->dropColumn('status');
$table->dropColumn('moderated_at');
//$table->dropColumn('moderated_by');
});
}
}
You are ready to go!
Usage
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:
$post->markApproved();
$post->markRejected();
$post->markPostponed();
$post->markPending();
or by referencing it's id
Post::approve($post->id);
Post::reject($post->id);
Post::postpone($post->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 change this behavior check the configuration.
To query the Approved Posts, run your queries as always.
//it will return all Approved Posts (strict mode)
Post::all();
// when not in strict mode
Post::approved()->get();
//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
Post::pending()->get();
//it will return all Rejected Posts
Post::rejected()->get();
//it will return all Postponed Posts
Post::postponed()->get();
//it will return Approved and Pending Posts
Post::withPending()->get();
//it will return Approved and Rejected Posts
Post::withRejected()->get();
//it will return Approved and Postponed Posts
Post::withPostponed()->get();
Query ALL models
//it will return all Posts
Post::withAnyStatus()->get();
//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
$post->isPending();
//check if a model is approved
$post->isApproved();
//check if a model is rejected
$post->isRejected();
//check if a model is rejected
$post->isPostponed();
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.
Configuration
Global Configuration
To configuration Moderation package globally you have to edit config/moderation.php. Inside moderation.php you can configure the following:
status_columnrepresents the default column 'status' in the database.moderated_at_columnrepresents the default column 'moderated_at' in the database.moderated_by_columnrepresents the default column 'moderated_by' in the database.strictrepresents 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;
![[enhancement] make moderation to be a morph relationship](https://avatars.githubusercontent.com/u/12032477?v=4)
4 May 12, 2022
7 Nov 15, 2022
3 Jan 2, 2023
996 Dec 28, 2022
2 Jul 14, 2022
720 Jan 3, 2023
435 Nov 20, 2022
2 Nov 14, 2022
120 Dec 4, 2022
1.6k Dec 30, 2022
393 Nov 28, 2022
626 Dec 30, 2022
4 Apr 28, 2022
21 Dec 9, 2022
6 Dec 30, 2022
3.1k Nov 25, 2022
591 Dec 17, 2022
268 Dec 27, 2022
1 Dec 1, 2021