collective.fontawesome 1.1

Font Awesome for Plone

collective.fontawesome

This add-on registers Font Awesome into Plone CSS registry.

Features

• Version of Font Awesome: 5.2.0.

• Includes a GenericSetup profile example for Replacing Plone’s default icons with FontAwesome fonts.

• Includes a Example View working, go to http://site_url/@@example.collective.fontawesome

Translations

This product has been translated into

• Spanish (thanks, Leonardo J. Caballero G. aka macagua)

Installation

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

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

Warning

ie7 support has been removed

How to use

Since version 5, FontAwesome changed the way it works and the Free version includes 2 fonts : “Font Awesome 5 Free” and “Font Awesome 5 Brands”.

Depending on the icon you want to use, you have to use the “fa” or “fab” class :

To use an icon from the “Font Awesome 5 Free” add class=”fa fa-X”, to use an icon from “Font Awesome 5 Brands”, add class=”fab fa-X” to your tag where X is the icon you want:

<ul>
    <li class="fa fa-glass-martini">item 1</li>
    <li class="fa fa-music">item 2</li>
    <li class="fa fa-search">item 3</li>
</ul>
<ul>
    <li class="fab fa-angular">item 1</li>
    <li class="fab fa-apple">item 2</li>
    <li class="fab fa-avianex">item 3</li>
</ul>

Or just use CSS for your class ‘myclass’:

.myclass:before {
    content: "\f000";
    font-family: "Font Awesome 5 Free";
    font-weight: 900;
    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).

Full list of useable icons may be found here : Font Awesome free icons

An example page is available in the add-on, 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.

A replace-plone-icons profile example is available in the add-on, here is a screenshot:

Contribute

• Issue Tracker: https://github.com/collective/collective.fontawesome/issues

• Source Code: https://github.com/collective/collective.fontawesome

Credits

Companies

• Makina-Corpus http://www.makina-corpus.com

People

• JeanMichel FRANCOIS aka toutpt <[e-mail]>

• Eric Bréhault, <[e-mail]>

• Gauthier Bastien, <[e-mail]>

• Leonardo J. Caballero G. aka macagua <[e-mail]>

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 https://opensource.org/licenses/mit-license.html

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

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

Changelog

1.1 (2018-08-01)

• Fixed warning: no files found matching *.rst and *.txt under directory collective from MANIFEST.in file [macagua]

• Added more strings classifiers items for this package [macagua]

• Added i18n support [macagua]

• Added Spanish translation [macagua]

• Moved to fontawesome 5.2.0 [gbastien]

1.0.5 (2017-05-23)

• Updated to fontawesome 4.7.0 [ewohnlich]

• Updated sample in @@example.collective.fontawesome to show what is new in version 4.7.0 [gbastien]

1.0.4 (2016-12-05)

• Update to fontawesome 4.6.3 [gbastien]

• Include *.woff2 in MANIFEST.in so file is present in the release or we have an error in the browser console while trying to import file fontawesome-webfont.woff2 [gbastien]

1.0.3 (2015-07-10)

• Update to fontawesome 4.1.0 [jcbrand]

• Update to fontawesome 4.3.0 [ebrehault]

• Add new GenericSetup profile that replaces Plone’s default icons for content types and actions with FontAwesome fonts. [jcbrand]

• Plone 5 compliancy [ebrehault]

1.0.2 (2013-05-14)

• Update to fontawesome 3.1.1

1.0.1 (2013-05-06)

• Fix packaging (manifest)

1.0 (2013-05-06)

• Package created using templer [JeanMichel aka toutpt]