README

为您的Laravel Eloquent模型添加关联评论的能力。评论可以批准并嵌套。阅读quickcamx网站上的文章 https://quickcamx.co.tz/index.php/2020/12/31/laravel-comments-package/

$post = Post::find(1);

$post->comment('This is a comment');

$post->commentAsUser($user, 'This is a comment from someone else');

安装

您可以通过composer安装此包

composer require quickcamx/laravel-comments

包将自动注册自己。

您可以使用以下命令发布迁移

php artisan vendor:publish --provider="quickcamx\Comments\CommentsServiceProvider" --tag="migrations"

迁移发布后，您可以通过运行迁移来创建media-table

php artisan migrate

您可以使用以下命令发布配置文件

php artisan vendor:publish --provider="quickcamx\Comments\CommentsServiceProvider" --tag="config"

使用方法

注册模型

为了让您的模型能够接收评论，请将HasComments特性添加到模型类中。

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use quickcamx\Comments\Traits\HasComments;

class Post extends Model
{
    use HasComments;
    ...
}

创建评论

要为您的可评论模型创建评论，您可以使用comment方法。它接收您想要存储的评论字符串。

$post = Post::find(1);

$comment = $post->comment('This is a comment from a user.');

评论方法返回新创建的评论类。

有时您可能还想代表其他用户创建评论。您可以使用commentAsUser方法并传入与该评论相关联的用户模型来完成此操作

$post = Post::find(1);

$comment = $post->commentAsUser($yourUser, 'This is a comment from someone else.');

批准评论

默认情况下，您创建的所有评论都没有被批准 - 这只是一个名为is_approved的布尔标志，您可以在视图/控制器中使用它来过滤掉您可能还不想显示的评论。

要批准单个评论，您可以在评论模型上使用approve方法，如下所示

$post = Post::find(1);
$comment = $post->comments->first();

$comment->approve();

自动批准评论

如果您想自动批准特定用户（和/或模型）的评论，可以让您的User模型实现以下接口和方法

namespace App\Models;

use quickcamx\Comments\Contracts\Commentator;
use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable implements Commentator
{
    /**
     * Check if a comment for a specific model needs to be approved.
     * @param mixed $model
     * @return bool
     */
    public function needsCommentApproval($model): bool
    {
        return false;    
    }
    
}

needsCommentApproval方法接收您想要添加评论的模型实例，您可以选择返回true将评论标记为未批准，或者返回false将评论标记为已批准。

检索评论

使用HasComments特性的模型可以通过comments关系访问其评论

$post = Post::find(1);

// Retrieve all comments
$comments = $post->comments;

// Retrieve only approved comments
$approved = $post->comments()->approved()->get();

测试

composer test

变更日志

有关最近更改的更多信息，请参阅CHANGELOG

贡献

有关详细信息，请参阅CONTRIBUTING

安全

如果您发现任何安全相关的问题，请通过电子邮件quickcamxcompany@gmail.com报告，而不是使用问题跟踪器。

鸣谢

许可

MIT许可（MIT）。有关更多信息，请参阅许可文件

quickcamx / laravel-comments

维护者

详细信息