Font Awesome

Descripción

The official way to use Font Awesome Free or Pro icons on your site, brought to you by the Font Awesome team.

Features

Our official plugin lets you use Font Awesome the way you want:

  • Use Pro or Free icons.
  • Leverage the latest release or a specific version of our icons.
  • Choose the tech, either SVG or Web Font.
  • Take your pick of loading your icons from our classic Font Awesome CDN, or use Font Awesome Kits – the easiest and most efficient way to use Font Awesome icons on the web.
  • Turn on automatic compatibility for Font Awesome Version 4 if you – or your plugins – are still using Version 4 syntax.
  • Troubleshoot and resolve issues when multiple versions of Font Awesome are loading on your site from other plugins/themes, which can cause unexpected icon display or technical issues.
  • Make things even awesomer using icons from Font Awesome Version 6.
  • Use your uploaded icons from your Pro Kits.

Note: The plugin is not compatible on WordPress multisite at this time.

How to Use

Install and enable the plugin
(See the Installation tab for details)

Add icons to your pages and posts
Adding icons works in both the block editor and the classic editor.

Once you’ve set up your plugin, you can search and add icons to your pages and posts by choosing the Font Awesome option in the format bar from any text block to open the Icon Chooser. (If you want to search and add Pro icons in the Icon Chooser, you’ll need to use a Pro Kit.)

Or you can use the icon names in shortcodes or HTML. When you use shortcodes, you add the name of the icon and a prefix, where the prefix is the style of icon you want to use. Note that you don’t need to include the fa- part of the name. And if you don’t include any prefix, the icon will default to the Solid style.

The shortcode for an icon looks like this:

[icon name="stroopwafel"]

[icon name="stroopwafel" prefix="fal"]

Get the details on all the shortcode options in the Font Awesome WordPress docs.

You can also use basic HTML with standard Font Awesome syntax, like this:

<i class="fas fa-stroopwafel"></i>

Using Pro Icons and Features
To use a Kit, create a Kit on FontAwesome.com and select “Pro icons” in the settings. Then grab your API Token from your Font Awesome account page to add into the WordPress Kit settings.

To add Pro icons with the CDN, you’ll need to add your domain to the list allowed domains on your Font Awesome account CDN Settings page and use shortcodes or HTML to add the icons into your content.

If you’re using the Icon Chooser, you’ll need to use a Pro Kit. (The CDN can only search and add Free icons – use shortcodes or HTML to add Pro icons when using the CDN).

Troubleshooting with the Plugin
Font Awesome icons are popular, so lots of themes and plugins also load Font Awesome, and sometimes their version can conflict with yours. So we created a way to help you find and prevent those conflicting versions from affecting your icons: The Conflict Detection Scanner.

If the plugin seems to be set up correctly and your icons still aren’t loading and you’re not sure why, head over to the Troubleshoot tab, which has two parts:

  • Detect Conflicts with Other Versions of Font Awesome – which lets you start the conflict detection scanner to find versions of Font Awesome loading on your site.
  • Versions of Font Awesome Active on Your Site – which shows the results of the scanner and lets you prevent any conflicting versions from loading other versions of Font Awesome on your site.

Get more information about using the scanner for troubleshooting on the Font Awesome WordPress docs.

Configuring

The plugin is set to serve Font Awesome Free icons as a Web Font via the Font Awesome CDN by default. You can change the CDN settings right in the plugin. If you want just the basic Free icons, you probably don’t need to make any changes to the default configuration.

You can get more information about all the available settings and troubleshooting on the Font Awesome WordPress docs.

Upgrading from the Old Versions

If you used the old plugin or are still using Version 3 of Font Awesome, we’ve tried to smooth the upgrade path for you by keeping [icon] shortcode compatibility for Font Awesome 3 names used with the old plugin. But we plan to remove version 3 naming support from this plugin soon so don’t wait too long to update your code!

See Also

The README on GitHub has details for WordPress site owners and developers.

And there are API docs for developers.

Capturas

  • Add icons in any text block from the editing bar
  • Search and add icons from Font Awesome Free or Pro (with subscription)
  • View the icons in Preview mode or in published pages and posts
  • Use a Font Awesome Kit to power your site's icons
  • Or use the Font Awesome CDN
  • Detect and fix issues with conflicting versions of Font Awesome running on your site
  • Add icons in Classic Editor as well

Instalación

From the Plugins Directory in WordPress Admin

From the “Add Plugins” page in WordPress admin:

  1. Search the plugins directory by author: fontawesome

  2. Click “Install” on the Font Awesome plugin in the search results

  3. Click “Activate”

Installing a Zip Archive

  1. Click Download on this plugin’s directory entry to get the .zip file

  2. On the “Add Plugins” page in WordPress admin, click “Upload Plugin” and choose that .zip file

Access Font Awesome Plugin Settings

Once you activate the Font Awesome plugin, you will see Font Awesome in the Settings menu in your WordPress admin area, or you can click “Settings” on the plugin listing on the Plugins page.

The plugin is set to serve Font Awesome Free icons as a Web Font via the Font Awesome CDN by default. You can change the CDN settings right in the plugin. If you want just the basic Free icons, you probably don’t need to make any changes to the default configuration.

Using Pro Icons and Features
To enable Pro icons with the CDN, you will need to add your domain to the list allowed domains on your Font Awesome CDN Settings page. To configure a Kit, get your API Token from your Font Awesome account page.

You can get more information about all the available settings and troubleshooting on the Font Awesome WordPress docs.

Preguntas frecuentes

You can get more information about using the plugin, details for available settings, and answers to frequently asked questions on the WordPress docs on Font Awesome.

Reseñas

9 de agosto de 2021
Update: They refunded me after issues so I revised my rating. I do hope they update their Pro service. Original review below. I upgraded to Pro because I thought it would speed up my site with their SVGs and the kit. My site load time went from 8 seconds to 20 seconds! If I deactivate the plugin to remove FA my site loads in 3 seconds. I know HTML and CSS so I know what I am doing here. I have spent 2 months trying to figure out their documentation when I can figure out other programming languages in a couple days. The documentation is vague and not intuitive. Their customer support is equally as bad with one sentence answers that don't answer the question. I think I might just go without icons to speed up might site. I want my money back!
10 de abril de 2021
I purchased FontAwesome PRO, but it would not work with my theme. I contacted tech support several times for assistance. At first they tried to help, but when their solutions didn't solve the problem, they quit responding. Furthermore, they refused to refund the $99 I had paid for PRO saying, "We don't give refunds for downloadable commercial software." Well, you have to download it to try it. And if it doesn't work, and their tech support can't provide a solution, it stands to reason that a refund is in order. I finally challenged the charge with my credit card company and got the refund, but it took a lot of time and effort on my part. I'm a website designer and have never had this type of issue with a plugin developer. Needless to say, I won't be buying the PRO version of FontAwesome for any future projects.
6 de abril de 2021
I operate multiple (double digits) sites and have tried a host of Font Awesome plugins - none of them works as effectively as this one, the official one. Very simple but it just does what it’s designed to do - many thanks ...
18 de marzo de 2021
I have 2 sites that are almost identical running on the same server environment. On one site I'm able to enable the plugin and on the other I get this error: "The Font Awesome plugin caught a fatal error: Font Awesome could not be activated." It's maddening.
Leer todas las 41 reseñas

Colaboradores y desarrolladores

“Font Awesome” es un software de código abierto. Las siguientes personas han colaborado con este plugin.

Colaboradores

“Font Awesome” ha sido traducido a 12 idiomas. Gracias a los traductores por sus contribuciones.

Traduce “Font Awesome” a tu idioma.

¿Interesado en el desarrollo?

Revisa el código , echa un vistazo al repositorio SVN , o suscríbete al log de desarrollo por RSS .

Registro de cambios

4.0.4

  • FIX: add hash values to JavaScript chunk file names to resolve the problem where
    sometimes an old cached version of a JavaScript file would load in the browser
    instead of the intended updated one. This caused some users to see a blank
    settings page after upgrading from a previous version of the plugin.

4.0.3

  • FIX: When in the Classic Editor in WordPress 5, do not load block editor
    script dependencies that assign to the global wp.editor object.
    This prevents problems with other plugins on the page that may depend on that
    global.
  • FIX: When in the Classic Editor where multiple editor instances are present,
    ensure that the Add Font Awesome media button on each is wired up to
    load the Icon Chooser on click, not just those buttons that were on the page
    at the time this plugin’s initialization code is run.

4.0.2

  • FIX: re-enable the Icon Chooser in the Classic Editor on WordPress 4.
  • FIX: in some cases where the path to the plugin was a non-standard
    location–such as when installed via composer–the admin settings page and
    Icon Chooser would not load correctly. Fixed.
  • FIX: the global version of the lodash JavaScript library was again being overwritten
    by the version used by this plugin. Fixed.
  • The Icon Chooser’s integration with the Block Editor (Gutenberg) has been disabled
    for WordPress 5.0, 5.1, 5.2, and 5.3, due to incomptabile JavaScript libraries.
    All other features of the plugin work normally on those versions, including
    Icon Chooser integration with the Classic Editor.

4.0.1

  • FIX: In scenarios where both Gutenberg (Block) and TinyMCE (Classic)
    editors were being loaded onto the same page, the Gutenberg editor was not
    displaying properly.
    Now, in that multi-editor situation, the Icon Chooser integration is only enabled
    for the block editor.
    In those cases, you can still use icon shortcodes or HTML in
    the TinyMCE editor boxes; those editors just won’t have the “Add Font Awesome”
    media button for opening the Icon Chooser.
    The Icon Chooser is still available from the Classic Editor when the block editor
    is not present on the page.
  • FIX: In scenarios where there are multiple TinyMCE editor instances on the same page,
    such as WooCommerce product editing pages, only the “Add Font Awesome” media
    button on the first of those editors was working correctly. Now all of them work
    correctly.
  • FIX: In the Classic Editor, when other themes or plugins added media buttons after
    the “Add Font Awesome” button, those buttons were showing up as combined together
    and not working properly. Now they’re separated and working great.
  • The Icon Chooser integration for the Classic Editor in WordPress 4 has been temporarily
    disabled. Everything else works as before in WP4, just not the new Icon Chooser.

4.0.0

  • OFFICIAL 4.0.0 STABLE RELEASE
  • FEATURES: Includes all the features from the early 4.0.0 release candidates (details below)
  • FEATURE: Visual icon chooser lets you search and easily insert the correct shortcode.
  • Fixed regression on overriding global lodash version.
  • Added PHP API method to get current Kit token.
  • Removed the filter to process all shortcodes in widget text. This seems to have been
    an overly eager approach on our part. If you want shortcodes to be processed
    in widget text – all shortcodes, not just this plugin’s icon shortcode – you can
    add a line like this to your theme’s functions.php file:
    add_filter( 'widget_text', 'do_shortcode' );

4.0.0-rc23

  • FIX: plugin now handles Kits with version “5.x” or “6.x”

  • FEATURE: shortcode supports attributes: style, role, title, aria-hidden,
    aria-label, aria-labelledby

4.0.0-rc22

  • Metadata about available Font Awesome releases is now stored as a normal option
    in the WordPress database, instead of as a transient. Thus, it does not expire
    and does not disappear if the transient cache is purged.

    This is in part to avoid the scenario where a request to the Font Awesome API
    server may be required to refresh metadata in response to a front end page load
    when that transient expires.

    Some site owners had occassionally experienced problems where a sudden burst of
    requests to the API server from many WordPress sites caused this plugin to fail
    when making a request with an error like ‘An unexpected response was received
    from the Font Awesome API server.’ This change means that it is significantly
    less likely that such a scenario will occur.
    (Additionally, changes have been made on the API server, also making it
    significantly less likely that this over-load failure will occur again.)

  • Developers: the refresh_releases() API method has been deprecated to discourage
    unnecessary blocking network requests to the API server.

4.0.0-rc21

  • optimize normal page loads by loading much less metadata from the database (GitHub #96)
  • move the Font Awesome settings link from the main admin nav menu back down under Settings, where it used to be
  • update the version of the conflict detection script to one that also detects conflicting Kits
  • minor maintenance changes to keep JavaScript dependencies up to date
  • fix a bug involving the pseudo-elements setting when moving back and forth between using a Kit and using CDN (GitHub #82)

4.0.0-rc20

  • developer-oriented update to support building themes that use this code as a composer package

4.0.0-rc19

  • another minor update with additional error logging

4.0.0-rc18

  • minor update with additional error logging

4.0.0-rc17

SECURITY: fixes a vulnerability in how API tokens were being stored, when configured to use a Kit. All users of 4.0.0-rc15 or 4.0.0-rc16 should update immediately. Find more details and instructions for updating your API Token on the Font Awesome blog.

  • a minor bug in how network errors are handled

4.0.0-rc16

  • Fixes to the upgrade process

4.0.0-rc15

MAJOR UPDATE, some breaking changes for developers. Improves conflict detection, adds support for Kits and internationalization.

  • Includes auto-upgrade logic so that most users can upgrade with no impact, except those that have “registered client” themes or plugins. Users who had previously enabled the “remove unregistered clients” option should verify that the auto-upgrade worked successfully – check that your icons are appearing correctly. If not, run the Conflict Scanner from the Troubleshoot tab.
  • New conflict detection and resolution: The new conflict detection scanner can be enabled to more precisely discover conflicting versions of Font Awesome and provides more granular conflict resolution.
  • Expanded error handling with detailed reports in the web console for more advanced diagnostics.
  • Adds support for Kits.
  • Adds comprehensive internationalization in both PHP and JavaScript.
  • New design of the admin UI.
  • Developers: Significant changes to the way the settings are handled internally: Font Awesome will always load in the way the WordPress admin chooses. Registered themes or plugins may register preferences (which are displayed to the admin), but the site admin will determine the configuration.
  • Developers: Registered client plugins and themes need to be updated before they will work as expected.
  • Developers: The PHP API contains significant changes. See the GitHub README for an overview and the PHP API docs for details. This release is intended as a final API-changing release before stabilizing the API at 4.0.0. Once 4.0.0 is released, it will follow semantic versioning best practices.

4.0.0-rc13

  • Improve diagnostic output for unhandled errors.

4.0.0-rc12

  • Bug fix: Fix loading of admin page assets when removal of unregistered clients is enabled. This bug has been
    hiding under a rock for a while. rc11 turned over the rock, and this bug scurried out.

4.0.0-rc11

  • Bug fix: enqueue Font Awesome assets in admin and login areas, not just in the front end

4.0.0-rc10

  • Attempt to fix a problem where the admin settings is sometimes being confused by unexpected output from the WordPress
    server. This condition has been reported when certain other plugins are active, and (possibly) when PHP output
    buffering works differently than this plugin expects.

4.0.0-rc9

  • Enhance Font Awesome version 4 compatibility: add shimming of the version 4 font-family to enable version 4
    icons defined as pseudo-elements to be rendered via the version of Font Awesome 5 loaded by this plugin.

  • Add warnings to the admin UI to indicate that using svg and pseudo-elements may result in slow performance,
    and that svg with pseudo-elements and version 4 compatibility is not supported at all.

4.0.0-rc8

  • Remove dependence on third party libraries, eliminating a class of potential conflicts with other plugins.

  • Breaking changes to the API used by theme and plugin developers (no breaking changes for WordPress site owners).
    See commit log

4.0.0-rc7

  • Fix detection and removal of unregistered clients by changing the internal resource name this plugin uses to enqueue its resource.
    Change it to something unlikely to be used by other themes or plugins.

4.0.0-rc6

  • Fix error when updating options on admin page: handle null releaseProviderStatus in cases where the release provider
    does not have to make a network request to update release metadata.

4.0.0-rc5

  • Remove tilde character from JavaScript filenames to avoid violating some URL security rules

4.0.0-rc4

  • Cache releases data in the WordPress database to reduce the number of server-side network requests.

  • Ensure that releases data are always loaded fresh from fontawesome.com when loading the admin
    settings page so site owners can see when new versions are available.

  • Add more specific error message on admin dashboard in the event that the WordPress server is not able to
    reach fontawesome.com in order to get an initial set of available releases data.

4.0.0-rc3

  • Add missing v3 shim file

4.0.0-rc2

  • Fix handling of v3 deprecation warnings in admin settings page

4.0.0-rc1

  • Add admin settings page
  • Lots of back end code changes to support theme and plugin developers
    • Package plugin as a composer dependency
    • API Changes
    • Comprehensive API documentation for developers
  • Cache load specification unless client requirements change
  • Handle changing configurations as new plugins or themes are activated, de-activated or updated
  • Lock working load specifications and only rebuild when new requirements are conflict-free
  • Load Font Awesome release version metadata from the fontawesome.com releases API

3.2.1

  • Last stable version of the old plugin