Download the PHP package chikeozulumba/laravel-rateable without Composer
On this page you can find all versions of the php package chikeozulumba/laravel-rateable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download chikeozulumba/laravel-rateable
More information about chikeozulumba/laravel-rateable
Files in chikeozulumba/laravel-rateable
Package laravel-rateable
Short Description Allows multiple models to be rated with a fivestar like system.
License MIT
Homepage https://github.com/willvincent/laravel-rateable
Informations about the package laravel-rateable
Laravel Rateable
Provides a trait to allow rating of any Eloquent models within your app for Laravel 6/7.
Ratings could be fivestar style, or simple +1/-1 style.
Compatability
Laravel versions < 6.x should use the 1.x releases While 2.x release may at least temporarily work with most recent laravel 5.x versions, any new development will be explicitly focused on laravel 6.x+ compatibility and breaking changes may occur, therefore, installation of 2.x releases with laravel versions < 6.x is not recommended, and done at your own peril.
Installation
You can install the package via composer:
You can publish and run the migrations with:
As with most Laravel packages, if you're using Laravel 5.5 or later, the package will be auto-discovered (learn more if this is new to you).
If you're using a version of Laravel before 5.5, you'll need to register the Rateable service provider. In your config/app.php
add 'willvincent\Rateable\RateableServiceProvider'
to the end of the $providers
array.
``
Usage
In order to mark a model as "rateable", import the Rateable
trait.
``
Now, your model has access to a few additional methods.
First, to add a rating to your model:
``
Or perhaps you want to enforce that users can only rate each model one time, and if they submit a new value, it will update their existing rating.
In that case, you'll want to use rateOnce()
instead:
`
Once a model has some ratings, you can fetch the average rating: ``
Also, you can fetch the rating percentage. This is also how you enforce a maximum rating value.
``
You can also fetch the sum or average of ratings for the given rateable item the current (authorized) has voted/rated. ``
Want to know how many ratings a model has?
Testing
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Credits
License
The MIT License (MIT). Please see License File for more information.
All versions of laravel-rateable with dependencies
illuminate/support Version ^6.0|^7.0
illuminate/database Version ^6.0|^7.0