README

为 Laravel Eloquent 模型添加关联评论的功能。评论可以被批准，并且可以嵌套。

$post = Post::find(1);

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

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

安装

您可以通过 composer 安装此包

composer require joelwmale/laravel-comments

该包将自动注册自身。

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

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

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

php artisan migrate

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

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

使用方法

注册模型

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

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Joelwmale\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 的布尔标志，您可以在视图/控制器中使用它来过滤掉您可能不想显示的评论。

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

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

$comment->approve();

自动批准评论

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

namespace App\Models;

use Joelwmale\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 了解详细信息。

安全

如果您发现任何安全相关的问题，请通过电子邮件 marcel@beyondco.de 联系，而不是使用问题跟踪器。

鸣谢

许可协议

MIT 许可协议 (MIT)。有关更多信息，请参阅许可文件。

joelwmale / laravel-comments

维护者

详细信息