neonexus/ionicons-bundle

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

Thursday, August 7, 2014
by demortis
Repository
1 Watchers
0 Stars
183 Installations

PHP
0 Dependents
0 Suggesters
4 Forks
0 Open issues
10 Versions
1 % Grown

The README.md

NeoNexusIoniconsBundle

, _(*1)

About

This Bundle makes it easy to integrate Ionicons into your Symfony2 projects., _(*2)

Prerequisites

Ionicons repo installed somewhere in your project. It is not contained in this bundle. You can use Composer, Bower or any other way to install it.

Installation

Add neonexus/ionicons-bundle to your composer.json:, _(*3)

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

Add IoniconsBundle to your AppKernel.php:, _(*4)

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

Update your dependencies: composer update., _(*5)

NOTICE Installing Ionicons via composer is optional but makes this bundle work out of the box. So I recommend this way., _(*6)

Configuration

If you did not install Ionicons via composer you have to configure the path to your installation:, _(*7)

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

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., _(*8)

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., _(*9)

There is a command to generate a customized output file to incorporate your customized variables file:, _(*10)

app/console neonexus:ionicons:generate

Usage

Installation of font files

The bundle provides a command to install the font files to the web/fonts directory:, _(*11)

app/console neonexus:ionicons:install

There is also a ScriptHandler for conveniently doing this automatically on each composer install or composer update:, _(*12)

...
"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., _(*13)

<!DOCTYPE html>
<html>
    <head>
        <meta charset="UTF-8" />
        <title>{% block title %}Welcome!{% endblock %}</title>
        {% block stylesheets %}
            {% stylesheets
                '@ionicons_css'
            %}
                <link rel="stylesheet" href="{{ asset_url }}" media="screen"/>
            {% endstylesheets %}
        {% endblock %}

Simple icons (currently broken)

To insert a simple icon add {{ fa_icon( icon name|options ) }} into your template., _(*14)

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:, _(*15)

{
    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

Fix the Twig Extension
Fix the tests

License

This bundle is licensed under the MIT License.
Ionicons is also licensed under the MIT License.

Acknowledgment

This bundle is forked from, and inspired by the Font Awesome Bundle. Thanks Andreas Ernst!

The Versions

07/08 2014

dev-master

9999999-dev

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

Sources Download

MIT

The Requires

The Development Requires

by NeoNexus DeMortis

07/08 2014

0.3.0.0

Easy integration of Font Awesome into Symfony2 projects.

Sources Download

MIT

The Requires

php >=5.3.3
symfony/symfony >=2.3

The Development Requires

phpunit/phpunit 3.7.*

by Andreas Ernst

05/12 2013

v0.2.1

0.2.1.0

Easy integration of Font Awesome into Symfony2 projects.

Sources Download

MIT

The Requires

php >=5.3.3
symfony/symfony >=2.3

The Development Requires

phpunit/phpunit 3.7.*

by Andreas Ernst

05/12 2013

v0.2.0

0.2.0.0

Easy integration of Font Awesome into Symfony2 projects.

Sources Download

MIT

The Requires

php >=5.3.3
symfony/symfony >=2.3

The Development Requires

phpunit/phpunit 3.7.*

by Andreas Ernst

22/11 2013

v0.1.0

0.1.0.0

Easy integration of Font Awesome into Symfony2 projects.

Sources Download

MIT

The Requires

php >=5.3.3
symfony/symfony >=2.3

The Development Requires

phpunit/phpunit 3.7.*

symfony-bundle ionicons-bundle

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