Font Awesome Asset Bundle for Yii2 framework
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
LICENSE
README.md
composer.json

README.md

Font Awesome Extension for Yii 2


Font Awesome Asset Bundle for Yii2 framework

Latest Stable Version Latest Unstable Version License

This is the Font Awesome extension for Yii framework 2.0. It encapsulates Font Awesome distribution assets and thus makes using Font Awesome in Yii applications extremely easy.


INSTALLATION

The preferred install way is through Composer:

composer require yidas/yii2-fontawesome

Or you could edit composer.json with adding package in require section then run composer update.

"yidas/yii2-fontawesome": "~2.0.0"

CONFIGURATION

Register or depend Asset into your application:

yidas\yii\fontawesome\FontawesomeAsset

For eaxmple, to register Font Awesome assets in view :

\yidas\yii\fontawesome\FontawesomeAsset::register($this);

Or as dependency in your app asset bundle :

namespace app\assets;
use yii\web\AssetBundle;
class AppAsset extends AssetBundle
{
    public $basePath = '@webroot';
    public $baseUrl = '@web';
    public $css = [
        'css/site.css',
    ];
    public $js = [
    ];
    public $depends = [
        'yii\web\YiiAsset',
        'yii\bootstrap\BootstrapAsset',
        'yidas\yii\fontawesome\FontawesomeAsset',
    ];
}

CDN Asset Mode

You could switch Asset to use CDN distribution by configuring config file:

'components' => [
    'assetManager' => [
        'bundles' => [
            'yidas\yii\fontawesome\FontawesomeAsset' => [
                'cdn' => true,
                // 'cdnVersion' => '4.7.0',
            ],
        ],
    ],
],

Specify a CDN source

You could also specify CDN source you like:

'assetManager' => [
    'bundles' => [
        'yidas\yii\fontawesome\FontawesomeAsset' => [
            'cdn' => true,
            'cdnCSS' => ['//maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css'],
        ],
    ],
],

USAGE

Version Control

Update dependent packages

composer update yidas/yii2-fontawesome

Update newest Font-Awesome version

composer update fortawesome/font-awesome

Specify a Font-Awesome version

composer require fortawesome/font-awesome 4.7.0