README

针对 Laravel 的最小化博客包

<a href="https://travis-ci.org/talvbansal/easel" target="_blank">
    <img src="https://api.travis-ci.org/talvbansal/easel.svg" alt="Build Status" />
</a>

<a href="https://styleci.io/repos/63001540" target="_blank">
    <img src="https://styleci.io/repos/63001540/shield?style=flat" alt="Style CI" />
</a>

<a href="https://github.com/talvbansal/easel/issues" target="_blank">
    <img src="https://img.shields.io/github/issues/talvbansal/easel.svg" alt="Issues" />
</a>

<a href="https://packagist.org.cn/packages/talvbansal/easel" target="_blank">
    <img src="https://poser.pugx.org/talvbansal/easel/downloads" alt="Downloads" />
</a>

<a href="https://insight.sensiolabs.com/projects/06d23269-ac1d-4465-b542-9c38b31f8d91" target="_blank">
    <img src="https://img.shields.io/sensiolabs/i/06d23269-ac1d-4465-b542-9c38b31f8d91.svg?style=flat" alt="SensioLabsInsight"/>
</a>

<a href="https://github.com/talvbansal/easel/blob/master/licence" target="_blank">
    <img src="https://poser.pugx.org/talvbansal/easel/license" alt="License" />
</a>

需求

PHP >= 5.6
Composer
现有的 Laravel 5.3 项目

安装

您可以使用 composer 下载 Easel
```
composer require talvbansal/easel
```
为了将 easel:install 和 easel:update artisan 命令以及 Easel 的新路由注册为工作状态，您需要将 Easel 服务提供者添加到您的 config/app.php 文件
```
\Easel\Providers\EaselServiceProvider::class,
```
要安装 Easel 到您的项目中，运行以下命令，这将发布所有应用程序资产和所需的数据库迁移 / 工厂 / 种子，迁移将自动由此命令执行
```
php artisan easel:install
```
最后，您需要为数据库播种以创建默认管理员用户和初始帖子
```
php artisan db:seed
```
更新您的 config/auth.php 文件以使用 Easel 内置的用户模型 (Easel\Models\User)
```
 'providers' => [
     'users' => [
         'driver' => 'eloquent',
         'model' => Easel\Models\User::class,
     ],
 ],
```
或者，您可以配置 Easel 以使用您自己的自定义用户模型
使用默认凭据登录 Easel
- 邮箱 admin@easel.com
- 密码 password
转到个人资料页面并更新您的详细信息和个人密码！
开始博客！

更新

每当对 Easel 进行更新时，在运行 composer update 时内部文件将自动更新，然而新的视图和资产将只通过以下命令发布 / 重新发布
```
  php artisan easel:update
```

您还可以将上述命令添加到您的项目 composer.json 文件中的 post-update-cmd

  "post-update-cmd": [
      "Illuminate\\Foundation\\ComposerScripts::postUpdate",
      "php artisan easel:update",
      "php artisan optimize"
  ]

自定义

每个应用程序都是不同的，Easel 已经被设计为可自定义。请确保检查 config/easel.php 以获取完整的可配置选项列表。

用户模型

由于 Easel 被设计为是新建项目的起点或添加到现有项目中的起点，您可以决定使用内置的 User 模型 (Easel\Models\User) 或使用经过一些修改的现有 User 模型。
内置模型

如果您想使用内置的用户模型 (Easel\Models\User)，您需要在 config/auth.php 文件中设置它

  'providers' => [
      'users' => [
          'driver' => 'eloquent',
          'model' => Easel\Models\User::class,
      ],
  ],

自定义模型

如果您想使用现有模型，您需要对其进行以下修改

您的用户模型需要实现 Easel\Models\BlogUserInterface 并使用 Easel\Models\EaselUserTrait

您还需要将键 birthday 添加到用户模型的 $dates 属性

 class User extends Model implements \Easel\Models\BlogUserInterface{
 
     use Easel\Models\EaselUserTrait;
 
     protected $dates = ['birthday'];
     
 }

然后最后更新 config/easel.php 配置文件使用您的用户模型
```
'user_model' => \My\Custom\User::class,
```

自定义博客的URL前缀

默认情况下，您可以访问博客列表和帖子，以下路由

    /blog
    /blog/{blog-post-slug}

但是您可能希望博客可以通过不同的URI访问，Easel允许您通过在.env文件中添加以下键BLOG_BASE_URL来配置，例如

    BLOG_BASE_URL=/myblog

上述更改将使您的博客在以下位置响应

    /myblog
    /myblog/{blog-post-slug}

如果您希望博客在'/'路由下响应，您需要向您的routes.php文件添加一个新路由，如下所示

    Route::get('/', '\Easel\Http\Controllers\Frontend\BlogController@index');

自定义您的博客帖子视图和列表

在创建博客帖子时，您可以使用Easel的default布局，但是您可能需要修改视图以适应您的应用程序。您还可能需要为不同的博客帖子提供不同的视图——Easel已经为您准备好了！只需将BLOG_POST_LAYOUTS键添加到您的.env文件中，并给出resources/views文件夹中一个文件夹的路径

例如

    BLOG_POST_LAYOUTS=layouts.blog.posts

将指向以下文件夹

    {project}/resources/views/layouts/blog/posts

该文件夹中的每个blade模板都将在帖子创建页面列出，作为该帖子的潜在布局。
BLOG_POST_LAYOUTS文件夹内的子文件夹将不会被列出，这样您就可以在该单个文件夹结构中存储模板的片段。

您还可以使用BLOG_POST_LIST键设置博客帖子列表布局，它再次指向您的resources/views文件夹中的一个相应的视图

    BLOG_POST_LIST=layouts.blog.list

talv86 / easel

维护者

详细信息

README

需求

安装

更新

自定义

用户模型

内置模型

自定义模型

自定义博客的URL前缀

自定义您的博客帖子视图和列表