#Font Awesome Icons

Contributors: @rachelbaker, @BFTrick, @Taylor4484, @tommarshall, @rscarvalho

Tags: icons, font-awesome, font icon, UI, icon font, bootstrap

Requires at least: 3.0

Tested up to: 3.6 beta2

Stable tag: 3.2.1

License: GPLv3 or later

License URI: http://www.gnu.org/licenses/gpl-3.0.html

Enables easy use of the Font Awesome icon font set from within WordPress. Icons can be inserted using either HTML, shortcode, or a built-in TinyMCE plugin.

Font Awesome is a pictographic font set of 361 icons. The icons are infinitely scalable and screen reader compatible.

A full list of the 361 Font Awesome icons is available: FontAwesomeIconsCheatsheet.pdf

##Usage Instructions

To use any of the Font Awesome icons on your WordPress site you have three options:

HTML

All code examples on the Font Awesome site apply: http://fontawesome.io/examples/

Examples

Pencil icon

<i class="icon-pencil"></i>

Phone icon

<i class="icon-phone"></i>

Chevron left icon

<i class="icon-chevron-left"></i>

Shortcode

Don't want to worry about HTML tags? You can use a shortcode in your posts, pages and even widgets to display a Font Awesome icon.

The shortcode to use is [icon name=name-of-icon], where name=X is the class of the icon you would like to use.

Examples

Pencil icon

[icon name=icon-pencil]

Phone icon

[icon name=icon-phone]

Chevron left icon

[icon name=icon-chevron-left]

TinyMCE Plugin

Select the icon you would like to add to your post or page content from the Glyphs drop-down menu in the Visual Editor.

##Installation

1. Upload Font Awesome Icons to the /wp-content/plugins/ directory.

2. Activate the plugin through the 'Plugins' menu in WordPress.

3. Use one of the three usage methods (HTML, Shortcode, or TinyMCE plugin) within the content of your posts or pages.

4. Use either the HTML or Shortcode methods inside your text widgets.

##Release Notes

Version 3.2.1

• Updated font and CSS files to Font Awesome 3.2.1 release. (Thanks to @tommarshall)
• Updated build/icons.yml file for reference. (Thanks to @tommarshall)
• Updated reference PDF file with Font Awesome 3.2.1 icons. (Thanks to @tommarshall)
• Added TinyMCE editor plugin, making it possible for the user to select font awesome glyphs from a drop-down list within the content editor. (Thanks @rscarvalho)
• Added version number constant to cache bust assets for future plugin updates. (Thanks @rscarvalho)

Version 3.1

• Updated font and CSS files to Font Awesome 3.1 release. (Thanks to @Taylor4484)
• Updated reference urls to new Font Awesome URL. (Thanks to @Taylor4484)
• Added build/icons.yml file for reference. (Thanks to @BFTrick)
• Updated reference PDF file with Font Awesome 3.1 icons.

Version 3.0

Updated font and CSS files to Font Awesome 3.0 release.

Version 1.2

Added IE7 conditional stylesheet

Version 1.1

Created and enabled shortcode

Version 1.0

Initial release

Upcoming Versions Wishlist

• Add TinyMCE button to allow easy insertation of Font Awesome icon

##Author

• Rachel Baker

##Credits

Font Awesome webfont and associated code are licensed under CC BY 3.0 and is a production of @fortaweso_me, by Dave Gandy.

##License License: Copyright (C) 2013 Rachel Baker

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.