Download the PHP package compubel/laravel-rating without Composer
On this page you can find all versions of the php package compubel/laravel-rating. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download compubel/laravel-rating
More information about compubel/laravel-rating
Files in compubel/laravel-rating
Package laravel-rating
Short Description Associate ratings to any Eloquent model
License MIT
Homepage https://github.com/compubel/laravel-rating
Informations about the package laravel-rating
Laravel Rating
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:
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:
Optional: if you want to change the table name to something else than "ratings", you can publish the config file with:
Publish the migration with:
After the migration has been published you can create the ratings table by running the migration:
Usage
Prepare models
To allow a model to rate other models, it should use the CanRate
trait and implement the Rater
contract.
Each model that can be rated, should use the CanBeRated
trait and implement the Rateable
contract.
If your model can both rate and be rated, you should use Rate
trait and Rating
contract.
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.
If you want to make sure a model gets rated only once, add false
as the third argument to the rate()
method.
Check if a model has been rated with the hasRated()
method.
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
.
Get the ratings count with the countRatings()
method.
Testing
You can run the tests with:
Changelog
Please see the CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Alternatives
Credits
- Jasper Briers
- All Contributors
License
MIT. Please see the license file for more information.