README

本包使用一个特质，允许模型被用户评论并给予星级/评分，并且只有管理员可以回复作为支持响应，类似于Google Play商店的评论系统。本包可以与任何项目（如电子商务、商店、店铺等模型）一起使用。

作者：Jalal Uddin Github | Linked-in | Facebook

要求

• PHP >= 7.1
• Laravel >= 5.6

安装

使用 COMPOSER

composer require dgvai/laravel-user-review

配置

导出资源（迁移和配置）

php artisan vendor:publish --provider="DGvai\Review\ReviewerServiceProvider"

运行迁移

php artisan migrate

清除配置缓存

php artisan config:cache

用法

将 Reviewable 特质添加到用户想要评论和评分的模型中。例如，对于 产品模型

<?php 
namespace App;

use DGvai\Review\Reviewable;
use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    use Reviewable;
    ...
    ...
}

?>

创建产品评论

描述

makeReview(object $user, int $rating [, string $review])

返回

评论实例对象

示例

    $product = Product::find($id);
    $user = auth()->user();

    //user makes new Review 
    $product->makeReview($user,3,'Very good product!');
    
    //user updates their Review on this product or makes a new review if doesn't have any.
    $product->makeOrUpdateReview($user,3,'Very good product!');

评论属性

    // Get all active reviews of the product
    $product->reviews();

    // Get neumetic review count (average)
    $product->rating;

    // Get percentage review count (average)
    $product->rating_percent;

    /**
    *   NOTE: THIS PERCENTAGE IS BASED ON 5 STAR RATING, IF YOU WANT CUSTOM STAR, USE BELLOW
    *   This is configured via the config file comes with this package: user-review.php
    *   You can also set environment variable for your systems default star count
    *
    *   (.env)  SYSTEM_RATING_STAR_COUNT=5 
    */

    $product->averageRating(10);    //percentage for 10 starrted model

    // Get rating given to the product by a user:
    $product->userRating($user);

    /**
     *  Get Filtered Review
     *  Like, get only reviews that has been given 4 stars!
     * 
    */

    $product->filter(4);

    /**
     * Get it's percentage, which can be shown in the progress bar!
     * */ 
    $product->filteredPercentage(4);      // ex: output: 75 


    /**
     *  PULLING OUT REVIEWS
     *  There are several ways you can
     *  pull out reviews of products
    */

    // Get all reviews of all products
    $reviews = DGvai\Review\Review::all();              // all reviews
    $reviews = DGvai\Review\Review::active()->get();    // all active reviews
    $reviews = DGvai\Review\Review::inactive()->get();  // all inactive reviews
    $reviews = DGvai\Review\Review::daily()->get();     // all daily reviews
    $reviews = DGvai\Review\Review::monthly()->get();   // all monthly reviews
    $reviews = DGvai\Review\Review::yearly()->get();    // all yearly reviews

    // You can also chain these methods
    $reviews = DGvai\Review\Review::monthly()->active()->get();  // get aa monthly active reviews

    // Get reviews of a product
    $product->reviews();


    /**
     *  $reviews has some attributes
     *  Let's assume we are taking the first review
    */
    $review = $reviews->first();

    /**
     *  This the model object of the traited model
     *  In our case it is product
     * 
    */

    $review->model;     //  so $review->model->name with return the $product->name
    $review->user;      //  return User model that reviewed the model

    // Get review text
    $review->review_text;

    // Get review reply
    $review->reply;

    // reply a review by admin:
    $review->reply('Thanks for being with us!');

    // making active/inactive
    $review->makeActive();
    $review->makeInactive();

目前为止就是这样！将来会有新的功能更新。