❤️ This package helps you to add user based rating system to your model.
You can install the package using composer
$ composer require yoeunes/rateable
Then add the service provider to config/app.php
. In Laravel versions 5.5 and beyond, this step can be skipped if package auto-discovery is enabled.
'providers' => [
...
Yoeunes\Rateable\RateableServiceProvider::class
...
];
Publish the migrations file:
$ php artisan vendor:publish --provider='Yoeunes\Rateable\RateableServiceProvider' --tag="migrations"
As optional if you want to modify the default configuration, you can publish the configuration file:
$ php artisan vendor:publish --provider='Yoeunes\Rateable\RateableServiceProvider' --tag="config"
And create tables:
$ php artisan migrate
Finally, add feature trait into User model:
<?php
namespace App;
use Yoeunes\Rateable\Traits\Rateable;
use Illuminate\Database\Eloquent\Model;
class Lesson extends Model
{
use Rateable;
}
All available APIs are listed below.
$user = User::first();
$lesson = Lesson::first();
$rating = $lesson->getRatingBuilder()
->user($user) // you may also use $user->id
->uniqueRatingForUsers(true) // update if already rated
->rate(3);
$lesson = Lesson::first();
$lesson->updateRating($rating_id, $value); // rating_id and the new rating value
$lesson->updateRatingForUser($user_id, $value); // update all rating for a single user related to the lesson
$lesson = Lesson::first();
$lesson->deleteRating($rating_id); // delete a rating with the giving id
$lesson->deleteRatingsForUser($user_id); // delete all rating for a single user related to the lesson
$lesson->resetRating(); // delete all rating related to the lesson
$lesson->isRated();
$lesson->isRatedBy($user_id);// check if its already rated by the given user
$lesson->averageRating(); // get the average rating
$lesson->averageRatingForUser($user_id); // get the average rating for a single user
$lesson->raters()->get();
$lesson->raters()->where('name', 'like', '%yoeunes%')->get();
$lesson->raters()->orderBy('name')->get();
$lesson->countRatingsByDate('2018-02-03 13:23:03', '2018-02-06 15:26:06');
$lesson->countRatingsByDate('2018-02-03 13:23:03');
$lesson->countRatingsByDate(null, '2018-02-06 15:26:06');
$lesson->countRatingsByDate(Carbon::now()->parse('01-04-2017'), Carbon::now()->parse('01-06-2017'));
$lesson->countRatingsByDate(Carbon::now()->subDays(2));
$lesson->countRating()
$lesson->countRatingForUser($user_id)
$lesson->totalRating()
$lesson->totalRatingForUser($user_id)
$lesson->ratingPercentage()
$lesson->positiveRatingCount()
$lesson->positiveRatingTotal()
$lesson->negativeRatingCount()
$lesson->negativeRatingTotal()
Lesson::select('lessons.*')->orderByAverageRating('asc')->get()
Lesson::select('lessons.*')->orderByAverageRating('desc')->get()
$ratings = $user->ratings
$ratings = $user->ratings()->where('id', '>', 10)->get()
Because we all love having to repeat less, this package allows you to define date transformers. Let's say we are using the following code a lot: $lesson->countRatingsByDate(Carbon::now()->subDays(3)). It can get a little bit annoying and unreadable. Let's solve that!
If you've published the configuration file, you will see something like this:
'date-transformers' => [
// 'past24hours' => Carbon::now()->subDays(1),
// 'past7days' => Carbon::now()->subWeeks(1),
// 'past14days' => Carbon::now()->subWeeks(2),
],
They are all commented out as default. To make them available, simply uncomment them. The provided ones are serving as an example. You can remove them or add your own ones.
'date-transformers' => [
'past3days' => Carbon::now()->subDays(3),
],
We can now retrieve the rating count like this:
$lesson->countRatingsByDate('past3days');
MIT