devfelipereis / laravel-rateable by felipereis
forked from willvincent/laravel-rateable

Allows multiple models to be rated with a fivestar like system.
22
0
3
Package Data
Maintainer Username: felipereis
Maintainer Contact: tcindie@gmail.com (Will Vincent)
Package Create Date: 2016-07-14
Package Last Update: 2016-07-14
Language: PHP
License: MIT
Last Refreshed: 2024-05-15 03:04:46
Package Statistics
Total Downloads: 22
Monthly Downloads: 0
Daily Downloads: 0
Total Stars: 0
Total Watchers: 3
Total Forks: 0
Total Open Issues: 0

Laravel Rateable

Build Status Latest Stable Version License

Total Downloads Monthly Downloads Daily Downloads

FOR PERSONAL USE. DON'T USE THIS FORK. USE: https://github.com/willvincent/laravel-rateable

Provides a trait to allow rating of multiple models within your app for Laravel 5.

Ratings could be fivestar style, or simple +1/-1 style.

Installation

Edit your project's composer.json file to require willvincent/laravel-rateable.

"require": {
  "willvincent/laravel-rateable": "~1.0"
}

Next, update Composer from the terminal.

composer update

As with most Laravel packages you'll need to register Rateable service provider. In your config/app.php add 'willvincent\Rateable\RateableServiceProvider' to the end of the $providers array.

'providers' => [

    Illuminate\Foundation\Providers\ArtisanServiceProvider::class,
    Illuminate\Auth\AuthServiceProvider::class,
    ...
    willvincent\Rateable\RateableServiceProvider::class,

],

Getting started

After the package is correctly installed, you need to generate the migration.

php artisan rateable:migration

It will generate the <timestamp>_create_ratings_table.php migration. You may now run it with the artisan migrate command:

php artisan migrate

After the migration, one new table will be present, ratings.

Usage

You need to set on your model that it is rateable.

<?php namespace App;

use willvincent\Rateable\Rateable;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{

    use Rateable;

}

Now, your model has access to a few additional methods.

First, to add a rating to your model:

$post = Post::first();

$rating = new willvincent\Rateable\Rating;
$rating->rating = 5;
$rating->user_id = \Auth::id();

$post->ratings()->save($rating);

dd(Post::first()->ratings);

Once a model has some ratings, you can fetch the average rating:

$post = Post::first();

dd($post->averageRating);
// $post->averageRating() also works for this.

Also, you can fetch the rating percentage. This is also how you enforce a maximum rating value.

$post = Post::find();

dd($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.

// $post->ratingPercent(5) -- Five star rating system totally equivilent to:
// $post->ratingPercent()