amintado/yii2-adminlte-asset

Backend theme for Yii2 Framework (RTL)

Installs: 4

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 429

Type:yii2-extension

2.0.7 2016-07-19 07:15 UTC

README

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 amintado/yii2-adminlte-asset "1.*"

Note!

AdminLTE v2 is currently in beta.

To install AdminLTE v2 run:

php composer.phar require amintado/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/amintado/yii2-adminlte-asset/example-views/yiisoft/yii2-advanced-app'
             ],
         ],
    ],
],    
     ]

For Yii 2 Basic Application Template

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

For Phundament 4

'components' => [
    'view' => [
        'theme' => [
            'pathMap' => [
                '@app/views' => '@vendor/amintado/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. amintado\web for the Asset Bundle.