PHPackages                             sjaakp/yii2-symbol-picker - 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 &amp; Helpers](/categories/utility)
4. /
5. sjaakp/yii2-symbol-picker

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

sjaakp/yii2-symbol-picker
=========================

Widget to select Font Awesome symbol for Yii2.

0.9.0(7y ago)610.6k↓50%21MITPHP

Since Jan 1Pushed 6y ago1 watchersCompare

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

READMEChangelog (1)Dependencies (1)Versions (2)Used By (1)

Yii2 Symbol Picker
==================

[](#yii2-symbol-picker)

#### Widget to select a symbol from the Font Awesome collection for Yii 2.0 PHP Framework.

[](#widget-to-select-a-symbol-from-the-font-awesome-collection-for-yii-20-php-framework)

**SymbolPicker** lets you select the class name for a symbol in [Font Awesome](http://fontawesome.io/) (up to version 4.3). It also lets you select class names for a color and for an additional effect.

A demonstration of SymbolPicker widget is [here](http://www.sjaakpriester.nl/software/symbolpicker).

Prerequisite
------------

[](#prerequisite)

**SymbolPicker** only makes sense if Font Awesome is loaded in your site. The easiest way to achieve this, is to add a line to the `css` property of the site's `AppAsset.php` file (look into the `assets` directory), like so:

```

```

There are [other methods](http://fontawesome.io/get-started/) to make Font Awesome available to your site.

**Notice** that **SymbolPicker** in its current form will not work with FontAwesome 5.0 and higher.

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

[](#installation)

The preferred way to install **SymbolPicker** is through [Composer](https://getcomposer.org/). Either add the following to the require section of your `composer.json` file:

`"sjaakp/yii2-symbol-picker": "*"`

Or run:

`composer require sjaakp/yii2-symbol-picker "*"`

You can manually install **SymbolPicker** by [downloading the source in ZIP-format](https://github.com/sjaakp/yii2-symbol-picker/archive/master.zip).

Using SymbolPicker
------------------

[](#using-symbolpicker)

**SymbolPicker** is a Yii 2.0 [InputWidget](http://www.yiiframework.com/doc-2.0/yii-widgets-inputwidget.html). Like any other InputWidget it can be associated with a `model` and an `attribute` (or with a `name` and a `value`).

**Symbolpicker** is in namespace `sjaakp\symbolpicker`.

For instance, to associate **SymbolPicker** with the attribute `'icon'` in a form view, use code like this:

```
use sjaakp\symbolpicker\SymbolPicker;

...

...

```

#### options

[](#options)

**SymbolPicker** runs 'out of the box'. It has the following options to modify it's behaviour:

- **labels**: list of labels used by the widget. If a label is set to `false`, the corresponding element is not rendered.
- **icons**: list of selectable Font Awesome icons. Each item is the class name of an icon, without the `'fa-'` part. So, for instance `'calculator'` refers to the `'fa-calculator'` icon. Default: all of the Font Awesome icons, excluding the aliases. Version 4.3. See: .
- **colors**: list of selectable colors. Each item is a color name, which will generate a `'col-***'` color class name. For instance `'darkblue'` refers to the class name `'col-darkblue'`. Default: a selection of CSS3 named colors.
- **effects**: list of selectable Font Awesome effects. Each item is the class name of an effect, without the `'fa-'` part. So, for instance `'flip-horizontal'` refers to the `'fa-flip-horizontal'` effect. Default: most of the Font Awesome effects. Version 4.3.See: .
- **buttonOptions**: array of HTML options for the dropdown buttons. Default: `[]` (empty array). You may use this to set the CSS class of the buttons.

Of coarse, **SymbolPicker** also has the normal [InputWidget properties](http://www.yiiframework.com/doc-2.0/yii-widgets-inputwidget.html).

Color classes
-------------

[](#color-classes)

CSS color classes for all the CSS3 named colors are in the file `assets\symbol-colors.css`. You may use this in other parts of your project.

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity29

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

2688d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/156f636aceedc73021a2bfafb5433271c2c55d6cf4bce06b12902c85b4b491f1?d=identicon)[sjaakp](/maintainers/sjaakp)

---

Top Contributors

[![sjaakp](https://avatars.githubusercontent.com/u/5585878?v=4)](https://github.com/sjaakp "sjaakp (10 commits)")

---

Tags

yii2extensionwidgetyiifont-awesome

### Embed Badge

![Health badge](/badges/sjaakp-yii2-symbol-picker/health.svg)

```
[![Health](https://phpackages.com/badges/sjaakp-yii2-symbol-picker/health.svg)](https://phpackages.com/packages/sjaakp-yii2-symbol-picker)
```

###  Alternatives

[sjaakp/yii2-taggable

Manage tags of ActiveRecord in Yii2.

3030.6k](/packages/sjaakp-yii2-taggable)

PHPackages © 2026

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