README

** 注意：由于我没有时间再对其进行改进，此包现已停用。然而，一位好心的朋友已经基于我的工作进行了分支和改进，并现在正在维护它。我建议您查看此存储库以获取新的更新版本。此存储库仅保留在此处供文档用途。请将您的拉取请求和问题提交给Riari的存储库。**

目标

此包旨在为在Laravel应用程序中实现论坛提供良好的起点。它专注于处理创建论坛的所有繁琐和重复性工作（类别、子类别、主题、消息）。让您有更多时间专注于网站功能和论坛与您应用程序的集成。此包将提供多个钩子，如特殊事件和自定义闭包，以允许您自定义其行为。另外，您还可以扩展论坛的核心类，直接在核心中实现您自己的方法。

此包远未完成，欢迎提交拉取请求，让我们一起让这个包变得更好。

安装

导入包

要安装，只需将以下行添加到您的composer .json，并运行composer update

"atrakeur/forum": "dev-master"

然后添加以下服务提供程序到您的app.php

'Atrakeur\Forum\ForumServiceProvider',

集成到您的应用程序中

在所有操作之前，在某些情况下（L4），您可能需要在执行以下步骤之前运行composer的更新，因此

composer update

并且，为了安全起见，运行

composer dump-autoload

现在将论坛的文件直接发布到您的Laravel应用程序中： php artisan config:publish atrakeur/forum php artisan migrate:publish atrakeur/forum

如果一切顺利，您应该在app/config/packages/atrakeur/forum中找到配置文件，并在app/database/migrations中找到三个新的迁移。

现在您可以使用默认的Laravel命令php artisan migrate创建数据库模式。

为了使您能够完全自定义包以适应您的网站，该包已通过两个应用程序级别的控制器集成到您的应用程序中。运行命令php artisan forum:install以在您的app/controllers文件夹中自动部署控制器。（请注意，如果已存在同名文件，上述命令将失败，无法覆盖您的文件。）

自定义

要调整视图，请使用Laravel命令将其发布到您的视图文件夹中

php artisan view:publish atrakeur/forum

最后一步需要创建一些类别和子类别到论坛_categories表中。模式非常基本，您应该能够使用Laravel seeds自己完成（待定：提供一些示例）

现在您已经准备好了，只需加载https:///forum，您应该会看到一个全新的论坛。

有关如何将其与您的登录系统集成更多信息的说明，请参阅配置文件注释。（待定：提供一些示例）默认情况下，它应该可以在Laravel默认认证上运行得很好。

功能

此包目前处于（非常）alpha阶段，因此以下所有功能可能或可能尚未工作。但是，请随意在https://github.com/atrakeur/laravel-forum/issues上发布问题和功能请求。我将根据您的帮助尽快修复和改进包！

• 2级类别嵌套
• 类别内的主题和消息
• 简单用户集成（通过配置文件和回调函数）
• 简单用户权限集成（通过配置文件和回调函数）
• 消息发布（带有用于应用程序集成的钩子）
• 轻量级且快速（设计时考虑了缓存和高速）
• 基于Bootstrap设计（干净简洁的标记，无杂乱的CSS，可直接集成到您的网站中）

事件

此软件包提供各种事件作为钩子，以使您能够在上位论坛功能的基础上实现您自己的功能。以下为所有事件的完整列表，以及它们被触发的时间。当给出参数时，您可以使用此参数来更改论坛内部对象，以满足您的需求。