说明
不久前开源了团队内部 改良过的Administrator ,很多朋友在集成的时候遇到问题,这里写一个简单的教程,演示如何一步步集成 Administrator 到现有的项目中。
准备
假设有一套博客程序,博客程序有数据模型 User
和 Topic
,我们需要为这两个数据模型开启后台编辑功能。
为了方便演示,做了一份 实例代码,可以跟着做,这个提交 2eb50160dd 的状态是已经创建好 User
和 Topic
数据模型、迁移文件,并且有对应的 数据填充。
使用以下命令安装即可:
- composer install
- php artisan migrate
- php artisan db:seed
简要步骤
- 安装 administrator;
- 配置;
- Model 配置信息。
1. 安装 administrator
composer require "summerblue/administrator:^1.0"
file
2. 配置
1). 编辑 config/app.php
在 providers
数组里面增加:
'providers' => [
Frozennode\Administrator\AdministratorServiceProvider::class,
]
2). 执行以下命令生成 config 信息:
php artisan vendor:publish
3). 创建 Administrator 配置信息存放文件夹
创建以下两个文件夹:
-
config/administrator
- 数据模型配置信息存放目录 -
config/administrator/settings
- 设置信息存放目录
3. Model 配置信息
1). administrator.php 文件夹中增加数据模型入口
找到 menu 选项:
'menu' => [
'用户管理' => [
'users' // 对应需要创建的文件:`config/administrator/users.php`
],
'内容管理' => [
'posts' // 对应需要创建的文件:`config/administrator/posts.php`
]
],
为了方便演示,找到 permission
选项,retuen true,注意上线必须修改过来,这里是后台访问权限控制。
'permission' => function () {
// return Auth::check();
return true;
},
如下图:
file
还有一个选项也是必填的,如下填入即可,这个选项是用来配置进入后台默认的页面:
'home_page' => 'posts',
2). 数据模型配置选项
创建与模型对应的配置文件:
-
config/administrator/posts.php
内容见下面 -
config/administrator/users.php
篇幅原因,内容请见 GitHub 项目
<?php
use App\Post;
return [
'title' => '文章',
'heading' => '文章管理',
'single' => '文章',
'model' => Post::class,
'columns' => [
'id' => [
'title' => 'ID'
],
'title' => [
'title' => 'Title',
],
'body' => [
'title' => 'Content',
'sortable' => false,
'output' => function($value)
{
return str_limit($value);
},
],
'user_name' => [
'title' => "Author",
'relationship' => 'user', //this is the name of the Eloquent relationship method!
'select' => "(:table).name",
],
'created_at',
'operation' => [
'title' => '管理',
'output' => function ($value, $model) {
return $value;
},
'sortable' => false,
],
],
'edit_fields' => [
'title' => [
'title' => '标题',
'type' => 'text'
],
'body' => [
'title' => '内容',
'type' => 'textarea'
],
'user' => array(
'type' => 'relationship',
'title' => 'Author',
'name_field' => 'name',
)
],
'filters' => [
'title' => [
'title' => '标题',
]
],
];
这时候访问后台:
file一些信息
- administrator 支持多语言,修改
config/app.php
的 'locale' => 'zh-CN' 可使用中文; - 文档就在项目的 docs 里,也可以 点击这里 查看, 实例文件 知道一看;
- 想要灵活使用 administrator,文档 至少得多过几遍;
- 想要查看更多的用例,PHPHub 的后台就是使用 administrator 构建,请参阅。
本文章首发在 Laravel China 社区
Practice makes perfect.
网友评论