raoul2000/yii2-bootswatch4-asset

Use Bootswatch theme compatible with Bootstrap 4, in your Yii2 application with minimum effort

4.3.1 2019-04-29 16:00 UTC

Requires

• thomaspark/bootswatch: 4.3.1
• yiisoft/yii2: *

Suggests

• yiisoft/yii2-bootstrap4: The official Yii 2 Bootstrap 4 Extension

BSD-3-Clause

• Raoul

• assets
• css
• theme
• extension
• yii2
• skin
• stlye
• bootstrap4
• bootswatch4

README

Asset bunlde around the Bootswatch Theme Suite based on bootstrap 4.

If you are using Bootstrap 3, please refer to the dedicated extension yii2-bootswatch-asset.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist raoul2000/yii2-bootswatch4-asset "*"

or add

"raoul2000/yii2-bootswatch4-asset": "*"

to the require section of your composer.json file.

Usage

Note that this asset bundle does NOT include Bootstrap 4 files, but only the Bootswatch CSS files dedicated to overload Bootstrap default theme. To use the Bootstrap 4 files with your Yii2 application, check the yii2-bootstrap4 extension.

To use a bootswatch theme in your Yii2 application add the BootswatchAsset bundle to your main AppAsset bundle:

// ./assets/AppAsset.php

class AppAsset extends AssetBundle
{
    public $basePath = '@webroot';
    public $baseUrl = '@web';
    public $css = [
        'css/site.css',
    ];
    public $js = [
    ];
    public $depends = [
        'yii\web\YiiAsset',
    	'raoul2000\bootswatch4\BootswatchAsset',
    ];
}
?>

Then at some point you must select the theme name you want to use. In the example below, the theme materia is set in the main layout file.

// ./views/layouts/main.php

raoul2000\bootswatch4\BootswatchAsset::$theme = 'materia';
AppAsset::register($this);

About Versioning

By convention this extension is using the same version number as the project thomaspark/bootswatch it depends on. Consequently, the first version of this extension is 4.3.1.

License

yii2-bootswatch4-asset is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.