ufutx/laravel-comment

Just another comment system for laravel projects.

Laravel Comment (forked from actuallymab/laravel-comment)

![Software License][ico-license] ![Total Downloads][ico-downloads], _(*1)

**Just another comment system for laravel projects., _(*2)

Version Compatibility

Install

Via Composer, _(*3)

``` bash $ composer require ufutx/laravel-comment, <sub>(*4)</sub>

Add service provider to your app.php file

``` php
\Ufutx\LaravelComment\LaravelCommentServiceProvider::class

Publish & Migrate comments table. ``` bash $ php artisan vendor:publish $ php artisan migrate, <sub>(*5)</sub>

Add `CanComment` trait to your User model.
``` php
use Ufutx\LaravelComment\CanComment;

Add Commentable trait to your commentable model(s). ``` php use Ufutx\LaravelComment\Commentable;, <sub>(*6)</sub>

If you want to have your own Comment Model create a new one and extend my Comment model.
``` php
class Comment extends Ufutx\LaravelComment\Comment
{
  ...
}

Comment package comes with several modes., <sub>(*7)</sub>

1- If you want to Users can rate your model(s) with comment set canBeRated to true in your Commentable model. ``` php class Product extends Model { use Commentable;, <sub>(*8)</sub>

protected $canBeRated = true;, <sub>(*9)</sub>

... }, <sub>(*10)</sub>

2- If you want to approve comments for your commentable models, you must set `mustBeApproved` to true in your `Commentable` model.
``` php
class Product extends Model {
  use Commentable;

  protected $mustBeApproved = true;

  ...
}

3- You don't want to approve comments for all users (think this as you really want to approve your own comments?). So add your User model an isAdmin method and return it true if user is admin., <sub>(*11)</sub>

``` php class User extends Model { use CanComment;, <sub>(*12)</sub>

protected $fillable = [ 'isAdmin', .... ];, <sub>(*13)</sub>

public function isAdmin() { return $this->isAdmin; }, <sub>(*14)</sub>

... }, <sub>(*15)</sub>

## Usage

``` php
$user = App\User::find(1);
$product = App\Product::find(1);

// $user->comment(Commentable $model, $comment = '', $rate = 0, $pic = null);
$user->comment($product, 'Lorem ipsum ..', 3, 'http://images.ufutx.com/201702/09/49fe31fdf2d4f74709f2cb00e1a9c49a.jpeg@1e_1c_2o_1l_200h_200w_90q.src');

// approve it -- if you are admin or you don't use mustBeApproved option, it is not necessary
$product->comments[0]->approve();

//comment user model record 
$product->comments[0]->user

// get avg rating -- it calculates approved average rate.
$product->averageRate();

// get total comment count -- it calculates approved comments count.
$product->totalCommentCount();

Change log

Please see CHANGELOG for more information what has changed recently., <sub>(*16)</sub>

Testing

bash $ composer test, <sub>(*17)</sub>

Contributing

Please see CONTRIBUTING and CONDUCT for details., <sub>(*18)</sub>

Security

If you discover any security related issues, please email mehmet.aydin.bahadir@gmail.com or zglore instead of using the issue tracker., <sub>(*19)</sub>

Credits

• Mehmet Aydın Bahadır
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*20)</sub>