README

此包提供了一种快速设置SB Admin 2与Laravel 5的方法。除了Laravel外，没有其他要求和依赖，因此您可以立即开始构建您的管理面板。该包仅提供可扩展的Blade模板和高级菜单配置选项。

1. 要求

Laravel 5.5.x至5.8.x PHP >= 7.0.0

2. 安装

使用composer要求此包

composer require thegreyhatt/laravel-sbadmin2

将服务提供者添加到config/app.php中的providers
```
Thegreyhatt\LaravelSBAdmin2\ServiceProvider::class
```

发布公共资产

php artisan vendor:publish --provider="Thegreyhatt\LaravelSBAdmin2\ServiceProvider" --tag=assets

3. 更新

要更新此包，首先更新composer包

composer update thegreyhatt/laravel-sbadmin2

然后，使用--force标志发布公共资产以覆盖现有文件

php artisan vendor:publish --provider="Thegreyhatt\LaravelSBAdmin2\ServiceProvider" --tag=assets --force

4. 使用方法

要使用模板，创建一个blade文件，并使用@extends('sbadmin2::page')扩展布局。此模板产生以下部分

title：用于<title>标签
content_header：页面标题，位于内容上方
content：页面的全部内容
css：额外的样式表（位于<head>中）
js：额外的javascript（位于</body>之前）

所有部分都是可选的。您的blade模板可能如下所示。

{{-- resources/views/admin/dashboard.blade.php --}}

@extends('sbadmin2::page')

@section('title', 'Dashboard')

@section('content_header')
    Dashboard
@stop

@section('content')
    <p>Welcome to this beautiful admin panel.</p>
@stop

@section('css')
    <link rel="stylesheet" href="/css/admin_custom.css">
@stop

@section('js')
    <script> console.log('Hi!'); </script>
@stop

您现在只需从控制器返回此视图即可，就像平常一样。

5. 配置

首先，发布配置文件

php artisan vendor:publish --provider="Thegreyhatt\LaravelSBAdmin2\ServiceProvider" --tag=config

现在，编辑config/sbadmin2.php以配置标题、皮肤、菜单、URL等。所有配置选项都在注释中解释。然而，我想简要介绍一下menu配置。

5.1 菜单

您可以按如下方式配置您的菜单

'menu' => [
    [
    	'text'	=>	'Dashboard',
    	'url'	=>	'/dashboard',
    	'icon'	=>	'fa-tachometer-alt',
    ],
    	'Addons',
    [
    	'text'		=>	'Pages',
    	'icon'		=>	'fa-folder',
    	'submenu'	=>	[
    	'Login Screens:',
    		[
    			'text'	=>	'Login',
    			'url'	=>	'/login',
    		],
    		[
    			'text'	=>	'Register',
    			'url'	=>	'/register',
    		],
    		'Other Pages:',
    		[
    			'text'	=>	'404 Page',
    			'url'	=>	'#'
    		],
    		[
    			'text'	=>	'Blank Page',
    			'url'	=>	'#'
    		],
    	],
    ],
    [
    	'text'	=>	'Charts',
    	'url'	=>	'#',
    	'icon'	=>	'fa-chart-area',
    ],
    [
    	'text'	=>	'Tables',
    	'url'	=>	'#',
    	'icon'	=>	'fa-table',
    ],
],

使用单个字符串，您指定一个菜单标题项以分隔项目。使用数组，您指定一个菜单项。text和url是必需的属性。如果省略，则icon是可选的。您可以使用来自Font Awesome的图标。只需指定图标的名称，它就会出现在菜单项之前。

6. 自定义视图

如果您需要完全控制提供的视图，可以发布它们

php artisan vendor:publish --provider="Thegreyhatt\LaravelSBAdmin2\ServiceProvider" --tag=views

现在，您可以在resources/views/vendor/sbadmin2中编辑视图。

7. 问题、问题和Pull Requests

您可以在问题部分报告问题并提问。请从ISSUE: 开始您的报告，并从QUESTION: 开始您的提问

如果您有问题，请先查看已关闭的问题。随着时间的推移，我已经能够回答很多问题。

要提交Pull Request，请先分支此存储库，创建一个新的分支，并将您的新/更新代码提交到其中。然后从您的分支打开Pull Request。有关更多信息，请参阅此指南。

thegreyhatt / laravel-sbadmin2

维护者

详细信息