PHPackages                             rmrevin/yii2-fontawesome - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. rmrevin/yii2-fontawesome

ActiveYii2-extension[Utility & Helpers](/categories/utility)

rmrevin/yii2-fontawesome
========================

Asset Bundle for Yii2 with Font Awesome

3.7.0(5y ago)1474.0M↓12.2%49[4 issues](https://github.com/rmrevin/yii2-fontawesome/issues)[1 PRs](https://github.com/rmrevin/yii2-fontawesome/pulls)20MITPHPPHP >=5.4.0

Since Feb 27Pushed 2y ago15 watchersCompare

[ Source](https://github.com/rmrevin/yii2-fontawesome)[ Packagist](https://packagist.org/packages/rmrevin/yii2-fontawesome)[ RSS](/packages/rmrevin-yii2-fontawesome/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (62)Used By (20)

Yii 2 [Font Awesome](http://fortawesome.github.io/Font-Awesome/) Asset Bundle
=============================================================================

[](#yii-2-font-awesome-asset-bundle)

This extension provides a assets bundle with [Font Awesome](https://fontawesome.com/)for [Yii framework 2.0](http://www.yiiframework.com/) applications and helper to use icons.

For license information check the [LICENSE](https://github.com/rmrevin/yii2-fontawesome/blob/master/LICENSE)-file.

[![License](https://camo.githubusercontent.com/7688a06a560f3527002c704479603ed881eb9f7e5e60f3f370cd9820bb229ce0/68747470733a2f2f706f7365722e707567782e6f72672f726d726576696e2f796969322d666f6e74617765736f6d652f6c6963656e73652e737667)](https://packagist.org/packages/rmrevin/yii2-fontawesome)[![Latest Stable Version](https://camo.githubusercontent.com/871110b885a33a38f9f55d87759d3e0dbd462ef1b6de0160e9e4c385c16c7b42/68747470733a2f2f706f7365722e707567782e6f72672f726d726576696e2f796969322d666f6e74617765736f6d652f762f737461626c652e737667)](https://packagist.org/packages/rmrevin/yii2-fontawesome)[![Latest Unstable Version](https://camo.githubusercontent.com/59c1d1cdc58c1ba399829679ae8dad499f9ebc020c7ab0994dbf2007c27038d0/68747470733a2f2f706f7365722e707567782e6f72672f726d726576696e2f796969322d666f6e74617765736f6d652f762f756e737461626c652e737667)](https://packagist.org/packages/rmrevin/yii2-fontawesome)[![Total Downloads](https://camo.githubusercontent.com/8e77690f28ae570e92685f789b9ab95fa0ea8cd2335db17eccd2a65d50c72e50/68747470733a2f2f706f7365722e707567782e6f72672f726d726576696e2f796969322d666f6e74617765736f6d652f646f776e6c6f6164732e737667)](https://packagist.org/packages/rmrevin/yii2-fontawesome)

Code Status
-----------

[](#code-status)

[![Scrutinizer Code Quality](https://camo.githubusercontent.com/4ac4d44552fea98006937b3e391344e067b10e2af0e81f9ba257a686ba54dfb4/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f726d726576696e2f796969322d666f6e74617765736f6d652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/rmrevin/yii2-fontawesome/?branch=master)[![Code Coverage](https://camo.githubusercontent.com/11e0cabc2f2a1b887d9dc39323f8e43e192228b8f12f3f76f911f9cf360b3508/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f726d726576696e2f796969322d666f6e74617765736f6d652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/rmrevin/yii2-fontawesome/?branch=master)[![Travis CI Build Status](https://camo.githubusercontent.com/3a451c32e98fee2b4c4ff0d98f42c0d51d53bc1cac6e071eb3f9e548e6236811/68747470733a2f2f7472617669732d63692e6f72672f726d726576696e2f796969322d666f6e74617765736f6d652e737667)](https://travis-ci.org/rmrevin/yii2-fontawesome)[![Dependency Status](https://camo.githubusercontent.com/5d4592a0e2cadbfa88b0136b01f3feb77e64418592af448757bf61d5ee8538bb/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f757365722f70726f6a656374732f3534313139623739396531363232396665303030303064612f62616467652e737667)](https://www.versioneye.com/user/projects/54119b799e16229fe00000da)

Support
-------

[](#support)

- [GutHub issues](https://github.com/rmrevin/yii2-fontawesome/issues)
- [Public chat](https://gitter.im/rmrevin/support)

Fontawesome version
-------------------

[](#fontawesome-version)

Version of font-awesomeVersion of extension4.\*~2.175.\*~3.0Update to `3.2`
---------------

[](#update-to-32)

Be careful in version 3.2 `rmrevin\yii\fontawesome\AssetBundle` package use cdn by default. More in the [changelog](https://github.com/rmrevin/yii2-fontawesome/blob/master/CHANGELOG.md).

Update to `3.0`
---------------

[](#update-to-30)

Be careful in version 3.0 deprecated methods were removed. More in the [changelog](https://github.com/rmrevin/yii2-fontawesome/blob/master/CHANGELOG.md).

Update to `2.17`
----------------

[](#update-to-217)

Be careful in version 2.17 deprecated methods were removed. More in the [changelog](https://github.com/rmrevin/yii2-fontawesome/blob/2.x/CHANGELOG.md).

Installation
------------

[](#installation)

The preferred way to install this extension is through [composer](https://getcomposer.org/).

Either run

```
composer require "rmrevin/yii2-fontawesome:~3.5"
```

or add

```
"rmrevin/yii2-fontawesome": "~3.5",

```

to the `require` section of your `composer.json` file.

Usage with fa pro version
-------------------------

[](#usage-with-fa-pro-version)

### CDN

[](#cdn)

Register your domain here -

Add `CdnProAssetBundle` as depends of your app asset bundle:

```
class AppAsset extends AssetBundle
{
	// ...

	public $depends = [
		// ...
		'rmrevin\yii\fontawesome\CdnProAssetBundle'
	];
}
```

Or inject `CdnProAssetBundle` in your view:

```
\rmrevin\yii\fontawesome\CdnProAssetBundle::register($this);
```

### NPM

[](#npm)

Install npm package of font:

```
npm install @fortawesome/fontawesome-pro

```

or

```
yarn add @fortawesome/fontawesome-pro

```

And add `NpmProAssetBundle` as depends of your app asset bundle:

```
class AppAsset extends AssetBundle
{
	// ...

	public $depends = [
		// ...
		'rmrevin\yii\fontawesome\NpmProAssetBundle'
	];
}
```

Or inject `NpmProAssetBundle` in your view:

```
rmrevin\yii\fontawesome\NpmProAssetBundle::register($this);
```

### Optional

[](#optional)

In order for do not install the free version of the font-awesome package, you can add it to the `replace` section of `composer.json`.

```
  "replace": {
    "fortawesome/font-awesome": "*"
  },

```

Usage with fa free version
--------------------------

[](#usage-with-fa-free-version)

### CDN

[](#cdn-1)

Add `CdnFreeAssetBundle` as depends of your app asset bundle:

```
class AppAsset extends AssetBundle
{
	// ...

	public $depends = [
		// ...
		'rmrevin\yii\fontawesome\CdnFreeAssetBundle'
	];
}
```

Or inject `CdnFreeAssetBundle` in your view:

```
rmrevin\yii\fontawesome\CdnFreeAssetBundle::register($this);
```

Composer
========

[](#composer)

Free version of package `fortawesome/font-awesome` already installed in vendor.

Add `NpmFreeAssetBundle` as depends of your app asset bundle:

```
class AppAsset extends AssetBundle
{
	// ...

	public $depends = [
		// ...
		'rmrevin\yii\fontawesome\NpmFreeAssetBundle'
	];
}
```

Or inject `NpmFreeAssetBundle` in your view:

```
rmrevin\yii\fontawesome\NpmFreeAssetBundle::register($this);
```

Class reference
---------------

[](#class-reference)

Namespace: `rmrevin\yii\fontawesome`;

### Class `FAB`, `FAL`, `FAR`, `FAS` or `FontAwesome`

[](#class-fab-fal-far-fas-or-fontawesome)

- `static FAR::icon($name, $options=[])` - Creates an [`component\Icon`](#class-componenticon) that can be used to FontAwesome html icon
    - `$name` - name of icon in font awesome set.
    - `$options` - additional attributes for `i.fa` html tag.
- `static FAR::stack($name, $options=[])` - Creates an [`component\Stack`](#class-componentstack) that can be used to FontAwesome html icon
    - `$options` - additional attributes for `span.fa-stack` html tag.

### Class `component\Icon`

[](#class-componenticon)

- `(string)$Icon` - render icon
- `$Icon->addCssClass($value)` - add to html tag css class in `$value`
    - `$value` - name of css class
- `$Icon->inverse()` - add to html tag css class `fa-inverse`
- `$Icon->spin()` - add to html tag css class `fa-spin`
- `$Icon->fixedWidth()` - add to html tag css class `fa-fw`
- `$Icon->ul()` - add to html tag css class `fa-ul`
- `$Icon->li()` - add to html tag css class `fa-li`
- `$Icon->border()` - add to html tag css class `fa-border`
- `$Icon->pullLeft()` - add to html tag css class `pull-left`
- `$Icon->pullRight()` - add to html tag css class `pull-right`
- `$Icon->size($value)` - add to html tag css class with size
    - `$value` - size value (variants: `FA::SIZE_LARGE`, `FA::SIZE_2X`, `FA::SIZE_3X`, `FA::SIZE_4X`, `FA::SIZE_5X`)
- `$Icon->rotate($value)` - add to html tag css class with rotate
    - `$value` - rotate value (variants: `FA::ROTATE_90`, `FA::ROTATE_180`, `FA::ROTATE_270`)
- `$Icon->flip($value)` - add to html tag css class with rotate
    - `$value` - flip value (variants: `FA::FLIP_HORIZONTAL`, `FA::FLIP_VERTICAL`)

### Class `component\Stack`

[](#class-componentstack)

- `(string)$Stack` - render icon stack
- `$Stack->icon($icon, $options=[])` - set icon for stack
    - `$icon` - name of icon or `component\Icon` object
    - `$options` - additional attributes for icon html tag.
- `$Stack->icon($icon, $options=[])` - set background icon for stack
    - `$icon` - name of icon or `component\Icon` object
    - `$options` - additional attributes for icon html tag.

Helper examples
---------------

[](#helper-examples)

```
use rmrevin\yii\fontawesome\FAS;
// or (only in pro version https://fontawesome.com/pro)
// use rmrevin\yii\fontawesome\FAR;
// use rmrevin\yii\fontawesome\FAL;
// use rmrevin\yii\fontawesome\FAB;

// normal use
echo FAS::icon('home'); //

// shortcut
echo FAS::i('home'); //

// icon with additional attributes
echo FAS::icon(
    'arrow-left',
    ['class' => 'big', 'data-role' => 'arrow']
); //

// icon in button
echo Html::submitButton(
    Yii::t('app', '{icon} Save', ['icon' => FAS::icon('check')])
); //  Save

// icon with additional methods
echo FAS::icon('cog')->inverse();    //
echo FAS::icon('cog')->spin();       //
echo FAS::icon('cog')->fixedWidth(); //
echo FAS::icon('cog')->li();         //
echo FAS::icon('cog')->border();     //
echo FAS::icon('cog')->pullLeft();   //
echo FAS::icon('cog')->pullRight();  //

// icon size
echo FAS::icon('cog')->size(FAS::SIZE_3X);
// values: FAS::SIZE_LARGE, FAS::SIZE_2X, FAS::SIZE_3X, FAS::SIZE_4X, FAS::SIZE_5X
//

// icon rotate
echo FAS::icon('cog')->rotate(FAS::ROTATE_90);
// values: FAS::ROTATE_90, FAS::ROTATE_180, FAS::ROTATE_180
//

// icon flip
echo FAS::icon('cog')->flip(FAS::FLIP_VERTICAL);
// values: FAS::FLIP_HORIZONTAL, FAS::FLIP_VERTICAL
//

// icon with multiple methods
echo FAS::icon('cog')
        ->spin()
        ->fixedWidth()
        ->pullLeft()
        ->size(FAS::SIZE_LARGE);
//

// icons stack
echo FAS::stack()
        ->icon('twitter')
        ->on('square-o');
//
//
//
//

// icons stack with additional attributes
echo FAS::stack(['data-role' => 'stacked-icon'])
     ->on(FAS::Icon('square')->inverse())
     ->icon(FAS::Icon('cog')->spin());
//
//
//
//

// Stacking text and icons
echo FAS::stack()
     ->on(FAS::Icon('square'))
     ->text('1');
//
//
//   1
//

// Stacking text and icons with options
echo FAS::stack()
     ->on(FAS::Icon('square'))
     ->text('1', ['tag'=>'strong', 'class'=>'stacked-text']);
//
//
//   1
//
// Now you can add some css for vertical text positioning:
.stacked-text { margin-top: .3em; }

// unordered list icons
echo FAS::ul(['data-role' => 'unordered-list'])
     ->item('Bullet item', ['icon' => 'circle'])
     ->item('Checked item', ['icon' => 'check']);
//
//   Bullet item
//   Checked Item
//

// autocomplete icons name in IDE
echo FAS::icon(FAS::_COG);
echo FAS::icon(FAS::_DESKTOP);
echo FAS::stack()
     ->on(FAS::_CIRCLE_O)
     ->icon(FAS::_TWITTER);
```

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity60

Solid adoption and visibility

Community44

Growing community involvement

Maturity72

Established project with proven stability

 Bus Factor1

Top contributor holds 90.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~43 days

Recently: every ~175 days

Total

59

Last Release

1951d ago

Major Versions

1.2.1 → 2.0.02014-06-05

2.x-dev → 3.0.02018-04-01

PHP version history (2 changes)2.6.1PHP >=5.4.0

2.17.0PHP >=5.5.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/1ed2a8c869410bcc2f79245fe77cf156db86c83fed1c60c3dea8df1e04966788?d=identicon)[rmrevin](/maintainers/rmrevin)

---

Top Contributors

[![rmrevin](https://avatars.githubusercontent.com/u/803507?v=4)](https://github.com/rmrevin "rmrevin (181 commits)")[![loveorigami](https://avatars.githubusercontent.com/u/98164?v=4)](https://github.com/loveorigami "loveorigami (4 commits)")[![albertborsos](https://avatars.githubusercontent.com/u/7307145?v=4)](https://github.com/albertborsos "albertborsos (2 commits)")[![f1amy](https://avatars.githubusercontent.com/u/27062841?v=4)](https://github.com/f1amy "f1amy (2 commits)")[![haqqi](https://avatars.githubusercontent.com/u/831763?v=4)](https://github.com/haqqi "haqqi (1 commits)")[![Isitar](https://avatars.githubusercontent.com/u/16210003?v=4)](https://github.com/Isitar "Isitar (1 commits)")[![makroxyz](https://avatars.githubusercontent.com/u/2069949?v=4)](https://github.com/makroxyz "makroxyz (1 commits)")[![marc7000](https://avatars.githubusercontent.com/u/1118837?v=4)](https://github.com/marc7000 "marc7000 (1 commits)")[![mauriziocingolani](https://avatars.githubusercontent.com/u/4015015?v=4)](https://github.com/mauriziocingolani "mauriziocingolani (1 commits)")[![mervick](https://avatars.githubusercontent.com/u/2429298?v=4)](https://github.com/mervick "mervick (1 commits)")[![oudingfan](https://avatars.githubusercontent.com/u/2810552?v=4)](https://github.com/oudingfan "oudingfan (1 commits)")[![prawee](https://avatars.githubusercontent.com/u/3203937?v=4)](https://github.com/prawee "prawee (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![Arnaud-G1](https://avatars.githubusercontent.com/u/8536657?v=4)](https://github.com/Arnaud-G1 "Arnaud-G1 (1 commits)")[![Faryshta](https://avatars.githubusercontent.com/u/2029247?v=4)](https://github.com/Faryshta "Faryshta (1 commits)")

---

Tags

assetscssfontfontawesomeiconsphpbundleyiiassetfontawesome

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rmrevin-yii2-fontawesome/health.svg)

```
[![Health](https://phpackages.com/badges/rmrevin-yii2-fontawesome/health.svg)](https://phpackages.com/packages/rmrevin-yii2-fontawesome)
```

###  Alternatives

[nizsheanez/yii2-asset-converter

Less, Sass, Scss and Phamlp converter for Yii2. No system requires. yii2-composer support, Less autoupdate, customizing of output directory

64167.5k6](/packages/nizsheanez-yii2-asset-converter)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)