codebyray / laravel-review-rateable by codebyray

Review & Rating system for Laravel 7, 8 & 9
Package Data
Maintainer Username: codebyray
Maintainer Contact: (CodebyRay)
Package Create Date: 2018-10-24
Package Last Update: 2024-03-02
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-05-19 15:14:29
Package Statistics
Total Downloads: 330,209
Monthly Downloads: 516
Daily Downloads: 2
Total Stars: 278
Total Watchers: 3
Total Forks: 52
Total Open Issues: 6

Laravel Review Rateable

Review Rateable system for laravel 5, 6, 7 & 8. You can rate your models by:

  • Overall Rating
  • Customer Service Rating
  • Quality Rating
  • Friendly Rating
  • Price Rating

You can also set whether the model being rated is recommended.


First, pull in the package through Composer.

composer require codebyray/laravel-review-rateable

And then include the service provider within app/config/app.php. Note: If you are running Laravel 5.5+ this will be auto loaded for you.

'providers' => [

At last you need to publish and run the migration.

php artisan vendor:publish --provider="Codebyray\ReviewRateable\ReviewRateableServiceProvider" --tag="migrations"

Run the migration

php artisan migrate

Setup a Model


namespace App;

use Codebyray\ReviewRateable\Contracts\ReviewRateable;
use Codebyray\ReviewRateable\Traits\ReviewRateable as ReviewRateableTrait;
use Illuminate\Database\Eloquent\Model;

class Post extends Model implements ReviewRateable
    use ReviewRateableTrait;

Create a rating

When creating a rating you can specify whether the rating is approved or not by adding approved to the array. This is optional and if left out the default is not approved to allow for review before posting.

$user = User::first();
$post = Post::first();

$rating = $post->rating([
    'title' => 'This is a test title',
    'body' => 'And we will add some shit here',
    'customer_service_rating' => 5,
    'quality_rating' => 5,
    'friendly_rating' => 5,
    'pricing_rating' => 5,
    'rating' => 5,
    'recommend' => 'Yes',
    'approved' => true, // This is optional and defaults to false
], $user);


Update a rating

$rating = $post->updateRating(1, [
    'title' => 'new title',
    'body' => 'new body',
    'customer_service_rating' => 1,
    'quality_rating' => 1,
    'friendly_rating' => 3,
    'pricing_rating' => 4,
    'rating' => 4,
    'recommend' => 'No',
    'approved' => true, // This is optional and defaults to false

Marking review as approved

$rating = $post->updateRating(1, ['approved' => true]);

Delete a rating:


Fetch approved or not approved reviews/ratings for a particular resource

// Get approved ratings
$ratings = $post->getApprovedRatings($post->id, 'desc');

// Get not approved ratings
$ratings = $post->getNotApprovedRatings($post->id, 'desc');

// Get all ratings whether approved or not
$ratings = $post->getAllRatings($post->id, 'desc');

// Get the most recent ratings (limit and sort are optional)
// Limit default is 5, sort default is desc
$ratings = $post->getRecentRatings($post->id, 5, 'desc');

// Get the most recent user ratings (limit and sort are optional)
// Limit default is 5, approved default is true, sort default is desc
$userRatings = $post->getRecentUserRatings($user->id, 5, true, 'desc');

Fetch the average rating:

// Get Overall Average Rating

// Get Customer Service Average Rating

// Get Quality Average Rating

// Get Friendly Average Rating

// Get Price Average Rating


$post->averageRating(2) //round to 2 decimal place
$post->averageRating(null, true) //get only approved average rating 

Get all ratings:

$post = Post::first();

$ratings = $post->getAllRatings($post->id);

Count total rating:


Fetch the rating percentage.

This is also how you enforce a maximum rating value.


$post->ratingPercent(10)); // Ten star rating system
// Note: The value passed in is treated as the maximum allowed value.
// This defaults to 5 so it can be called without passing a value as well.


This is a fork from Trexology's - Original Code - laravel-reviewRateable .

Please note that this code is not used in the original and is not maintained.