README

此包在页面插入位置添加评论块，评论与页面（链接）相关联，而不是与模型相关联。

示例：如果您将标签放在 http://toto.com/controller/action 上，评论将链接到该 URL 路径。

标签使用 bootstrap CSS 进行样式化。

安装

您可以通过 composer 安装此包

composer require m4riachi/laravel-comment

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

php artisan vendor:publish --provider="M4riachi\LaravelComment\LaravelCommentServiceProvider" --tag=migrations
php artisan migrate

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

php artisan vendor:publish --provider="M4riachi\LaravelComment\LaravelCommentServiceProvider" --tag=config

可选

如果您需要更改 HTML 设计，请使用以下视图文件

php artisan vendor:publish --provider="M4riachi\LaravelComment\LaravelCommentServiceProvider" --tag=views

用法

对于 前端，有两个标签可以包含在您希望添加评论块的页面的 HTML 中。

<x-m4-comment-front-bloc  />

此标签将显示评论表单和此页面上插入的评论列表。

<x-m4-comment-front-javascript  />

此标签将添加所需的 JavaScript。

对于 后端，只有一个标签。

<x-m4-comment-back-list />

此标签需要在后台办公室中使用，将显示带有分页和两个操作的插入的评论。

• 一个更改评论状态的操作
• 和删除操作

#### 配置文件

您可以从配置文件配置许多选项。

• 您可以设置是否允许访客用户发表评论，如果为真，将向表单添加两个输入（姓名、电子邮件）

'guest-user' => true, //enable guest user to post a comment

• 您可以选择发布类型：普通或 AJAX 发布。该插件使用 axios 执行 AJAX

'ajax' => [ 
    'enable' => true, //enable ajax post
    'include_axios' => true, // if false you must have axios on your js files
],

• 默认情况下，每条新帖子的状态都是待定，您必须从后台办公室更改状态

'default_status' => 'pending', // there is two options [pending or approved]

• 如描述中所述，评论标签链接到 URL 路径 /toto/fofo，如果您还想链接 URL 查询，则必须启用它。/toto/fofo?param=1 与 /toto/fofo?param=2 将不同

'with_url_query' => false,

• 设置用户模型，如果它与 \App\Models\User 不同

'with_url_query' => false,

• 输入验证器

'input-validator' => [
    'user_name' => ['required', 'string', 'max:192'],
    'user_email' => ['required', 'string', 'email', 'max:192'],
    'comment' => ['required', 'string'],
],

• 如果您想在表单上使用 recaptcha v3

'recaptcha' => [
    'enable' => false,
    'site-key' => '',
    'secret-key' => '',
    'checked_score' => 0.4
],

测试

composer test

更新日志

请参阅 更新日志 获取有关最近更改的更多信息。

贡献

请参阅 贡献 获取详细信息。

安全

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

鸣谢

• Taoufiq BEN
• 所有贡献者

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 获取更多信息。