SCFA
Shortcodes for Font Awesome (SCFA) is a WordPress plugin to generate inline HTML with Font Awesome 6 icon libray.
Description
SCFA generates inline HTML for Font Awesome icons. The WordPress slug is shortcodes-for-font-awesome.
The plugin is also available on wordpress.org
A few notes about this plugin:
- You may choose to host your Font Awesome files 6 locally (default)
- You may choose to use the Font Awesome CDN
- You may choose to specify a custom URL for your Font Awesome files
- You may choose to disable Font Awesome assets if you include them elsewhere
- This plugin may create entries in your PHP error log (if active)
- This plugin contains no tracking code and does not process or collect any information about the visitor
- Tested with WordPress 5.5-6.4
- Tested with PHP 7.2 and PHP 8
Installation
This section describes how to install the plugin and get it working.
- Upload the contents of the
shortcodes-for-font-awesomefolder to the/wp-content/plugins/directory - Activate the plugin through the 'Plugins' menu in WordPress
- Configure accordingly
Configuration
Decide if you want to use the included Font Awesome assets, they are the time of this writing at version 5.2.4. If you want to use another version, you can replace the included assets, use another URL for the CSS and webfont assets, or specify a Font Awesome CDN kit URL.
Usage
There is one shortcode available with this plugin:
[scfa][/scfa]
General format
This is intended as a quick reference for the shortcode. For a complete list of Font Awesome classes, please see fontawesome.com. Some icon styles may only be available with a Pro license. You can (obviously) specify everything class related in the class="" parameter if that is more convenient for you.
Generate element with icon and default (icon) style:
[scfa icon="address-book"][/scfa]
Generate element with the specified style and icon:
[scfa icon="far address-book"][/scfa]
Generate element with the specified style and icon and size:
[scfa icon="far address-book" size="5x"][/scfa]
There are more examples in the SCFA plugin settings screen.
Frequently Asked Questions
How to I make local customizations
You can replace all of the Font Awesome files in the css/fontawesome/ sub-directory with an updated version of Font Awesome. Please note that the webfonts from Font Awesome go into the css/webfonts/ sub-directory.
Changelog
1.4.0
- Upgraded to FontAwesome 6.4
- Tested plugin with WordPress 6.4.1
1.3.0
- Upgraded to FontAwesome 6.0
- Tested plugin with WordPress 5.9
- Minor i18n (translation) correction
- Minor cosmetic correction
- Added support for "Thin" icons (fat, fa-thin)
- Added support for alternate (new) V6 type names (fa-solid, fa-regular, fa-light, fa-duotone, fa-thin, fa-brands
1.2.1
- Upgraded to FontAwesome 5.15.3
- Tested plugin with WordPress 5.8
- Minor i18n (translation) correction
- Minor cosmetic correction
1.2.0
- Upgraded to FontAwesome 5.15.2
- Tested plugin with WordPress 5.7
- Removed BoilerPlate
1.1.0
- Upgraded to FontAwesome 5.15.1
- Tested with PHP 7.4
- Tested plugin with WordPress 5.6
1.0.0
- Initial release
Upgrade Notice
1.3.0
- Simply update the plugin via wordpress.org or download and install as per the installation instructions above.
- The .eot, .svg, and .woff files in the /css/webfonts/ directory of the plugin are not used by Font Awesome 6 and can be removed.
1.2.1
- Simply update the plugin via wordpress.org or download and install as per the installation instructions above.
1.2.0
- Simply update the plugin via wordpress.org or download and install as per the installation instructions above.
1.1.0
- Simply update the plugin via wordpress.org or download and install as per the installation instructions above.
1.0.0
- Initial release
License
Please see LICENSE for a full copy of GPLv2
Copyright (C) 2020, 2021, 2022 Joaquim Homrighausen.
This file is part of Shortcodes for Font Awesome (SCFA). Shortcodes for Font Awesome is free software.
You may redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation.
Shortcodes for Font Awesome 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 the SCFA package. If not, write to:
The Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301, USA.
Credits
The Shortcodes for Font Awesome (SCFA) WordPress Plugin was written by Joaquim Homrighausen while converting ☕ into code.
SCFA is sponsored by WebbPlatsen i Sverige AB, Stockholm, 🇸🇪
Commercial support and customizations for this plugin is available from WebbPlatsen i Sverige AB in Stockholm, 🇸🇪
This plugin can also be downloaded from code.webbplatsen.net and WordPress.org
External references
These links are not here for any sort of endorsement or marketing, they're purely for informational purposes.
- me; 🐒 https://joho.se and https://github.com/joho1968
- WebbPlatsen; https://webbplatsen.se and https://code.webbplatsen.net
- Font Awesome for their awesome icons!
Stay safe!