Your Moodle version

Filters: FontAwesome Icon Filter

filter_fontawesome
Maintained by Picture of Usman Asar Usman Asar
If you are using a FontAwsome equipped theme (like Essential, Elegance, Shoehorn, Shoelace, BCU) then this filter will allow you to use FontAwesome icons in your content.
9k
397
4
Moodle 2.5, 2.6, 2.7, 2.8, 2.9

Font Awesome gives you scalable vector icons that can instantly be customized -- size, color, drop shadow, and anything that can be done with the power of CSS. More info on FontAwesome can be found here.

This filter allows you to add FontAwesome icons to anywhere you have a text box in Moodle. If you use the recommended method the Text box strips them aug automatically. This filter provides a mechanism to allow you to use FontAwesome without the editor stripping out your tags.

Filter Updated: 31th August, 2015 with FontAwesome version 4.4

Usage

IMPORTANT: This syntax has changed since version 1.0. The latest Font Awesome uses a new methodology for naming If you are upgrading you will need to update your text.

First you will need to find the icon you wish to use. This link provides a full list.

Anywhere you wish to add an icon just surround it with square brackets and type in the icon name. e.g.:

[fa-camera-retro]

If you wish to make the icon larger you can use a multiplier. e.g.:

[fa-camera-retro fa-2x]    or    [fa-camera-retro fa-4x]

If you wish to rotate the icon you can specify how many degrees clockwise. e.g.:

[fa-camera-retro fa-rotate-90]

You can also flip an icon horizontally or vertically. e.g.:

[fa-camera-retro fa-flip-horizontal]    or     [fa-camera-retro fa-flip-vertical]

You can mute the colour to a dull grey. e.g.:

[fa-camera-retro fa-muted]

You can "pull" the icon to the left or right. If it is "pulled" to the left text will wrap to the right. e.g.:

[fa-camera-retro pull-left]

All the settings above can be mixed and matched. For example if I was to type in:

[fa-quote-left fa-4x pull-left fa-muted] Use a few of the new styles together, and you've got easy pull quotes or a great introductory article image. Or spinning icons for loading and refreshing content. Or fun big icons in multi-line buttons. You can combine all of them in any combination to get lots of new possibilities.

I will then see:

Example

Important Note:

Please read the readme file provided with this filter. The filter does not provide FontAwesome, just a way to easily add the icon tags to moodle text boxes without having them stripped. To learn how to add this Font to your moodle site read this blog post.

For this filter to work, your theme must have provided FontAwesome in its core files, currently themes supporting FontAwesome are Essential, Elegance, Shoehorn, Shoelace & BCU and they all have been updated to latest version 4.4 of FontAwesome. In case the theme you are using is not updated to the latest FontAwesome, using the updated filter will not break anything, old icons will work, the newly added icons won't simply show up.

Update: New version 4.4 of FontAwesome is out, therefore its up to theme developers when they would update their corresponding themes with 4.4 for new icons to work, this filter however can be updated and will show older icons as well where themes haven't been updated.

See it in Action:

Check out this open (guest access) moodle course to see some examples of this filter in action:

http://features.demo.moodle.com.au/course/view.php?id=35

Screenshots

Screenshot #0
Screenshot #1

Contributors

Picture of Usman Asar
Usman Asar (Lead maintainer)
Julian Ridden
Julian Ridden: Original author
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • MD shot of me from his iphone4
    Fri, Oct 18, 2013, 2:45 PM
    I'm speechless, thanks for sharing this!
  • Picture of Christian Conradi
    Tue, Dec 3, 2013, 2:40 AM
    We have problems with this Filter in moodle 2.5.1! It doesn't work. The theme was out of order! Must i have moodle 2.6?
  • Picture of Heinz Schmolke
    Fri, Dec 27, 2013, 3:49 AM
    The same with me: If I put the directory in filters I got a error: "Trying to reference an unknown block region side-post". The filter do not work in 2.5
  • Picture of Caitlin Cahill
    Thu, May 15, 2014, 5:04 AM
    Great filter! It works beautifully on webpages, but does not work on a database template.
  • Carol walking in the Howgills
    Fri, Nov 28, 2014, 12:05 AM
    Brilliant idea... I see the latest download is for 2.6 does it work with 2.7 and 2.8?
  • Picture of David Mudrák
    Wed, Dec 10, 2014, 4:30 AM
    This unmaintained plugin has been adopted by Usman Asar. Thanks a lot, and good luck with further development of it!
  • Picture of Chris Mat
    Wed, May 27, 2015, 4:39 PM
    Hi Usman,

    Are you going to upgrade to 2.9?
  • Picture of Usman Asar
    Wed, May 27, 2015, 5:25 PM
    Chris, usually filters are compatible across all Moodle versions without any dependencies. Thanks for the reminder (should have done it long ago), Moodle version updated for compatibility.
Please login to post comments