AdminLTE Asset Bundle
Backend UI for Yii2 Framework, based on AdminLTE
This package contains an Asset Bundle for Yii 2.0 Framework which registers the CSS files for the AdminLTE user-interface.
The CSS files are installed via Yii's recommended usage of the fxp/composer-asset-plugin
v1.1.1 or later.
Installation
The preferred way to install this extension is through composer.
To install AdminLTE v2 run:
php composer.phar require dmstr/yii2-adminlte-asset "2.*"
To install AdminLTE v1 run:
php composer.phar require dmstr/yii2-adminlte-asset "1.*"
Quick Start
Once the extension is installed, you can have a preview by reconfiguring the path mappings of the view component:
For Yii 2 Application Template or Basic Application Template
'components' => [
'view' => [
'theme' => [
'pathMap' => [
'@app/views' => '@vendor/dmstr/yii2-adminlte-asset/example-views/yiisoft/yii2-app'
],
],
],
],
For Phundament 4
'components' => [
'view' => [
'theme' => [
'pathMap' => [
'@app/views' => '@vendor/dmstr/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.
Therefore it is recommended to copy the views into your application and adjust them to your needs.
Customization
- Copy files from
vendor/dmstr/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/almasaeed2010/adminlte/pages
Skins
By default the extension uses blue skin for AdminLTE. You can change it in config file.
'components' => [
'assetManager' => [
'bundles' => [
'dmstr\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.
<body class="<?= \dmstr\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.
Here is the list of available skins:
"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
<h1>
About <small>static page</small>
</h1>
then you can follow the code:
/* @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>
Further Information
For AdminLTE documentation, please read https://almsaeedstudio.com/themes/AdminLTE/documentation/index.html
Namespacing rules follow the Yii 2.0 framework structure, eg.
dmstr\web
for the Asset Bundle.