hsyir/laravel-adminlte

简化Laravel与AdminLTE集成


README

Latest Version on Packagist Build Status Quality Score StyleCI Total Downloads

此包提供了一个快速设置Laravel 6与AdminLTE v3集成的简单方法。它除了Laravel之外没有其他要求和依赖,因此您可以立即开始构建您的管理面板。该包仅提供可扩展的Blade模板和高级菜单配置选项。还包括一个替换make:auth Artisan命令的替代品,该命令使用AdminLTE风格的视图而不是默认的Laravel视图。

如果您想使用旧版本,请使用以下版本

  • 版本1.x或分支laravel5-adminlte2:此版本支持Laravel 5,包含AdminLTE v2
  • 版本2.x或分支laravel6-adminlte2:此版本支持Laravel 6,包含AdminLTE v2
  1. 要求
  2. 安装
  3. 更新
  4. 用法
  5. Artisan控制台命令
    1. adminlte:install 命令
      1. 选项
    2. adminlte:plugins 命令
    3. adminlte:update 命令
    4. 认证视图
      1. 使用adminlte:install命令使用认证视图
  6. 配置
    1. 标题
    2. 网站图标
    3. 标志
    4. 布局
    5. 侧边栏
    6. 控制侧边栏(右侧边栏)
    7. URL
    8. Laravel Mix
    9. 菜单
    10. 添加搜索输入
    11. 自定义菜单过滤器
    12. 运行时菜单配置
    13. 活动菜单项
    14. 菜单过滤器
    15. 插件
    16. Pace插件配置
  7. 翻译
    1. 菜单翻译
  8. 自定义视图
  9. 问题、问题和拉取请求

1. 要求

  • Laravel 6.x
  • PHP >= 7.2

2. 安装

  1. 使用composer要求包

    composer require hsyir/laravel-adminlte
    
  2. 使用以下命令安装包(适用于全新的Laravel安装)

    php artisan adminlte:install
    

您可以使用--basic来避免安装认证脚手架

您可以使用--force来覆盖任何文件

您还可以使用--interactive来引导您通过流程并选择您想要安装的内容

3. 更新

  1. 要更新此包,首先更新composer包

    composer update hsyir/laravel-adminlte
    
  2. 然后,我们需要更新资产

    如果您使用Laravel 5.x的AdminLTE并且正在升级到Laravel 6版本,请删除public/vendor文件夹中的adminlte文件夹。

    然后使用此命令发布新的资产

    php artisan adminlte:update
    
  3. 如果您已经发布并修改了默认的master、页面或登录视图,您也需要更新它们。

    选项1

    • 复制您修改的视图。
    • 再次发布视图,使用
      php artisan vendor:publish --provider="JeroenNoten\LaravelAdminLte\AdminLteServiceProvider" --tag=views
      
    • 重做您所做的修改。

    选项2

    • 在master和页面视图的css、js和其他资产位置进行修改。

4. 用法

要使用模板,创建一个blade文件,并使用@extends('adminlte::page')扩展布局。此模板提供以下部分

  • title:用于<title>标签
  • content_header:页面标题,位于内容上方
  • content:页面的全部内容
  • css:额外的样式表(位于<head>中)
  • js:额外的javascript(位于</body>之前)

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

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

@extends('adminlte::page')

@section('title', 'Dashboard')

@section('content_header')
    <h1>Dashboard</h1>
@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

现在只需从您的控制器返回此视图即可,与往常一样。查看 AdminLTE 了解如何为您的管理员面板构建美观的内容。

5. Artisan 控制台命令

5.1 adminlte:install 命令

您可以使用 adminlte:install 命令安装所有必需和附加资源。

不使用任何选项将安装 AdminLTE 资产、配置和翻译。您还可以通过添加 --type=enhanced 或将基本视图和路由也添加到认证视图,通过添加 --type=fulladminlte:install 命令来安装认证视图。

5.1.1 选项

  • --force:默认情况下覆盖现有视图
  • --type=:安装类型,可用类型:none、basic、enhanced 和 full。
  • --only=:仅安装特定部分,可用部分:assets、config、translations、auth_views、basic_views、basic_routes 和 main_views。此选项不能与 with 选项一起使用。
  • --with=*:使用特定部分安装基本资产,可用部分:auth_views、basic_views 和 basic_routes。可以使用多个。
  • --interactive:安装将引导您完成过程

5.2 adminlte:plugins 命令

如果您不使用 cdn 来管理插件,可以使用 adminlte:plugins 命令来管理可选插件资产。

您可以列出所有可用的插件,安装/更新/删除所有或特定插件。以下是一些命令示例

安装所有插件资产

  • artisan adminlte:plugins install 仅安装 Pace Progress 和 Select2 插件资产
  • artisan adminlte:plugins install --plugin=paceProgress --plugin=select2

更新所有插件资产

  • artisan adminlte:plugins update 仅更新 Pace Progress 插件资产
  • artisan adminlte:plugins update

删除所有插件资产

  • artisan adminlte:plugins remove 仅删除 Select2 插件资产
  • artisan adminlte:plugins remove --plugin=select2

5.2.1 选项

  • operation:操作命令,可用命令:list(默认)、install、update 和 remove。
  • --plugin=:插件键。可用于多个。
  • --interactive:安装将引导您完成过程。

5.3 adminlte:update 命令

此命令是 adminlte:install --force --only=assets 的快捷方式。

5.4 认证视图

注意:仅适用于 Laravel 5.2 及更高版本

此软件包提供了以下命令,用于将认证视图替换为 AdminLTE 风格视图。

php artisan adminlte:install --only=auth_views

5.4.1 使用认证视图而不使用 adminlte:install 命令

如果您想手动使用包含的认证相关视图,可以创建以下文件,并仅在每个文件中添加一行

  • resources/views/auth/login.blade.php:
@extends('adminlte::login')
  • resources/views/auth/register.blade.php
@extends('adminlte::register')
  • resources/views/auth/passwords/email.blade.php
@extends('adminlte::passwords.email')
  • resources/views/auth/passwords/reset.blade.php
@extends('adminlte::passwords.reset')

默认情况下,登录表单包含一个链接到注册表单。如果您不想显示注册表单,请将 register_url 设置为 null,则不会显示链接。

6. 配置

首先,发布配置文件

php artisan adminlte:install --only=config

现在,编辑 config/adminlte.php 以配置标题、皮肤、菜单、URL 等。所有配置选项均在注释中解释。然而,我想对 menu 配置进行一些说明。

6.1 标题

您管理员面板的默认标题,这会放入您页面标题标签中。您可以通过标题部分按页面覆盖它。您还可以选择指定标题前缀和/或后缀。

以下配置选项可用

  • title

    默认标题

  • title_prefix

    标题前缀

  • title_postfix

    标题后缀

6.2 Favicon

favicon 可以很容易地使用。有两种不同的方法来完成此操作。请将所有 favicon 添加到 public/favicons/ 目录中。

  • ['use_ico_only' => true, 'use_full_favicon' => false]

    如果设置为 true,将使用文件 public/favicons/favicon.ico

  • ['use_ico_only' => false, 'use_full_favicon' => true]

如果 'use_full_favicon' => true,则将使用 public/favicons/ 目录中的更多 favicon 文件。激活代码为

    <link rel="shortcut icon" href="{{ asset('favicons/favicon.ico') }}" />
    <link rel="apple-touch-icon" sizes="57x57" href="{{ asset('favicons/apple-icon-57x57.png') }}">
    <link rel="apple-touch-icon" sizes="60x60" href="{{ asset('favicons/apple-icon-60x60.png') }}">
    <link rel="apple-touch-icon" sizes="72x72" href="{{ asset('favicons/apple-icon-72x72.png') }}">
    <link rel="apple-touch-icon" sizes="76x76" href="{{ asset('favicons/apple-icon-76x76.png') }}">
    <link rel="apple-touch-icon" sizes="114x114" href="{{ asset('favicons/apple-icon-114x114.png') }}">
    <link rel="apple-touch-icon" sizes="120x120" href="{{ asset('favicons/apple-icon-120x120.png') }}">
    <link rel="apple-touch-icon" sizes="144x144" href="{{ asset('favicons/apple-icon-144x144.png') }}">
    <link rel="apple-touch-icon" sizes="152x152" href="{{ asset('favicons/apple-icon-152x152.png') }}">
    <link rel="apple-touch-icon" sizes="180x180" href="{{ asset('favicons/apple-icon-180x180.png') }}">
    <link rel="icon" type="image/png" sizes="16x16" href="{{ asset('favicons/favicon-16x16.png') }}">
    <link rel="icon" type="image/png" sizes="32x32" href="{{ asset('favicons/favicon-32x32.png') }}">
    <link rel="icon" type="image/png" sizes="96x96" href="{{ asset('favicons/favicon-96x96.png') }}">
    <link rel="icon" type="image/png" sizes="192x192"  href="{{ asset('favicons/android-icon-192x192.png') }}">
    <link rel="manifest" href="{{ asset('favicons/manifest.json') }}">
    <meta name="msapplication-TileColor" content="#ffffff">
    <meta name="msapplication-TileImage" content="{{ asset('favicons/ms-icon-144x144.png') }}">

6.3 标志

标志显示在您的管理面板的右上角。如果您想使用简单的文本标志和小图像标志(例如,50 x 50 像素),则可以在此处使用基本 HTML,或者您可以使用两个图像,一个大的(例如,210 x 33 像素)和一个小的(例如,50 x 50 像素)。您还可以更改图像的大小以及两个标志的 alt 文本。

  • logo

    文本标志内容,可以是 HTML。

  • logo_img

    小标志图像,位于文本标志旁边。

    推荐尺寸:50x50px

  • logo_img_class

    小标志图像的额外类。

  • logo_img_xl

    大标志图像,如果您设置了 img URL,它将用一个大标志替换文本标志和小标志,并在折叠侧边栏中显示小标志。

    推荐尺寸:210x33px

  • logo_img_xl_class

    小标志图像的额外类。

  • logo_img_alt

    标志图像 alt 文本。

6.4 布局

可以更改布局,您可以使用仅顶部导航(navbar)布局,带有侧边栏的盒式布局,并且您可以启用侧边栏、navbar 和页脚的固定模式。

以下配置选项可用

  • layout_topnav

    启用/禁用仅顶部导航布局。

  • layout_boxed

    启用/禁用盒式布局,不能与 layout_topnav 同时使用。

  • layout_fixed_sidebar

    启用/禁用固定侧边栏,不能与 layout_topnav 同时使用。

  • layout_fixed_navbar

    启用/禁用固定 navbar(顶部导航),在此处您可以设置 true 或传递一个数组以实现响应式使用。

  • layout_fixed_footer

    启用/禁用固定页脚,在此处您可以设置 true 或传递一个数组以实现响应式使用。

layout_fixed_navbar & layout_fixed_footer 的响应式使用

使用响应式,您可以禁用或启用特定视口大小下的固定 navbar/page footer。

数组有以下键可用,您可以将其设置为 truefalse

  • xs 从 0px 到 575.99px
  • sm 从 576px 到 767.99px
  • md 从 768px 到 991.99px
  • lg 从 992px 到 1199.99px
  • xl 从 1200px

示例

  • ['xs' => true, 'lg' => false]

    从手机到小平板(<= 991.99px)固定

  • ['lg' => true]

    从桌面(>= 992px)开始固定

  • ['xs' => true, 'md' => false, 'xl' => true]

    从手机(<= 767.99px)和超大桌面(>= 1200px)固定,但不为小平板和桌面(>= 768px & <= 1199.99px)固定

6.5 类

您可以根据需要更改管理面板的外观和行为,您可以添加额外的类到 body、brand、sidebar、sidebar 导航、顶部导航和顶部导航容器。

以下配置选项可用

  • classes_body

    body 的额外类。

  • classes_brand

    brand 的额外类。

  • classes_brand_text

    brand 文本的额外类。

  • classes_content_header

    content header 容器的额外类。

  • classes_content

    content 容器的额外类。

  • classes_sidebar

    sidebar 的额外类。

  • classes_sidebar_nav

    sidebar 导航的额外类。

  • classes_topnav

    顶部导航栏的额外类。

  • classes_topnav_nav

    顶部导航的额外类。

  • classes_topnav_container

    顶部导航栏容器的额外类。

6.6 侧边栏

您可以修改侧边栏,您可以选择禁用折叠迷你侧边栏,从折叠侧边栏开始,启用特定屏幕尺寸下的侧边栏自动折叠,启用侧边栏折叠记忆,更改滚动条主题或自动隐藏选项,禁用侧边栏导航手风琴和侧边栏导航菜单项动画速度。

以下配置选项可用

  • sidebar_mini

    启用/禁用桌面和大屏幕(≥992px)上的折叠迷你侧边栏,在此您可以设置truefalse'md'以启用小平板和大屏幕(≥768px)。

  • sidebar_collapse

    启用/禁用默认折叠。

  • sidebar_collapse_auto_size

    通过设置折叠的最小宽度来启用/禁用自动折叠。

  • sidebar_collapse_remember

    启用/禁用折叠记住脚本。

  • sidebar_collapse_remember_no_transition

    启用/禁用页面重新加载后的过渡。

  • sidebar_scrollbar_theme

    更改侧边栏滚动条主题。

  • sidebar_scrollbar_auto_hide

    更改侧边栏滚动条自动隐藏触发器。

  • sidebar_nav_accordion

    启用/禁用侧边栏导航手风琴功能。

  • sidebar_nav_animation_speed

    更改侧边栏导航滑动动画速度。

6.7 控制侧边栏(右侧边栏)

在这里,您可以选择启用右侧边栏。当激活时,您可以使用@section('right-sidebar')配置的图标将在顶部菜单的末尾显示,并显示/隐藏侧边栏。滑动选项将侧边栏滑过内容,而false将推动内容,且没有动画。您还可以选择侧边栏主题(深色或浅色)。

以下配置选项可用

  • right_sidebar

    启用/禁用右侧边栏。

  • right_sidebar_icon

    更改主导航中右侧边栏按钮的图标。

  • right_sidebar_theme

    更改右侧边栏的主题,以下选项可用:dark & light

  • right_sidebar_slide

    启用/禁用滑动动画。

  • right_sidebar_push

    启用/禁用使用覆盖而不是侧边栏的推送内容。

  • right_sidebar_scrollbar_theme

    启用/禁用页面重新加载后的过渡。

  • right_sidebar_scrollbar_auto_hide

    更改侧边栏滚动条自动隐藏触发器。

6.8 URL

在此,我们有url设置来设置正确的登录/注册链接。在此注册您的仪表板,注销,登录和注册URL。

  • use_route_url

    是否使用route()代替url()

  • dashboard_url

    更改仪表板/标志URL。

  • logout_url

    更改注销按钮URL。

  • logout_method

    更改注销发送方法,可用选项:GETPOST & null(Laravel默认)。Laravel 5.3或更高版本中注销URL自动发送POST请求。

  • login_url

    更改登录URL。

  • register_url

    更改注册链接或如果设置为false则将其隐藏。

  • password_reset_url

    更改密码重置URL。

  • password_email_url

    更改密码电子邮件URL。

6.9 Laravel Mix

如果您想使用Laravel Mix而不是在您的/public/vendor文件夹中发布资产,请首先安装以下NPM包

npm i @fortawesome/fontawesome-free
npm i icheck-bootstrap
npm i overlayscrollbars

window.$ = window.jQuery = require('jquery');之后将以下内容添加到您的bootstrap.js文件中

    require('overlayscrollbars');
    require('../../vendor/almasaeed2010/adminlte/dist/js/adminlte');

将您的app.scss内容替换为以下内容

// Fonts
@import url('https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,400,600,700,300italic,400italic,600italic');
@import '~@fortawesome/fontawesome-free/css/all.css';
// OverlayScrollbars
@import '~overlayscrollbars/css/OverlayScrollbars.css';
// iCheck
@import '~icheck-bootstrap/icheck-bootstrap.css';
// AdminLTE
@import '../../vendor/almasaeed2010/adminlte/dist/css/adminlte.css';
// Bootstrap
// Already imported by AdminLTE
//@import '~bootstrap/scss/bootstrap';

在准备Laravel Mix供应商文件后,将enabled_laravel_mix设置为true以启用加载app.css & app.js .

  • enabled_laravel_mix

    在主布局中启用Laravel Mix特定的css/js加载。警告如果您启用此选项,则不会渲染adminlte_css & adminlte_js部分。

6.10 菜单

指定要显示在左侧侧边栏中的菜单项。每个菜单项都应该有文本和URL。您还可以指定来自Font Awesome的图标。字符串代替数组表示侧边栏布局中的标题。'can'是Laravel内置Gate功能的一个过滤器。

您可以根据以下方式配置您的菜单

'menu' => [
    'MAIN NAVIGATION',
    [
        'text' => 'Blog',
        'url' => 'admin/blog',
    ],
    [
        'text' => 'Pages',
        'url' => 'admin/pages',
        'icon' => 'fas fa-fw fa-file'
    ],
    [
        'text' => 'Show my website',
        'url' => '/',
        'target' => '_blank'
    ],
    'ACCOUNT SETTINGS',
    [
        'text' => 'Profile',
        'route' => 'admin.profile',
        'icon' => 'fas fa-fw fa-user'
    ],
    [
        'text' => 'Change Password',
        'route' => 'admin.password',
        'icon' => 'fas fa-fw fa-lock'
    ],
],

使用单个字符串,您可以指定菜单标题项以分隔项目。使用数组,您可以指定菜单项。必需属性是 texturlrouteicon 属性是可选的,如果您省略它,您将得到一个 开放圆圈。您可以使用的可用图标来自 Font Awesome。只需指定图标的名称,它就会出现在您的菜单项之前。

当启用侧边栏时,您也可以添加菜单项到顶部导航,只需将 topnav 属性设置为 true。如果启用了顶部导航布局,这将会被忽略,所有菜单项都将出现在顶部导航中。

如果您想有条件地显示菜单项,请使用 can 属性。这集成了 Laravel 的 Gate 功能。如果您还需要有条件地显示标题,您需要将其包装在一个数组中,就像其他菜单项一样,使用 header 属性。

[
    [
        'header' => 'BLOG',
        'url' => 'admin/blog',
        'can' => 'manage-blog'
    ],
    [
        'text' => 'Add new post',
        'url' => 'admin/blog/new',
        'can' => 'add-blog-post'
    ],
]

6.10.1 添加搜索输入

您可以在菜单中添加搜索输入,使用以下配置的菜单项

        [
            'search' => true,
            'href' => 'test',  //form action
            'method' => 'POST', //form method
            'input_name' => 'menu-search-input', //input name
            'text' => 'Search', //input placeholder
        ],

6.10.2 自定义菜单过滤器

如果您需要自定义过滤器,您可以轻松地向此包中添加自己的菜单过滤器。当您使用第三方授权包(而不是 Laravel 的 Gate 功能)时,这可能很有用。

例如,使用 Laratrust

<?php

namespace MyApp;

use JeroenNoten\LaravelAdminLte\Menu\Builder;
use JeroenNoten\LaravelAdminLte\Menu\Filters\FilterInterface;
use Laratrust;

class MyMenuFilter implements FilterInterface
{
    public function transform($item, Builder $builder)
    {
        if (isset($item['permission']) && ! Laratrust::can($item['permission'])) {
            return false;
        }

        return $item;
    }
}

然后添加到 config/adminlte.php

'filters' => [
    JeroenNoten\LaravelAdminLte\Menu\Filters\ActiveFilter::class,
    JeroenNoten\LaravelAdminLte\Menu\Filters\HrefFilter::class,
    JeroenNoten\LaravelAdminLte\Menu\Filters\SubmenuFilter::class,
    JeroenNoten\LaravelAdminLte\Menu\Filters\ClassesFilter::class,
    //JeroenNoten\LaravelAdminLte\Menu\Filters\GateFilter::class, Comment this line out
    MyApp\MyMenuFilter::class,
]

6.10.3 运行时菜单配置

您也可以在运行时配置菜单,例如在服务提供商的启动中。如果您菜单不是静态的,例如它依赖于您的数据库或区域设置,请使用此功能。您也可以结合两种方法。菜单将被简单拼接,服务提供商的顺序决定了菜单中的顺序。

要在运行时配置菜单,注册一个处理器或回调来处理 MenuBuilding 事件,例如在服务提供商的 boot() 方法中

use Illuminate\Contracts\Events\Dispatcher;
use JeroenNoten\LaravelAdminLte\Events\BuildingMenu;

class AppServiceProvider extends ServiceProvider
{

    public function boot(Dispatcher $events)
    {
        $events->listen(BuildingMenu::class, function (BuildingMenu $event) {
            $event->menu->add('MAIN NAVIGATION');
            $event->menu->add([
                'text' => 'Blog',
                'url' => 'admin/blog',
            ]);
        });
    }

}

配置选项与静态配置文件中相同。

一个更实用的示例,它实际使用了翻译和数据库

    public function boot(Dispatcher $events)
    {
        $events->listen(BuildingMenu::class, function (BuildingMenu $event) {
            $event->menu->add(trans('menu.pages'));

            $items = Page::all()->map(function (Page $page) {
                return [
                    'text' => $page['title'],
                    'url' => route('admin.pages.edit', $page)
                ];
            });

            $event->menu->add(...$items);
        });
    }

此基于事件的Approach用于确保构建菜单的代码只在管理员面板实际显示时运行,而不是在每个请求时。

6.10.4 激活菜单项

默认情况下,如果以下任何一个条件成立,则菜单项被视为激活

  • 当前路径与 url 参数匹配
  • 当前路径是 url 参数的子路径
  • 如果它包含一个包含激活菜单项的子菜单

要覆盖此行为,您可以指定一个包含激活 URL 的 active 参数数组,支持星号和正则表达式。

要使用正则表达式,只需在您的模式前加前缀 regex:,它将自动评估。该模式将尝试匹配由 request()->path() 返回的 URL 的路径,该函数返回不带域名当前 URL。例如

[
    'text' => 'Pages',
    'url' => 'pages',
    'active' => ['pages', 'content', 'content/*', 'regex:@^content/[0-9]+$@']
]

6.11 菜单过滤器

在此,我们可以设置用于渲染菜单的过滤器。您可以在创建它们后向此数组添加自己的过滤器。如果您不想使用 Laravel 内置的 Gate 功能,可以取消注释 GateFilter

  • filters

    菜单过滤器数组

默认菜单过滤器

  • JeroenNoten\LaravelAdminLte\Menu\Filters\HrefFilter::class
  • JeroenNoten\LaravelAdminLte\Menu\Filters\SearchFilter::class
  • JeroenNoten\LaravelAdminLte\Menu\Filters\ActiveFilter::class
  • JeroenNoten\LaravelAdminLte\Menu\Filters\SubmenuFilter::class
  • JeroenNoten\LaravelAdminLte\Menu\Filters\ClassesFilter::class
  • JeroenNoten\LaravelAdminLte\Menu\Filters\GateFilter::class
  • JeroenNoten\LaravelAdminLte\Menu\Filters\LangFilter::class

6.12 插件

配置应包含哪些JavaScript插件。目前,DataTable、Select2、Chartjs和SweetAlert已默认添加,通过script和link标签从CDN加载JavaScript和CSS文件。插件名称、激活状态和文件数组(即使为空)是必需的。文件添加时,需要具有类型(js或css)、资产(true或false)和位置(字符串)。当资产设置为true时,位置将通过asset()函数输出。

默认情况下,DataTablesSelect2ChartJSPaceSweetAlert2插件受支持但未激活。您可以通过更改配置文件来激活它们,使其在每一页上加载,或者在特定的blade文件中添加一个部分,这将自动注入它们的CDN文件。

部分示例:@section('plugins.Datatables', true)

您可以使用以下插件:

  • DataTables
  • Select2
  • Chartjs
  • Sweetalert2
  • Pace

您还可以添加和配置新的插件,通过以下示例结构修改插件变量

'plugins' => [
    [
        'name' => 'Plugin Name',
        'active' => true,
        'files' => [
            [
                'type' => 'js',
                'asset' => false,
                'location' => '//cdn.plugin.net/plugin.min.js',
            ],
            [
                'type' => 'css',
                'asset' => true,
                'location' => 'css/plugin.min.css',
            ],
        ],
    ],
]

使用指定的字符串名称指定插件名称,激活值将启用/禁用插件注入。每个插件都有一个文件数组,包含包含文件类型(jscss)和location的数组。

如果资产值设置为true,则注入将使用asset()函数。

6.12.1 Pace插件配置

您可以通过修改CSS文件位置来更改Pace插件的外观,当使用CDN注入时。

    'location' => '//cdnjs.cloudflare.com/ajax/libs/pace/1.0.2/themes/{{color}}/pace-theme-{{theme}}.min.css',

颜色值:black、blue(默认)、green、orange、pink、purple、red、silver、white和yellow

主题值:barber-shop、big-counter、bounce、center-atom、center-circle、center-radar(默认)、center-simple、corner-indicator、fill-left、flash、flat-top、loading-bar、mac-osx、minimal

7. 翻译

目前,默认提供英语、德语、法语、荷兰语、葡萄牙语、西班牙语和土耳其语的翻译。只需在config/app.php中指定语言。如果您需要修改文本或添加其他语言,可以发布语言文件

php artisan adminlte:install --only=translations

现在,您可以在resources/lang/vendor/adminlte中编辑翻译或添加语言。

7.1. 菜单翻译

此资源允许您使用lang文件,默认激活。

使用Lang配置菜单

首先,使用键text作为翻译字符串来配置菜单。这是一个配置示例

    [
        'header' => 'account_settings'
    ],
        [
            'text' => 'profile',
            'url'  => 'admin/settings',
            'icon' => 'user',
        ],

Lang文件

必须将所有翻译字符串添加到每个所需语言的menu.php文件中。翻译文件位于resources/lang/vendor/adminlte/

这是menu.php lang文件的示例

return [
    'account_settings'  => 'ACCOUNT SETTINGS',
    'profile'           => 'Profile',
];

要翻译菜单标题,只需使用header参数。示例

    [
        'header' => 'account_settings'
    ],
        [
            'text' => 'profile',
            'url'  => 'admin/settings',
            'icon' => 'user',
        ],

8. 自定义视图

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

php artisan adminlte:install --only=main_views

现在,您可以在resources/views/vendor/adminlte中编辑视图。

9. 问题、问题和Pull Requests

您可以在问题部分中报告问题和提问。请以ISSUE: 开头报告问题,以QUESTION: 开头提问

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

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