airani/yii2-adminlte-asset

Backend theme for Yii2 Framework (RTL)

2.0.7 2016-07-19 07:15 UTC

Requires

• airani/yii2-bootstrap-rtl: ~1.0
• bower-asset/adminlte_rtl: ~1.0
• cebe/yii2-gravatar: 1.*
• rmrevin/yii2-fontawesome: 2.9.*
• yiisoft/yii2: 2.*
• yiisoft/yii2-bootstrap: 2.*

BSD-3-Clause

• Tobias Munk
• Evgeniy Tkachenko
• Ali Irani

• extension
• yii2
• AdminLTE
• rtl
• adminlte-rtl

README

Backend UI for Yii2 Framework, based on AdminLTE RTL

This package contains an Asset Bundle for Yii 2.0 Framework which registers the CSS files for the AdminLTE (RTL Version) user-interface.

The CSS files are installed via Yii's recommended usage of the fxp/composer-asset-plugin.

Installation

The preferred way to install this extension is through composer.

To install AdminLTE v1 run:

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

Note!

AdminLTE v2 is currently in beta.

To install AdminLTE v2 run:

php composer.phar require airani/yii2-adminlte-asset "2.*@beta"

Quick Start

Once the extension is installed, you can have a preview by reconfiguring the path mappings of the view component:

For Yii 2 Advanced Application Template

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

For Yii 2 Basic Application Template

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

For Phundament 4

'components' => [
    'view' => [
        'theme' => [
            'pathMap' => [
                '@app/views' => '@vendor/airani/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/airani/yii2-adminlte-asset/example-views/yiisoft/yii2-advanced-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/bower/admin-lte-rtl/pages

By default the extension uses black skin for AdminLTE. You can change this. Just replace class of body skin-black to skin-blue. To fix all menu, add fixed class to body element.

Namespacing rules follow the Yii 2.0 framework structure, eg. airani\web for the Asset Bundle.