d4rkstar/yii2-remark-asset

Backend theme for Yii2 Framework

Remark Asset Bundle

Backend UI for Yii2 Framework, based on Remark, _(*1)

This package contains an Asset Bundle for Yii 2.0 Framework which registers the required JS and CSS files for the Remark theme., _(*2)

I've taken inspiration from AdminLTE Yii2 Extension, _(*3)

This extension is still work in progress, _(*4)

Installation

The preferred way to install this extension is through composer., _(*5)

To install Remark Asset run:, _(*6)

php composer.phar require d4rkstar/yii2-remark-asset "2.0.x-dev"

You've to unzip the contents of your remark theme inside the @webroot/remark folder. Check Aliases., _(*7)

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

• app/
  • web/
  • remark/
    • base/
    • global/
    • iconbar/
    • mmenu/
    • topbar/

Quick Start

Once the extension is installed, you can have a preview by reconfiguring the path mappings of the view component:, _(*9)

For Yii 2 Application Template or Basic Application Template, _(*10)

Edit your config/web.php and add:, _(*11)

'components' => [
    'view' => [
         'theme' => [
             'pathMap' => [
                '@app/views' => '@vendor/d4rkstar/yii2-remark-asset/views'
             ],
         ],
    ],
],

Then change these in your configuration:, _(*12)

'components' => [
    'assetManager' => [
         'bundles' => [
              'd4rkstar\web\RemarkAsset' => [
                'skin' => 'orange',
              ],
              'yii\web\JqueryAsset' => [
                'sourcePath' => null,
                'js' => [
                    '//ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js',
                ]
              ],
         ],
    ],
],

To speedup asset creation you may eventually you may use symlinking:, _(*13)

'components' => [
    'assetManager' => [
        'linkAssets' => true, // create symlinks
        'bundles' => [
            ...
         ],
    ],
],

You may add custom css / js for specific controller/action using the "addons" attribute., _(*14)

'components' => [
    'assetManager' => [
        'linkAssets' => true, // create symlinks
        'bundles' => [
            'd4rkstar\web\RemarkAsset' => [
                // 'skin' => 'orange',
                'addons'=>[
                    // SiteController, actionLogin
                    'site/login'=>[
                        'css'=>[
                            'base/assets/examples/css/pages/login-v3.css'
                        ],
                        'js'=>[
                            'global/js/components/material.js'
                        ]
                    ]
                ]
            ],
         ],
    ],
],

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., _(*15)

Therefore it is recommended to copy the views into your application and adjust them to your needs., _(*16)