#Font Awesome Icons

Contributors: rachelbaker

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

Requires at least: 3.0

Tested up to: 3.6 beta2

Stable tag: 3.1

License: GPLv3 or later

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

![image](http://f.cl.ly/items/3Y0C0i270N281b0v2Q3y/banner-772x250.png)


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

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

A full list of the 302 Font Awesome icons is available: [http://fontawesome.io/icons/](http://fontawesome.io/icons/)

##Usage Instructions

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

__HTML Option__

All code examples on the Font Awesome site apply: [http://fontawesome.io/examples/](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 Option__

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.


Pencil icon

`[icon name=icon-pencil]`

Phone icon

`[icon name=icon-phone]`

Chevron left icon

`[icon name=icon-chevron-left]`



##Installation

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

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

3. Add shortcode to 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.

##Release Notes

__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](http://rachelbaker.me)

##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) 2012  Rachel Baker, Plugged In Consulting, Inc.

    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/>.