canylmz / laravel-rating
Associate ratings to any Eloquent model
Requires
- php: ^7.2
- illuminate/support: 6.*
- laravel/helpers: ^1.1
Requires (Dev)
- mockery/mockery: ^1.1
- orchestra/testbench: ^4.0
- phpunit/phpunit: 8.3.*
- sempro/phpunit-pretty-print: 1.1.*
This package is auto-updated.
Last update: 2024-10-20 09:38:31 UTC
README
Associate ratings to any Eloquent model.
This package is based on rennokki/rating with some improvements:
- BugFixes
- Exceptions
- Sum of ratings
- More testing
Installation
Install this package with Composer:
$ composer require canylmz/laravel-rating
The package will automatically register itself.
If your Laravel installation does not support package discovery, add this line in the providers array in your config/app.php file:
Canylmz\Rating\RatingServiceProvider::class,
Optional: if you want to change the table name to something else than "ratings", you can publish the config file with:
php artisan vendor:publish --provider="Canylmz\Rating\RatingServiceProvider" --tag="config"
Publish the migration with:
php artisan vendor:publish --provider="Canylmz\Rating\RatingServiceProvider" --tag="migrations"
After the migration has been published you can create the ratings table by running the migration:
php artisan migrate
Usage
Prepare models
To allow a model to rate other models, it should use the CanRate
trait and implement the Rater
contract.
use Canylmz\Rating\CanRate; use Canylmz\Rating\Contracts\Rater; class User extends Model implements Rater { use CanRate; // ... }
Each model that can be rated, should use the CanBeRated
trait and implement the Rateable
contract.
use Canylmz\Rating\CanBeRated; use Canylmz\Rating\Contracts\Rateable; class Post extends Model implements Rateable { use CanBeRated; // ... }
If your model can both rate and be rated, you should use Rate
trait and Rating
contract.
use Canylmz\Rating\Rate; use Canylmz\Rating\Contracts\Rating; class Member extends Model implements Rating { use Rate; // ... }
Rate models
To rate other models, simply call rate()
method.
As a second argument to the rate()
method, you can pass the rating score. It can either be string, integer or float.
$user->rate($post, 10); $post->averageRating(User::class); // 10.0, as float
If you want to make sure a model gets rated only once, add false
as the third argument to the rate()
method.
$user->rate($post, 10, false);
Check if a model has been rated with the hasRated()
method.
$user->rate($post, 10); $user->hasRated($post); // true
Get the average rating of a model with the averageRating()
method.
Pass the class name of the raters as the argument.
The return value is the average arithmetic value of all ratings as float
.
$user->rate($post, 10); $post->averageRating(User::class); // 10.0, as float
Get the ratings count with the countRatings()
method.
$user->rate($post, 10); $user->rate($post, 10); $post->countRatings(User::class); // 2, as integer
Testing
You can run the tests with:
$ composer test
Changelog
Please see the CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Alternatives
Credits
License
MIT. Please see the license file for more information.