yii2-metronic

Yii2 Metronic theme integration. Currently is supported the version 4.6, _(*1)

Installation

The extension is in development and the only way to use this fork is through through composer., _(*2)

So add it to your composer.json with this composer command:, _(*3)

php composer.phar require sxlxnyw/yii2-metronic dev-master

Then You've to unzip the contents of your metronic Zip theme inside the @webroot/metronic folder. Check Aliases., _(*4)

You should have a folder structure like this:, _(*5)

app/
- web/
  - metronic/
    - _documentation
    - _resources
    - _start
    - theme
    - theme_rtl

Quick Start

Edit your config/web.php configuration file and add the metronic component:, _(*6)

'components' => [
    'metronic'=>[
        'class'=>'sxlxnyw\metronic\Metronic',
        'resources'=>'[path to my web]/web/metronic/assets/theme/assets',
        'style'=>\sxlxnyw\metronic\Metronic::STYLE_MATERIAL,
        'theme'=>\sxlxnyw\metronic\Metronic::THEME_LIGHT,
        'layoutOption'=>\sxlxnyw\metronic\Metronic::LAYOUT_FLUID,
        'headerOption'=>\sxlxnyw\metronic\Metronic::HEADER_FIXED,
        'sidebarPosition'=>\sxlxnyw\metronic\Metronic::SIDEBAR_POSITION_LEFT,
        'sidebarOption'=>\sxlxnyw\metronic\Metronic::SIDEBAR_MENU_ACCORDION,
        'footerOption'=>\sxlxnyw\metronic\Metronic::FOOTER_FIXED,

    ],
]

WARNING Check the "resources" key. This component field is used to locate the content of the zip theme. The component try to create a symlink to this directory inside it's folder. Eventually this may not work! In the case the link is invalid, you've to build it by yourself :), _(*7)

My vendor folder looks like this:, _(*8)

app/
- [...]
- vendor/
  - sxlxnyw/
    - yii2-metronic/
      - assets -> symlink to /var/www/project/web/metronic/assets/theme/assets
      - builders/
      - bundles/
      - helpers/
      - layouts/
      - widgets/

I suggest also to configure the assetManager. My actual configuration is this:, _(*9)

'assetManager' => [
        'linkAssets' => true,
        'bundles' => [
            'yii\web\JqueryAsset' => [
                'sourcePath' => null,   // do not publish the bundle
                'js' => [
                    '//code.jquery.com/jquery-1.11.2.min.js',  // use custom jquery
                ]
            ],

            'sxlxnyw\metronic\bundles\ThemeAsset' => [
                'addons'=>[
                    'default/login'=>[
                        'css'=>[
                            'pages/css/login-4.min.css',
                        ],
                        'js'=>[
                            'global/plugins/backstretch/jquery.backstretch.min.js',

                        ]
                    ],
                ]
            ],
        ],
    ],

In the ThemeAsset class i've added the support for addons. You can specify additional css/js for specific controller/action., _(*10)

In the example is visible the way to add login-4.min.css and jquery.backstretch.min.js to the login page (in my case, the actionLogin is managed by a controller named DefaultController)., _(*11)

Configuring the layout for your views is the last step., _(*12)

The metronic component contains a sample layout view. I've not checked it. I'm working on my layout :), _(*13)

Here is my sample views/layout/main.php:, _(*14)

assetManager->getPublishedUrl($asset->sourcePath);
?>
beginPage() ?>



<!DOCTYPE html>
<html lang="<?= Yii::$app->language ?>">

<head>
    <meta charset="<?= Yii::$app->charset ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <?= Html::csrfMetaTags() ?>
    <title><?= Html::encode($this->title) ?></title>
    <?php $this->head() ?>
</head>
<body <?= Layout::getHtmlOptions('body',['class'=>'page-container-bg-solid'],true) ?>>
beginBody() ?>

= $this->render('parts/header.php', ['directoryAsset' => $directoryAsset]) ?>





= $this->render('parts/sidebar.php', ['directoryAsset' => $directoryAsset]) ?>

= $this->render('parts/content.php', ['content' => $content, 'directoryAsset' => $directoryAsset]) ?>



= $this->render('parts/footer.php', ['directoryAsset' => $directoryAsset]) ?>

endBody() ?>

</body>
</html>
endPage() ?>

Metronic theme require that you replace yii\helpers\Html with it's helper. So, you have to add a config/bootstrap.php with the following content:, _(*15)

<?php
Yii::$classMap['yii\helpers\Html'] = '@vendor/sxlxnyw/yii2-metronic/helpers/Html.php';
?>

The file bootstrap.php should be loaded before the web application is created. So you need to edit your web/index.php file and adjust it, and add a require directive. The file content should look like this:, _(*16)

<?php

// comment out the following two lines when deployed to production
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');

require(__DIR__ . '/../vendor/autoload.php');
require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

$config = require(__DIR__ . '/../config/web.php');
require(__DIR__ . '/../config/bootstrap.php');
(new yii\web\Application($config))->run();

Things to notice:, _(*17)

I've moved the rendering of the main parts to separate files (parts/*). You can build this files and add them to your project.
I pass everywhere the $directoryAsset variable: this contain the path to the assets. Useful to load images bundled with the metronic theme.
the BODY tag is managed with a Layout::getHtmlOptions(). This method is able to build all the Metronic required classes.
Always check to use $this->beginPage(), $this->beginBody() and relatives $this->endBody() and $this->endPage() in the proper places :)

08/11 2016

dev-master

9999999-dev

Yii2 Metronic theme integration

Sources Download

BSD

The Requires

by Jiri Svoboda

yii2 theme metronic

yii2-extension yii2-metronic