p2made/yii2-flat-theme

Flat Theme from ShapeBootstrap, http://shapebootstrap.net, as a frontend UI for Yii 2 Framework.

P2Flat Theme v0.5.2-beta

, _(*1)

--, _(*2)

Flat Theme from ShapeBootstrap as a frontend UI for Yii 2 Framework., _(*3)

Flat Theme contains AssetBundles for Yii 2.0 Framework which registers the CSS & JS files for the SB Admin 2 UI., _(*4)

It declares p2made/yii2-asset-collection as a dependancy., _(*5)

¡¡¡ On Hold !!!

Updates in the dependencies to the original appear to have broken some elememts & it's a right mess for which I don't immediately have time., _(*6)

Installation

The preferred way to install Flat Theme is through composer. Depending on your composer installation, run one of the following commands:, _(*7)

composer require p2made/yii2-flat-theme "^0.5"

or, _(*8)

php composer.phar require p2made/yii2-flat-theme "^0.5"

Alternatively add:, _(*9)

"p2made/yii2-flat-theme": "^0.5"

to the requires section of your composer.json file & p2y2bootstrapSocialAsset will be installed next time you run composer update., _(*10)

The files are installed via Yii's recommended usage of the fxp/composer-asset-plugin., _(*11)

Quick Start

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

    'components' => [
        'view' => [
            'theme' => [
                'pathMap' => [
                    '@app/views' => '@vendor/p2made/yii2-flat-theme/example-views/flat'
                ],
            ],
        ],
    ],

This asset bundle provides sample files for layout and view (see folder example-views/), they are not meant to be customized directly in the vendor/ folder. If you do that, your changes will be lost next time you run composer update., _(*13)

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

To view the sample pages in site/pages/ you need to modify actions() in the SiteController:, _(*15)

public function actions()
{
    return [
        ...
        'page' => [
            'class' => 'yii\web\ViewAction',
        ],
    ];
}

And then...

P2Flat Theme uses P2Y2Things which requires some Yii 2 assets to be nullified to avoid conflicts through double loading. Modify common/config/main.php with..., _(*16)

    'components' => [
        'assetManager' => [
            'bundles' => [
                'yii\web\JqueryAsset' => [
                    'sourcePath' => null, 'js' => [],
                ],
                'yii\bootstrap\BootstrapAsset' => [
                    'sourcePath' => null, 'css' => [],
                ],
                'yii\bootstrap\BootstrapPluginAsset' => [
                    'sourcePath' => null, 'js' => [],
                ],
                'yii\jui\JuiAsset' => [
                    'sourcePath' => null, 'css' => [], 'js' => [],
                ],
                '\rmrevin\yii\fontawesome\AssetBundle' => [
                    'sourcePath' => null, 'css' => [],
                ],
            ],
        ],
        ...
    ],

Customization

• Copy files from vendor/p2made/yii2-flat-theme/example-views/flat (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 http://shapebootstrap.net/item/flat-theme-free-responsive-multipurpose-site-template/ & the example views.

Known Issues

• sample pages in site/pages/ return a 403 error when viewed in the Y11 2 Advanced backend.

I've not been able to resolve this. It may be an issue on my development machine., _(*17)

To Do