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.cssSass构建中的任何CSS文件'scripts/_app.blade.php':任何特定应用程序的JS文件- 任何其他你喜欢的视图部分
在渲染视图时,请确保传递一个 'page_title' 数据项以显示页面标题。
许可协议
此代码在MIT许可下开源。有关更多信息,请参阅LICENSE文件。