AdminLTE Asset Bundle

Backend UI for Yii2 Framework, based on AdminLTE, _(*1)

"Yii2 AdminLTE Presentation" , _(*2)

This package contains an Asset Bundle for Yii 2.0 Framework which registers the CSS files for the AdminLTE user-interface., _(*3)

The CSS files are installed via Yii's recommended usage of the fxp/composer-asset-plugin v1.1.1 or later., _(*4)

Installation

The preferred way to install this extension is through composer., _(*5)

To install AdminLTE v2 run:, _(*6)

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

Quick Start

Once the extension is installed, you can have a preview by reconfiguring the path mappings of the view component:, _(*7)

For Yii 2 Application Template or Basic Application Template, _(*8)

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

For Phundament 4, _(*9)

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

This asset bundle provides sample files for layout and view (see folder examples/), they are not meant to be customized directly in the vendor/ folder., _(*10)

Therefore it is recommended to copy the views into your application and adjust them to your needs., _(*11)

Customization

Copy files from vendor/gudezi/yii2-adminlte-asset/example-views/yiisoft/yii2-app (or other theme) to @app/views.
Remove the custom view configuration from your application by deleting the path mappings, if you have made them before.
Edit your views adhering to html markup vendor/gudezi/adminlte/pages

Skins

By default the extension uses blue skin for AdminLTE. You can change it in config file., _(*12)

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

And then just replace class of body skin-blue. You can use AdminLteHelper::skinClass() if you don't want to alter every view file when you change skin color., _(*13)

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

Note: Use AdminLteHelper::skinClass() only if you override the skin through configuration. Otherwise you will not get the correct css class of body., _(*14)

Here is the list of available skins:, _(*15)

"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"

If you want to use native DOM of headers AdminLTE, _(*16)

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

then you can follow the code:, _(*17)

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

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

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




     This is the About page. You may modify the following file to customize its content: , _(*18)
    = __FILE__ ?>

If you need to separate sections of the menu then just add the li.header item to items, _(*19)

    '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

To add a label for a item:, _(*20)

'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,
        ],