/laravel-fontawesome

Laravel FontAwesome helpers

Primary LanguagePHPMIT LicenseMIT

FontAwesome helper and blade directive for Laravel

Latest version on Packagist Software License Travis branch Scrutinizer SensioLabs Insight Style Ci Total Downloads

The PendoNL/laravel-fontawesome package provides an easy way to include FontAwesome icons in your code, there's even a Blade directive to use them inside your blade templates.

Usage

Make sure you've loaded FontAwesome's CSS on your page! This package only providers little helpers to generate icons!

You can use the Facade to generate icons from within your code:

FontAwesome::icon('arrow-up');
// Generates <i class="fa fa-arrow-up"></i>

It's also possible to add optional attributes for the icon:

FontAwesome::icon('arrow-up', ['class' => 'tiny', 'id' => 'MyFirstIcon']);
// Generates <i class="fa fa-arrow-up tiny" id="MyFirstIcon"></i>

If you aren't using the Facade, this is the way to generate an icon:

use PendoNL\LaravelFontAwesome\LaravelFontAwesome;

$fa = new LaravelFontAwesome();
$icon = $fa->icon('arrow-up', ['class' => 'tiny', 'id' => 'MyFirstIcon']);

And last, but not least, you there'a a blade directive to use inside your blade templates:

@fa('arrow-up');
@fa('arrow-up', ['class' => 'tiny', 'id' => 'MyFirstIcon']);

Using the Facade from within your templates work as well:

{!! FontAwesome::icon('building') !!}
{!! FontAwesome::icon('building', ['id' => 'building-icon']) !}}

Installation

You can install the package via composer:

composer require pendonl/laravel-fontawesome

Next, you must install the service provider (For L5.5 and up Auto-Discovery is enabled):

// config/app.php
'providers' => [
    ...
    PendoNL\LaravelFontAwesome\LaravelFontAwesomeServiceProvider::class,
];

Optionally, register the facade:

// config/app.php
'aliases' => [
    ...
    'FontAwesome' => PendoNL\LaravelFontAwesome\Facade::class,
];

Security

If you discover any security related issues, please email joshua@pendo.nl instead of using the issue tracker.

Credits

It was incredible helpfull to view various packages of Spatie to get to this final version. Aswel as lucasruroken/laravel-font-awesome which I spotted and was the main reason to start creating my first package ever. Thanks both for open sourcing your packages! I also tried to write down this first experience on my companies blog, comments appreciated!

About Pendo

Pendo is a webdevelopment agency based in Maastricht, Netherlands. If you'd like, you can visit our website.

License

The MIT License (MIT). Please see License File for more information.