README

为您的Laravel应用程序提供一个简单的论坛

需求

Laravel 5.1.11+
PHP 5.6+
拥有用户模型和数据库的Laravel项目
可选Laravel 5.3，如果您想使用通知功能

安装

使用composer将LiddleForum添加到您的项目
```
composer require "liddledev/liddleforum"
```
将LiddleForum服务提供者添加到config/app.php的提供者中
```
LiddleDev\LiddleForum\LiddleForumServiceProvider::class,
```
运行以下命令以发布LiddleForum资源
```
php artisan vendor:publish
```
打开位于
```
app/config/liddleforum.php
```
的LiddleForum配置文件，并编辑User模型类以匹配您的User模型。默认为\App\User::class，这是Laravel自带的。
由于已将新文件复制到您的项目中，您需要运行
```
composer dump-autoload
```
LiddleForum需要在您的数据库中创建一些表才能正常运行。默认情况下，所有表都将使用前缀liddleforum_，但您可以在配置中更改它。设置好前缀后，运行
```
php artisan migrate
```

在配置中，您将看到blade数组。您需要填写页面应扩展的布局文件、要使用的内容部分以及必须在布局头部和body关闭前放置的两个堆栈的名称。例如，您的布局文件可能如下所示

<html>
<head>
    @stack('head')
</head>
<body>
    <nav></nav>
    <div class="container">
        @yield('content')
    </div>
    @stack('footer')
</body>
</html>

而您的配置可能如下所示

'blade' => [
    'layout' => 'layouts.app',
    'section' => 'content',
    'stacks' => [
        'head' => 'head',
        'footer' => 'footer',
    ]
],

在您的数据库中，通过将您自己添加到liddleforum_admins表来将您的个人用户添加为管理员。
转到domain.com/forums/admin的仪表板并添加您的分类。首先添加基础分类 - 这些分类不能有主题，只能包含子分类。然后向这些基础分类添加子分类以在主页上显示。或者，您也可以运行命令php artisan db:seed --class=LiddleForumExampleSeeder以为您添加一些示例分类。

现在您可以通过访问domain.com/forums来查看论坛 - 但是您可以更改配置中的路由

这是启动所需的所有必要配置。有关进一步自定义和功能，请参阅下一部分

附加功能/自定义

用户头像

默认情况下，使用Gravatar显示用户头像。您可以在配置中的user.avatar.driver下更改头像驱动程序

LiddleForum包含gravatar和user_column，但您可以扩展\LiddleDev\LiddleForum\Drivers\Avatar\AvatarInterface并添加到配置中来自定义头像驱动程序

Gravatar

如果您想使用Gravatar，请将驱动程序设置为gravatar并在Gravatar选项中输入用户表的电子邮件列

用户列

将驱动设置为 user_column，并将 url_column 设置为包含头像URL的用户表中的列

文本编辑器

默认使用TinyMCE来创建和回复主题。您可以在配置文件中的text_editor部分更改此设置。

您可以选择使用tinymce、trumbowyg，或者通过扩展 \LiddleDev\LiddleForum\Drivers\TextEditor\TextEditorInterface 来添加自己的。

如果您选择使用Trumbowyg，请注意它需要jQuery。

通知

LiddleForum支持使用Laravel 5.3中引入的通知系统。默认情况下通知是禁用的。如果您使用的是至少5.3的版本，您可以在配置中通过设置通知类型为启用并扩展提供的抽象类来开启通知。

注意：您的用户模型需要使用Notifiable特质。

版主

您可以在管理面板中添加版主。导航到版主标签页，通过输入您希望成为版主的用户ID来添加版主。

您可以让他们成为全局版主，或者限制他们的管理权限到特定的分类及其子分类。

路线图

以下是当前计划在未来版本中实现的功能列表

主题 - 提供了一种轻松定制论坛CSS的方式

最终注意事项

请仔细查看app/config/liddleforum.php以确保您按照自己的需求定制论坛。您会在其中找到关于每个部分的更多说明。

如果您在使用论坛时遇到任何问题，请创建一个issue或pull request，我会查看的：）

liddledev / liddleforum

维护者

详细信息