kenjebaev/yii2-adminlte4

adminlte4 for yii2

dev-main 2024-06-14 19:06 UTC

Requires

• php: >=7.0
• almasaeed2010/adminlte: 4.0.0-beta1
• cinghie/yii2-fontawesome: ^1.4.4
• hail812/yii2-adminlte-widgets: ~1.0.2
• yiisoft/yii2-bootstrap5: 2.0.4

BSD-3-Clause

• kenjebaev

• extension
• yii2
• AdminLTE

README

adminlte4 for yii2

Installation

The preferred way to install this extension is through composer.

Either run

composer require "kenjebaev/yii2-adminlte4"

or add

"kenjebaev/yii2-adminlte4": "~1.0"

to the require section of your composer.json file.

Usage

Once the extension is installed, you can config the path mappings of the view component:

'components' => [
    'view' => [
         'theme' => [
             'pathMap' => [
                '@app/views' => '@vendor/kenjebaev/yii2-adminlte4/src/views'
             ],
         ],
    ],
],

Copy files from @vendor/kenjebaev/yii2-adminlte4/src/views to @app/views, then edit.

simply use:

<?= \kenjebaev\adminlte\widgets\Alert::widget([
    'type' => 'success',
    'body' => '<h3>Congratulations!</h3>'
]) ?>

more for widgets

AdminLTE Plugins

AdminLTE Plugins are not included in AdminLteAsset, if you want to use any of them you can add it dynamically with PluginAsset. For example:

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

\kenjebaev\adminlte4\assets\PluginAsset::register($this)->add('sweetalert2');

// or
\kenjebaev\adminlte4\assets\PluginAsset::register($this)->add(['sweetalert2', 'toastr']);

before this, maybe you should edit params.php:

return [
    'adminEmail' => '[e-mail]',
    'kenjebaev/yii2-adminlte4' => [
        'pluginMap' => [
            'sweetalert2' => [
                'css' => 'sweetalert2-theme-bootstrap-4/bootstrap-4.min.css',
                'js' => 'sweetalert2/sweetalert2.min.js'
            ],
            'toastr' => [
                'css' => ['toastr/toastr.min.css'],
                'js' => ['toastr/toastr.min.js']
            ],
        ]
    ]
];

or

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

$bundle = \kenjebaev\adminlte4\assets\PluginAsset::register($this);
$bundle->css[] = 'sweetalert2-theme-bootstrap-4/bootstrap-4.min.css';
$bundle->js[] = 'sweetalert2/sweetalert2.min.js';

Gii

Now you need to tell Gii about out template. The setting is made in the config file.

// config/main-local.php for advanced app
if (!YII_ENV_TEST) {
    $config['modules']['gii'] = [
        'class' => 'yii\gii\Module',
        'generators' => [ // here
            'crud' => [ // generator name
                'class' => 'yii\gii\generators\crud\Generator', // generator class
                'templates' => [ // setting for our templates
                    'yii2-adminlte4' => '@vendor/kenjebaev/yii2-adminlte4/src/gii/generators/crud/default' // template name => path to template
                ]
            ]
        ]
    ];
}

Open the CRUD generator and you will see that in the field Code Template of form appeared own template.