p2made/yii2-startbootstrap-themes

Themes from Start Bootstrap, http://startbootstrap.com/, as UIs for Yii 2 Framework.

P2 Start Bootstrap Themes 5.0.0

, _(*1)

Themes from Start Bootstrap as a UIs for Yii 2 Framework., _(*2)

These themes contain AssetBundles, Views, and Widgets to render the Start Bootstrap themes as Yii 2 themes., _(*3)

P2 Start Bootstrap Themes declares p2made/yii2-p2y2-things and p2made/yii2-p2y2-things-demo as dependancies., _(*4)

¡¡ IMPORTANT !!

Version 2.0.0 of all my Yii2 add-ons marks a breaking change where I've shortened my namespaces. p2made\rest\of\namespace is now p2m\rest\of\namespace., _(*5)

Installation

The preferred way to install P2 Start Bootstrap Themes is through composer. Depending on your composer installation, run one of the following commands:, _(*6)

composer require --prefer-dist p2made/p2y2-startbootstrap-themes "^5.0"

or, _(*7)

php composer.phar require --prefer-dist p2made/p2y2-startbootstrap-themes "^5.0"

Alternatively add:, _(*8)

        "p2made/p2y2-startbootstrap-themes": "^5.0"

to the requires section of your composer.json file & P2 Start Bootstrap Themes will be installed next time you run composer update., _(*9)

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

Quick Start

Once the extension is installed, you can have a preview by reconfiguring the path mappings of the view component with one of @app/views lines:, _(*11)

    'components' => [
        'view' => [
            'theme' => [
                'pathMap' => [
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/agency',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/business-casual',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/business-frontpage',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/creative',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/freelancer',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/grayscale',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/heroic-features',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/landing-page',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/modern-business',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/new-age',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/one-page-wonder',
                    '@app/views' => '@vendor/p2made/p2y2-startbootstrap-themes/views/stylish-portfolio',
                ],
            ],
        ],
    ],

This asset bundle provides sample files for layout and view (see folder 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., _(*12)

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

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

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

P2 Start Bootstrap Themes uses P2Y2Things which requires some Yii 2 assets to be nullified to avoid conflicts through double loading. Modify common/config/main.php with..., _(*15)

    '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/p2y2-startbootstrap-themes/views-preview/_your_choice_of_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 the example views.