kesty / reviewer
Rating syetem for Laravel ^7
v1.3
2021-01-17 11:54 UTC
Requires
- php: >=5.5.9
- illuminate/support: ^7.0
This package is auto-updated.
Last update: 2024-12-17 20:32:10 UTC
README
Laravel Reviewer
Reviewer system for laravel 5.*
Installation
First, pull in the package through Composer.
composer require kesty/reviewer
And then include the service provider within app/config/app.php
. (Skip this step if you are on Laravel 5.5 or above)
'providers' => [ Kesty\Reviewer\ReviewerServiceProvider::class ];
At last you need to publish and run the migration.
php artisan vendor:publish --provider="Kesty\Reviewer\ReviewerServiceProvider" && php artisan migrate
Setup a Model
<?php namespace App; use Kesty\Reviewer\Contracts\ReviewRateable; use Kesty\Reviewer\Traits\ReviewRateable as ReviewerTrait; use Illuminate\Database\Eloquent\Model; class Post extends Model implements ReviewRateable { use ReviewerTrait; }
Create a rating
$user = User::first(); $post = Post::first(); $rating = $post->rating([ 'title' => 'Some title', 'body' => 'Some body', //optional 'anonymous' => 1, //optional 'rating' => 5, ], $user); dd($rating);
Update a rating
$rating = $post->updateRating(1, [ 'title' => 'new title', 'body' => 'new body', //optional 'anonymous' => 1, //optional 'rating' => 3, ]);
Delete a rating:
$post->deleteRating(1);
Fetch the average rating:
$post->averageRating()
or
$post->averageRating(2) //round to 2 decimal place
Count total rating:
$post->countRating()
Count rating meta (Count and Avg):
$post->ratingMeta()
or
$post->ratingMeta(2) //round to 2 decimal place
Fetch the rating percentage.
This is also how you enforce a maximum rating value.
$post->ratingPercent() $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.