lakm/laravel-comments

将无缝评论功能集成到您的 Laravel 项目中。

3.0.0-beta 2024-06-29 06:14 UTC

README

文档 | 管理面板 | 概览 | 文章 | 关键特性 | 为什么选择 Commenter | 快速开始 | 主题 | 演示 | 更新日志 | 测试 | 路线图 | 安全 | 许可 | 赞助

评论系统所需的一切

为您的应用程序带来强大评论功能的 Laravel 包 😍

Laravel GitHub Actions Workflow Status Packagist Version Downloads GitHub License

概览

Commenter 是一个功能丰富、现代化的包,配备管理面板,旨在满足您的所有评论需求。使用此包,您无需为 Laravel 项目的评论功能添加任何额外工具。

请参阅文档以获取详细的安装和用法说明。

<x-comments :model="$post" />

文章

screenshot

关键特性

  • ❤️ 简单、现代化且用户友好的界面。
  • 📱 移动响应式。
  • ⛯ 支持深色模式。
  • 📝 WYSIWYG 编辑器。
  • 📔 语法高亮。
  • 🔒 丰富的安全功能。
  • 🔑 高效的垃圾邮件预防。
  • 🤩 反应选项。
  • 📞 支持嵌套回复。
  • 👤 用户提及功能。
  • 👥 显示已反应的用户列表(仅限认证模式)。
  • 🔢 分页。
  • 👮‍♂️ 支持认证模式和访客模式(互斥)。
  • 🔍 高级过滤和排序选项。
  • 🥰 使用 Livewire 和 Alpine.js 的组合实现响应式设计。
  • 🚀 优化性能。还有更多。

为什么选择 Commenter

评论功能是大多数网站的基本需求。允许用户评论可以促进互动并提升用户体验。虽然 Laravel 提供了大量包以满足各种项目需求,但在评论功能方面选择有限。

以下是现有评论包的一些缺点

  • 过时:使用过时的技术且未积极维护。
  • 功能不足:缺少许多基本功能。
  • 无管理面板:需要额外时间独立实现管理面板。
  • 设计糟糕:界面不友好。
  • 无移动响应:未针对移动设备优化。
  • 性能问题:可能导致性能下降。
  • 可配置性差:定制和配置选项有限。

由于这些问题,大多数公司倾向于选择商业包或插件。然而,在商业包上额外花钱会减少公司的整体利润。本包旨在解决所有这些不足。

作为一名全栈开发者,我亲自遇到过这些问题。这就是我开发这个包的原因——不仅是为了我的项目,也是为了帮助其他开发者。

快速开始

安装

composer require lakm/laravel-comments -W
php artisan commenter:install

使用

在可评论模型中实现CommentableContract并导入Commentable特性。

use LakM\Comments\Concerns\Commentable;
use LakM\Comments\Contracts\CommentableContract;

class Post extends Model implements CommentableContract
{
    use Commentable;
}

在评论者模型中实现CommenterContract并导入Commenter特性。

use LakM\Comments\Concerns\Commenter;
use LakM\Comments\Contracts\CommenterContract;

class User extends Model implements CommenterContract
{
    use Commenter;
}

在布局中包含样式。

<html>
    <head>
        @commentsStyles
    </head>
</html>

在布局中包含脚本。

<html>
    <body>
        @commentsScripts
    </body>
</html>

包含与相关模型关联的评论组件。

    <x-comments::index :model="$post" />

警告

您可以省略索引部分,但请确保包含双冒号。否则,Laravel将在项目中而不是包中搜索组件。

    <x-comments:: :model="$post" />

主题

您可以将主题更改为您喜欢的主题。有关更多信息,请参阅此处的文档。

演示

项目

https://github.com/Lakshan-Madushanka/laravel-comments-demo

迷你视频

https://youtu.be/6CxgmvESsdc

完整视频

https://youtu.be/dvFIOhSpmv8

注意

这个迷你演示视频提供了Commenter的基本概述。Commenter的全功能和范围要广泛得多。将在稳定版发布时发布一个全面的视频。

变更日志

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

测试

./vendor/bin/pest

路线图

安全

请参阅此处以了解我们的安全策略。

许可

MIT许可证(MIT)。有关更多信息,请参阅许可文件

赞助此项目

您可能会认为我们有偏见,但这是目前最好的评论系统之一,无论是付费还是免费(我们怀疑没有付费解决方案像这个一样定制)。我们致力于不断改进这个包,满足您的需求。不是吗?拥有一个经过充分测试、功能丰富的评论系统,免费供您的Laravel项目使用,不是一件令人放心的事吗?

我们非常感谢您提供的任何赞助。您的贡献是对您未来的直接投资,每一分钱都支持这个项目的增长和其他开源项目。

如果您觉得这个项目有价值,请考虑通过访问赞助页面来支持它:https://github.com/sponsors/Lakshan-Madushanka。您的支持意义重大💗!