kikusempai/yii2-adminlte-asset

Yii2 框架的后端主题

安装次数: 152

依赖者: 0

建议者: 0

安全性: 0

星标: 0

关注者: 2

分支: 425

类型:yii2-extension

2.3.3 2016-07-27 11:20 UTC

README

基于 AdminLTE 的 Yii2 框架后端 UI

"Yii2 AdminLTE Presentation"

本包包含一个为 Yii 2.0 框架注册 AdminLTE 用户界面 CSS 文件的 资产包

CSS 文件通过 Yii 推荐的 fxp/composer-asset-plugin v1.1.1 或更高版本安装。

安装

安装此扩展的首选方法是通过 composer

要安装 AdminLTE v2,请运行

php composer.phar require dmstr/yii2-adminlte-asset "2.*"

要安装 AdminLTE v1,请运行

php composer.phar require dmstr/yii2-adminlte-asset "1.*"

快速入门

安装扩展后,您可以通过重新配置视图组件的路径映射来获得一个 预览

对于 Yii 2 高级应用程序模板基本应用程序模板

'components' => [
    'view' => [
         'theme' => [
             'pathMap' => [
                '@app/views' => '@vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app'
             ],
         ],
    ],
],

对于 Phundament 4

'components' => [
    'view' => [
        'theme' => [
            'pathMap' => [
                '@app/views' => '@vendor/dmstr/yii2-adminlte-asset/example-views/phundament/app'
            ],
        ],
    ],
],

此资产包提供了布局和视图的示例文件(请参阅 examples/ 文件夹),它们不是直接在 vendor/ 文件夹中自定义的。

因此,建议您将视图复制到您的应用程序中,并根据需要调整它们。

自定义

  • vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app(或其它主题)复制文件到 @app/views
  • 如果您之前已经进行了路径映射,请从您的应用程序中删除自定义的 view 配置。
  • 编辑您的视图,遵循 vendor/almasaeed2010/adminlte/pages 中的 html 标记。

皮肤

默认情况下,此扩展使用蓝色皮肤为 AdminLTE。您可以在配置文件中更改它。

'components' => [
    'assetManager' => [
        'bundles' => [
            'dmstr\web\AdminLteAsset' => [
                'skin' => 'skin-black',
            ],
        ],
    ],
],

然后只需替换 body 的 class 为 skin-blue。如果您不想在更改皮肤颜色时修改每个视图文件,可以使用 AdminLteHelper::skinClass()

<body class="<?= \dmstr\helpers\AdminLteHelper::skinClass() ?>">

注意:仅在通过配置覆盖皮肤时使用 AdminLteHelper::skinClass()。否则,您将无法获得 body 的正确 CSS 类。

以下是可用的皮肤列表

"skin-blue",
"skin-black",
"skin-red",
"skin-yellow",
"skin-purple",
"skin-green",
"skin-blue-light",
"skin-black-light",
"skin-red-light",
"skin-yellow-light",
"skin-purple-light",
"skin-green-light"

如果您想使用 AdminLTE 的原生 DOM 标题

<h1>
    About <small>static page</small>
</h1>

请按照以下代码进行操作

/* @var $this yii\web\View */

$this->params['breadcrumbs'][] = 'About';

$this->beginBlock('content-header'); ?>
About <small>static page</small>
<?php $this->endBlock(); ?>

<div class="site-about">
    <p> This is the About page. You may modify the following file to customize its content: </p>
    <code><?= __FILE__ ?></code>
</div>

左侧侧边栏菜单 - Widget Menu

如果您需要将菜单的某些部分分开,只需在 items 中添加 li.header 项目。

    'items' => [
        ['label' => 'Gii', 'icon' => 'fa fa-file-code-o', 'url' => ['/gii']],
        ['label' => 'Debug', 'icon' => 'fa fa-dashboard', 'url' => ['/debug']],
        ['label' => 'MAIN NAVIGATION', 'options' => ['class' => 'header']], // here
        // ... a group items
        ['label' => '', 'options' => ['class' => 'header']],
        // ... a group items
        ['label' => '', 'options' => ['class' => 'header']],
        // ... a group items

为项目添加标签

'items' => [
        [
            'label' => '<span>Mailbox</span><span class="pull-right-container"><small class="label pull-right bg-yellow">' . $mailCount . '</small></span>',
            'icon' => 'fa fa fa-envelope-o',
            'url' => ['/mailbox'],
            'encode' => false,
        ],

更多信息

有关 AdminLTE 文档,请参阅 https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html

命名空间规则遵循 Yii 2.0 框架结构,例如 Asset Bundle 的 dmstr\web