npmweb / admin-theme-laravel-layout
用于Laravel的布局文件,具有NPM Admin Theme的外观和感觉。
Requires
- php: >=5.4.0
- illuminate/support: ~4.2 || ~5.0
- laracasts/flash: ~1.3
- laravelcollective/html: ~4.2 || ~5.0
- npmweb/laravel-helpers: 1.*
README
用于Laravel的布局文件,具有NPM Admin Theme的外观和感觉。
与 npmweb/admin-theme Bower 包兼容。
安装
运行 composer require npmweb/admin-theme-laravel-layout:^3.0
将服务提供者添加到你的Laravel服务提供者列表中的 config\app.php
'providers' => [
...
NpmWeb\AdminThemeLaravelLayout\LayoutServiceProvider::class,
],
此包还依赖于 laravelcollective/html
。它将由Composer下载,但如果你的 app.php
中尚未设置,请添加以下条目
'providers' => [
...
Collective\Html\HtmlServiceProvider::class,
],
...
'aliases' => [
'Form' => Collective\Html\FormFacade::class,
'Html' => Collective\Html\HtmlFacade::class,
],
添加一个空的 public/css/makeitbetter.css
文件。这是此包的 shame.css 名称。
安装Admin Theme Sass库 npmweb/admin-theme(例如,通过Bower)。然后使用Elixir设置默认的JS和CSS资产。所有这些都可以通过将你的Laravel项目的gulpfile.js替换为示例 src/gulpfile.js
来处理。
- Sass或Less将从
resources/assets/sass/app.scss
编译到public/css/app.css
文件。 (你可以复制此包的src/app.scss
以开始。) - 第三方JavaScript依赖将合并到
public/js/vendor.js
文件中。 - 需要将
foundation-icon-fonts
库(由Bower作为admin-theme
的依赖项下载)复制到public/vendor/foundation-icon-fonts
以使其可网络访问。 - 所有这些文件都需要使用Elixir通过
mix.version()
进行版本控制。
在 config/app.php
中添加一个条目以设置模板中显示的系统名称
'name' => 'My Awesome App',
用法
不要扩展你自己的Blade布局模板,而是使用以下行
@extends('admin-theme-laravel-layout::layout')
以下部分可以使用 @section('my-section-name')
语法填写
'content'
:你的主要页面主体内容'breadcrumbs'
:显示在页面顶部的面包屑'page-header-buttons'
:显示在页面标题右侧的按钮,即'js'
:特定页面的 <script/> 标签'css'
:特定页面的CSS <link/> 标签
你还可以覆盖一些视图部分以自定义系统的外观。只需运行 php artisan vendor:publish --provider="NpmWeb\AdminThemeLaravelLayout\LayoutServiceProvider"
,然后在 resources/views/vendor/admin-theme-laravel-layout
中自定义它们。
'_nav.blade.php'
:定义你的侧边栏'css/_non_sass.blade.php'
:无法包含在app.css
Sass构建中的任何CSS文件'scripts/_app.blade.php'
:任何特定应用程序的JS文件- 任何其他你喜欢的视图部分
在渲染视图时,请确保传递一个 'page_title'
数据项以显示页面标题。
许可协议
此代码在MIT许可下开源。有关更多信息,请参阅LICENSE文件。