collective.fontawesome 1.0.4

Introduction

This addon registers Font Awesome into Plone CSS registry.

Version of Font Awesome: 4.6.3

License

• The Font Awesome font is licensed under the SIL Open Font License http://scripts.sil.org/OFL

• Font Awesome CSS, LESS, and SASS files are licensed under the MIT License http://opensource.org/licenses/mit-license.html

• The Font Awesome pictograms are licensed under the CC BY 3.0 License http://creativecommons.org/licenses/by/3.0/

• Attribution is no longer required in Font Awesome 3.0, but much appreciated: “Font Awesome by Dave Gandy - http://fortawesome.github.com/Font-Awesome “

How to install

This addon can be installed with the typical Plone addon installation process. Please see the official documentation for a description.

For Plone 5, import the “collective.fontawesome (Plone 5)” profile.

How to use

To use an icon you can add ‘fa fa-X’ to your tag where X is the icon you want:

<ul>
    <li class="fa fa-glass">item 1</li>
    <li class="fa fa-music">item 2</li>
    <li class="fa fa-search">item 3</li>
</ul>

Or just use CSS for your class ‘myclass’:

.myclass:before {
    content: "\f000";
    font-family: FontAwesome;
    font-style: normal;
    font-weight: normal;
    text-decoration: inherit;
}

Available CSS classes and values for the content attribute can be found in the Font Awesome cheat sheet or in the source code (file: font-awesome.css#L171 at the time of writing).

An example page is avaible in the addon, here is a screenshot:

Replacing Plone’s default icons with FontAwesome fonts

There is now a separate Generic Setup profile called replace-plone-icons which will replace Plone’s default icons (e.g. for content types and actions) with Font Awesome icons.

IMPORTANT: You still need to install the default profile as well.

Credits

Changelog