PHPackages                             neonexus/ionicons-bundle - 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. neonexus/ionicons-bundle

ActiveSymfony-bundle[Utility &amp; Helpers](/categories/utility)

neonexus/ionicons-bundle
========================

Easy integration of Ionicons into Symfony2 projects (based on similar package by Coding Fogey).

v0.4.3(11y ago)02001MITPHPPHP &gt;=5.3.3

Since Nov 22Pushed 11y ago1 watchersCompare

[ Source](https://github.com/neonexus/ionicons-bundle)[ Packagist](https://packagist.org/packages/neonexus/ionicons-bundle)[ RSS](/packages/neonexus-ionicons-bundle/feed)WikiDiscussions master Synced 1w ago

READMEChangelogDependencies (4)Versions (10)Used By (0)

NeoNexusIoniconsBundle
======================

[](#neonexusioniconsbundle)

[![Dependency Status](https://camo.githubusercontent.com/233685d32f52ca81be247c2d8653f6beef5b80324ae727ee37efc928a5c52a51/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f757365722f70726f6a656374732f3533653261333435653061323239666265383030303031342f62616467652e7376673f7374796c653d666c6174)](https://www.versioneye.com/user/projects/53e2a345e0a229fbe8000014)[![SensioLabsInsight](https://camo.githubusercontent.com/57f9b0f747f5a326fb0f2cc79fd083b3a4bdd52c0f974fb56b511c6a70e23671/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f36646439623563652d366564352d343931392d613761392d6238343837393639663536662f6d696e692e706e67)](https://insight.sensiolabs.com/projects/6dd9b5ce-6ed5-4919-a7a9-b8487969f56f)[![Latest Stable Version](https://camo.githubusercontent.com/10a62a655e780351c33d0ca4656f71482a74e521daac6f96082acc86038b332f/68747470733a2f2f706f7365722e707567782e6f72672f6e656f6e657875732f696f6e69636f6e732d62756e646c652f76657273696f6e2e737667)](https://packagist.org/packages/neonexus/ionicons-bundle)[![Latest Unstable Version](https://camo.githubusercontent.com/5df2b667e0f65a5aa0b85eee8065cb1d7dbae28804a23189524771fc4546be50/68747470733a2f2f706f7365722e707567782e6f72672f6e656f6e657875732f696f6e69636f6e732d62756e646c652f762f756e737461626c652e737667)](//packagist.org/packages/neonexus/ionicons-bundle)[![Total Downloads](https://camo.githubusercontent.com/a108c6840f8fef96b4bf77a291b165b86c1f35e8f3c6686b7e133498e063723f/68747470733a2f2f706f7365722e707567782e6f72672f6e656f6e657875732f696f6e69636f6e732d62756e646c652f646f776e6c6f6164732e737667)](https://packagist.org/packages/neonexus/ionicons-bundle)[![License](https://camo.githubusercontent.com/20cfe3777e1cbcffa7fdfc5f9cfc928f92fdf0bb7f4e3794475acb808e35995c/68747470733a2f2f706f7365722e707567782e6f72672f6e656f6e657875732f696f6e69636f6e732d62756e646c652f6c6963656e73652e737667)](https://packagist.org/packages/neonexus/ionicons-bundle)

About
-----

[](#about)

This Bundle makes it easy to integrate [Ionicons](https://github.com/driftyco/ionicons) into your [Symfony2](http://symfony.com/) projects.

Prerequisites
-------------

[](#prerequisites)

- Ionicons repo installed somewhere in your project. It is not contained in this bundle. You can use [Composer](http://getcomposer.org), [Bower](http://bower.io) or any other way to install it.

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

[](#installation)

1. Add `neonexus/ionicons-bundle` to your `composer.json`:

    ```
     {
         ...
         "require": {
             ...
             "neonexus/ionicons-bundle": "0.4.*",
             "driftyco/ionicons": "1.5.*"
         }
         ...
     }

    ```
2. Add `IoniconsBundle` to your `AppKernel.php`:

    ```
     ...
     public function registerBundles()
     {
         $bundles = array(
             ...
             new NeoNexus\Ionicons\IoniconsBundle()
         );
         ...
     }
     ...

    ```
3. Update your dependencies: `composer update`.

NOTICE Installing Ionicons via composer is optional but makes this bundle work out of the box. So I recommend this way.

Configuration
-------------

[](#configuration)

If you did not install Ionicons via composer you have to configure the path to your installation:

```
ionicons:
    assets_dir: %kernel.root_dir%/../vendor/driftyco/ionicons

```

Customization
-------------

[](#customization)

If you want to customize Ionicons you have to put a customized variables file somewhere in your project and configure the path. You also have to set the output path.

```
ionicons:
    filter: less
    customize:
        variables_file:         %kernel.root_dir%/Resources/ionicons/variables.less
        ionicons_output:    %kernel.root_dir%/Resources/less/ionicons.less

```

If you want to use the `lessphp` or `sass` Assetic filter you have to set the `filter` variable accordingly.

There is a command to generate a customized output file to incorporate your customized variables file:

```
app/console neonexus:ionicons:generate

```

Usage
-----

[](#usage)

### Installation of font files

[](#installation-of-font-files)

The bundle provides a command to install the font files to the `web/fonts` directory:

```
app/console neonexus:ionicons:install

```

There is also a `ScriptHandler` for conveniently doing this automatically on each `composer install` or `composer update`:

```
...
"scripts": {
    "post-install-cmd": [
        ...
        "NeoNexus\\Ionicons\\Composer\\ScriptHandler::install"
    ],
    "post-update-cmd": [
        ...
        "NeoNexus\\Ionicons\\Composer\\ScriptHandler::install"
    ]
},
...

```

To include the Ionicons css just include `@ionicons_css` in your base template.

```

        {% block title %}Welcome!{% endblock %}
        {% block stylesheets %}
            {% stylesheets
                '@ionicons_css'
            %}

            {% endstylesheets %}
        {% endblock %}

```

#### Simple icons (currently broken)

[](#simple-icons-currently-broken)

To insert a simple icon add `{{ fa_icon( icon name|options ) }}` into your template.

The parameter can be a `string` containing only the icon name without `fa-` prefix or `JSON` for more customization. The complete set of options is as follows:

```
{
    icon:           name of the icon without 'fa-' prefix
    scale:          [lg|2x|3x|4x|5x|stack-1x|stack-2x],
    fixed-width:    [true|false],
    list-icon:      [true|false],
    border:         [true|false],
    pull:           [left|right],
    spin:           [true|false],
    rotate:         [90|180|270],
    flip:           [horizontal|vertical],
    inverse:        [true|false]
}

```

TODO
----

[](#todo)

- Fix the Twig Extension
- Fix the tests

License
-------

[](#license)

- This bundle is licensed under the [MIT License](http://opensource.org/licenses/MIT).
- Ionicons is also licensed under the [MIT License](http://opensource.org/licenses/MIT).

Acknowledgment
--------------

[](#acknowledgment)

- This bundle is forked from, and inspired by the [Font Awesome Bundle](https://github.com/codingfogey/fontawesome-bundle). Thanks [Andreas Ernst](https://github.com/codingfogey)!

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.1% 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 ~37 days

Recently: every ~48 days

Total

8

Last Release

4302d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/d32c5755e4d29c1dde687d0bad973d1f573775b422cd2f66b0cf15b3b87d8d78?d=identicon)[demortis](/maintainers/demortis)

---

Top Contributors

[![codingfogey](https://avatars.githubusercontent.com/u/1442498?v=4)](https://github.com/codingfogey "codingfogey (118 commits)")[![neonexus](https://avatars.githubusercontent.com/u/305472?v=4)](https://github.com/neonexus "neonexus (12 commits)")[![waffle-iron](https://avatars.githubusercontent.com/u/6912981?v=4)](https://github.com/waffle-iron "waffle-iron (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/neonexus-ionicons-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/neonexus-ionicons-bundle/health.svg)](https://phpackages.com/packages/neonexus-ionicons-bundle)
```

###  Alternatives

[ezsystems/symfony-tools

eZ Systems Symfony Tools

19306.9k2](/packages/ezsystems-symfony-tools)

PHPackages © 2026

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