This module integrates the popular Font Awesome icon library into your Drupal site. It provides features like a CKEditor plugin for easy icon selection and an icon field for entities, and supports using Font Awesome icons directly in your content.
Font Awesome is the web's most popular icon set and toolkit.
Font Awesome 6!
Font Awesome 6 has been released!
This module will work with Font Awesome 6 without any major adjustments - simply drop your updated library in place and you can start using it right away!
Please note that metadata is only supported in Font Awesome library version 6.1 or greater. If you make use of custom metadata, please be sure to upgrade your library.
Font Awesome has decided to remove the search terms from their library in version 6, making a much inferior search system compared to version 5. Please make your voice heard on this decision here:
https://github.com/FortAwesome/Font-Awesome/issues/18662
Font Awesome 5 and version 8.x-2.x/7.x-3.x
This version of Font Awesome is a complete rewrite from Font Awesome 4.7.0 and functions very differently. The upgrade process requires a bit of extra work on the part of content managers (or the inclusion of a shim file which allows backwards compatibility).
To prevent the breaking of sites for users who are currently using Font Awesome 4.7.0, we are releasing a new branch of this module under 8.x-2.x for use with Font Awesome 5! (7.x-3.x for Drupal 7 users)
For existing module users - see the README for information on how to install. See the Font Awesome guide on upgrading for information on how the syntax has changed.
Support for latest Icons and additional features
Font Awesome 4.7.0 Font Awesome 5.1+ CKEditor Plugin Icon Field Core Media Entity 8.x-2.x ✔ ✔ ✔ ✔ 8.x-1.x ✔ ✔ 7.x-3.x ✔ 7.x-2.x ✔Dependencies
Drupal 7:
- Libraries
- Font Awesome in sites/all/libraries/fontawesome (only if using the local version - CDN version has no dependencies)
Drupal 8:
- Font Awesome in /libraries/fontawesome (only if using the local version - CDN version has no dependencies)
Usage
- Font Awesome 5+ and Drupal 8+ (v8.x-2.x):
- This module provides a CKEditor plugin to allow users to select Font Awesome icons directly from the editor, as well as a Font Awesome Icon Field to attach directly to entities. Additionally, the module also provides a core media entity type for creating Font Awesome icons as media entities. See the Font Awesome Documentation for more information.
- Font Awesome 5 and Drupal 7 (v7.x-3.x):
You can manually insert icons in code by making use of the classes:
<i class="fas fa-camera-retro"></i>
See the Font Awesome 'How to Use' guide for more information.
- Font Awesome 4.7.0 (v8.x-1.x and v7.x-2.x):
- This module simply adds the CSS, its up to you to make use of the classes:
<i class="icon-twitter"></i> Twitter
For latest versions (4.x) of "Font-Awesome" library you need to use "fa" instead of "icon" class e.g. :-
<i class="fa fa-twitter"></i> Twitter
See the Font Awesome examples page for further usage information.