silverstripe-module font-awesome

moe/font-awesome

A simple form field for selecting font-awesome classes in the CMS.

Synopsis

Provides a field to easily pick font-awesome icons, _(*1)

Features

• Easily pick icons to be used anywhere in the frontend
• Can filter on icon name

Installation

Composer

Make sure you're not double loading the css/fonts with a theme., _(*2)

Ideally composer will be used to install this module. composer require "moe/font-awesome:@stable", _(*3)

Screen shots

Font awesome icon view

Filter view

, _(*4)

Usage

A basic working example, and the following to any class you want the field on;, _(*5)

    private static $db = array(
        'Icon' => 'Varchar(255)',
    );

    public function getCMSFields()
    {
        $fields = parent::getCMSFields();

        $fields->addFieldsToTab('Root.Main', array(
           FontAwesomeField::create("Icon", "Font Awesome icon")
        ));

        return $fields;
    }

Then simple include in the template where you want the icon placed, _(*6)

    <i class="fa $Icon"></i>  

The controller extension should make sure you've got access to the icons so you don't need to double up the CSS file., _(*7)

Want colours instead of icons?

Got you covered, checkout color-swabs!, _(*8)

Libraries used/modified

• Font Awesome 4.7