yii2-bootswatch-asset

Yii Framework Extensions

Popular Tags

yii2-bootswatch-asset Brings Bootswatch to Yii2

Installation
Usage
Resources
Changes

Ever wanted a nice design based on Bootstrap for your web pages ? .. and of course, with minimal effort ?

Well, yii2-bootswatch-asset is just what you need, an Asset bunlde around the Bootswatch theme suite. Visit Bootswatch for more.

Installation ¶

The preferred way to install this extension is through composer.

Either run

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

or add

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

to the require section of your composer.json file.

Usage ¶

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 $depends = [
        'yii\web\YiiAsset',
        // let's add the BootswatchAsset here
    	'raoul2000\bootswatch\BootswatchAsset',
    ];
}
?>

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

// ./views/layouts/main.php

raoul2000\bootswatch\BootswatchAsset::$theme = 'cosmo';
AppAsset::register($this);

For more information on the plugin options, please refer to yii2-bootswatch-asset@github.

Resources ¶

Changes ¶

version 1.2.7 ¶

update to bootswatch 3.3.7

version 1.2.6 ¶

update to bootswatch 3.3.6+1

version 1.2.5 ¶

update dependency : thomaspark/bootswatch version 3.3.5+2. This is to avoid the Failed to decode downloaded font error message (see https://github.com/raoul2000/yii2-bootswatch-asset/issues/5)

version 1.2.4 ¶

update to bootswatch 3.3.5

version 1.2.3 ¶

update to bootswatch 3.3.4

version 1.2.2 ¶

fix : publish woff2 font "glyphicons-halflings-regular.woff2" (thanks to jwerner)

version 1.2.1 ¶

update dependency : thomaspark/bootswatch version 3.3.2 after bootstrap 3.3.2 has been release

version 1.2.0 ¶

update dependency : thomaspark/bootswatch version 3.3.1 in order to include latest bootswatch themes (journal, sandstone).

version 1.1.1 ¶

-fix : minified CSS was not correctly handled. Now, if YII_ENV_DEV is defined bootstrap.css is published, otherwise bootstrap.min.css is used

version 1.1.0 ¶

fix : gylphicons not accessible.
enh : optimize publication process. When no theme is set, no publication is performed.
enh : no theme is selected by default.

version 0.0.0 ¶

Initial release

6 0

12 followers

0 downloads

Yii Version: 2.0

License: BSD-2-Clause

Category: User Interface

Tags: asset, bootstrap, bootswatch, theme, user interface, yii2

Developed by: Raoul

Created on: Sep 29, 2014

Last updated: 8 years ago

Related Extensions

User Contributed Notes 13

#18233

0 0

Minimum stability

Be sure to change the asterisk to dev-master if your minimum stability is set to a higher value.

EDIT:

raoul2000\bootswatch\BootswatchAsset::$theme = 'amelia';

dastiii at Oct 3, 2014, 9:56:14 AM

#18246

0 0

@dastiii

Hi Dastiii,

I'm not very familiar with composer, so I'm not sure to understand what you mean by "minimum stability".

What is the difference between * and 'dev-master' in terms of "stability" ?

Raoul at Oct 7, 2014, 7:58:59 AM

#18255

0 0

@Raoul

Shouldn't be a problem anymore since there is a 1.1.0 version now. Previously there only was a 'dev-master' version.

If you had your minimum stability in your composer.json set to anything else than 'dev' then composer couldn't find a matching version when using an asterisk. That's because it searches for the latest version with a stability that equals at least your 'minimum stability' setting.

In those cases you have to specify an explicit version, thats why I had to change the asterisk to dev-master (minimum stability of my composer.json was beta).

dastiii at Oct 7, 2014, 10:02:30 PM

#18268

0 0

@dastiii

ok I understand now. Thanks for the explanation.

By the way, the version 1.1.0 fixed an issue with the glyphicons that were not correctly published.

ciao

Raoul at Oct 8, 2014, 9:01:08 PM

#18870

0 0

@Raoul

Hi,
I cannot access glyphicons. I changed from '*' to 'dev-master' to '>=1.2.0' to '1.2.0' and finally '1.1.0'.

Could you please tell me how I can reference glyphicons with raoul2000/yii2-bootswatch-asset ?

Thanx in advance.

P.S. I'm referencing them like below:-

[
                    'label' => Yii::$app->user->identity->username,
                    'url' => '#',
                    'template' => '<a href="{url}" class="dropdown-toggle" data-toggle="dropdown"><i class="glyphicon glyphicon-user"></i> {label} <i class="icon-angle-down"></i></a>',
                    'visible' => !Yii::$app->user->isGuest
]

The 'icon-angle-down' works fine. Just not glyphicons.

gittinOld at Jan 27, 2015, 5:39:54 AM

#18872

0 0

Missing woff2 File in assets Folder

Thanks for this extension!

In the generated assets/.../fonts folder, the file glyphicons-halflings-regular.woff2 is missing.

Adding woff2 to line 54 in the file BootswatchAsset.php seems to fix it:

return in_array($ext,['css','eot','svg','ttf','woff','woff2']);

Maybe also clear the web/assets folder...

Regards,
Joachim

jwerner at Jan 27, 2015, 4:02:10 PM

#18877

0 0

@jweneer and @gittinold

Hi guys,

@jweneer: Good catch ! ... Thanks, I'll implement your modification and release a new version (soon)

@gittinold: that's strange .. since 1.1.0 glyphicons are published correctly. Can you try to empty your app/web/assets folder so it gets re-published again ?

ciao

Raoul at Jan 28, 2015, 10:52:06 AM

#18893

0 0

@gittinOld

Hi,

according to this anwser you should try with "glyphicon-chevron-down".

Raoul at Jan 31, 2015, 4:42:27 PM

#18894

0 0

@jwerner

Hi,

I have release version 1.2.2 that does publish the woff2 fonts ;)

Thanks for your help

Raoul at Jan 31, 2015, 5:11:48 PM

#19372

0 0

thanks

works very well. thanks for this extension

nguyendh at Jun 5, 2015, 9:46:24 PM

#20497

0 0

Thanks,
easy to install and works very well.
When we get the Bootswatch4 included version?

MilaSuperstar84 at Apr 15, 2019, 10:42:40 AM

#20510

0 0

thanks for your comment
... and regarding the Bootswatch4 version, I'll try to do it as soon as possible, promise !

Raoul at Apr 19, 2019, 5:33:12 PM

#20518

0 0

please note that the yii2-bootswatch4-asset extension is now available.

Hope it helps...

Raoul at Apr 29, 2019, 4:30:57 PM

Categories

Popular Tags