Description
View on GitHub for better documentation
FA WP Admin Menu Icons allows you to use Font Awesome icons for WordPress custom post types and custom menu pages by passing the Font Awesome class string, just like using Font Awesome on the front end
Here’s an example:
register_post_type( 'custom_post_type', [
//...
'menu_icon' => 'fa-solid fa-thumbs-up',
//...
] );
Usage
`register_post_type()`
To use a Font Awesome icon for your custom post type with register_post_type()
, use a Font Awesome class string for the $args['menu_icon]
parameter:
register_post_type( 'custom_post_type', [
//...
'menu_icon' => 'fa-solid fa-thumbs-up',
//...
] );
`add_menu_page()`
To use a Font Awesome icon for your custom menu page with add_menu_page()
, use a Font Awesome class string for the $icon_url
parameter:
add_menu_page(
page_title: 'Custom Menu Page',
menu_title: 'Custom Menu Page',
capability: 'manage_options',
menu_slug: 'custom_menu_page',
icon_url: 'fa-solid fa-thumbs-up',
);
Custom Post Type UI plugin
To use a Font Awesome icon with the Custom Post Type UI plugin, use a Font Awesome class string for the Menu Icon field when adding or editing a Post Type
Caveats
FA WP Admin Menu Icons only supports Font Awesome’s free icons
Screenshots
Installation
WordPress Admin Dashboard
In your WordPress Admin Dashboard, go to Plugins > Add New, search for ‘fa wp admin menu icons’, then click Install Now
Read more about automatic plugin installation with the WordPress Admin Dashboard
WP-CLI
Install with WP-CLI by running the following command:
wp plugin install fa-wp-admin-menu-icons --activate
Install with Composer
- Follow the setup instructions for WordPress Packagist
- Require
wpackagist-plugin/fa-wp-admin-menu-icons
Install with Git
Install with Git by running the following commands:
cd <wp-content>/plugins
git clone git@github.com:patrik-csak/fa-wp-admin-menu-icons.git
Reviews
Contributors & Developers
“FA WP Admin Menu Icons” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “FA WP Admin Menu Icons” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Change log
8.4.0
Changed
- Upgrade Font Awesome from v6.5.2 to v6.6.0
8.3.0
Changed
- Upgrade Font Awesome from v6.5.1 to v6.5.2
8.2.0
Changed
- Decreased icon size to be more similar to Dashicons
8.1.1
Changed
- Require PHP v8.1 in readme.txt
8.1.0
Changed
- Upgrade Font Awesome from v6.5.0 to v6.5.1
8.0.0
Changed
- Upgrade Font Awesome from v6.4.0 to v6.5.0
- Require PHP v8.1+
7.2.0
Changed
- Upgrade Font Awesome to v6.4.0
7.1.0
Changed
- Upgrade Font Awesome to v6.3.0
7.0.0
Changed
- Require PHP v8.0+
Removed
- Support for Font Awesome v4 icons
Fawpami\\faVersion
filter
6.0.0
Changed
- Require PHP v7.4+
- Test with WordPress v5.9
5.0.1
Changed
- Upgrade Font Awesome to v5.15.4
- Test with WordPress v5.8.1
5.0.0
Changed
- Upgrade Font Awesome to v5.15.1
- Test with WordPress v5.5.3
- Drop support for PHP v7.2
4.1.0
Changed
- Test with WordPress v5.2.1
- Upgrade Font Awesome to v5.13.0
4.0.0
Removed
- Support for EOL PHP versions
3.9.1
Added
- Restore support for EOL PHP versions because it’s a breaking change
3.9.0
Changed
- Upgrade Font Awesome to v5.12.1
Removed
- Support for EOL PHP versions
3.8.0
Changed
- Update Font Awesome from v5.9.0 to v5.11.2
3.7.0
Added
- Test with WordPress v5.2.1
- Add support for PHP v7.3
Changed
- Update Font Awesome from v5.6.0 to v5.9.0
3.6.0
Changed
- Update Font Awesome from v5.5.0 to v5.6.0
3.5.0
Changed
- Update Font Awesome from v5.4.2 to v5.5.0
3.4.0
Changed
- Update Font Awesome from v5.4.1 to v5.4.2
3.3.0
Changed
- Update Font Awesome from v5.3.1 to v5.4.1
3.2.0
Changed
- Update Font Awesome from v5.2.0 to v5.3.1
3.1.0
Changed
- Update Font Awesome from v5.1.0 to v5.2.0
3.0.0
Changed
- Initialize the plugin earlier in the WP lifecycle
2.8.0
Added
- Tested with WordPress v4.9.6
Changed
- Update Font Awesome from v5.0.13 to v5.1.0
2.7.0
Changed
- Update Font Awesome from v5.0.12 to v5.0.13
2.6.0
Changed
- Update Font Awesome from v5.0.11 to v5.0.12
2.5.0
Changed
- Update Font Awesome from v5.0.10 to v5.0.11
2.4.0
Changed
- Update Font Awesome from v5.0.9 to v5.0.10
2.3.1
Changed
- Update README.txt changelog
2.3.0
Changed
- Bump Font Awesome version from 5.0.8 to 5.0.9
2.2.1
Fixed
- Fix styles action
2.2.0
Added
- Add support for Font Awesome versions. Icons are now cached with their Font Awesome version so they can be updated when the Font Awesome version changes.
2.1.0
Added
- Add links to changelog
- Add links to readme badges
- Integrate Travis and Code Climate test coverage
Changed
- Instead of storing all icons in the plugin, get them remotely, as needed, and cache them in the database for future use
- Make hooks code DRYer
- Stop using static methods, to make testing easier
- Make icons smaller so they look better next to Dashicons
- Update Font Awesome shims
2.0.1
Added
- Add CC BY 4.0 attribution in
icons/README.md
to adhere to Font Awesome license
Fixed
- Fix old syntax in readme examples
- Add missing ‘Usage’ section to
README.txt
2.0.0
Added
- Add unit tests
Changed
- Upgrade to Font Awesome 5 icons and class syntax
- Use PSR instead of WordPress for code style
Deprecated
- Deprecate use of Font Awesome 4 class syntax
1.0.4
Changed
- Format code
Removed
- Remove caveat from documentation because it no longer applies
1.0.3
Added
- Add more icons
1.0.2
Fixed
- Fix undefined index
1.0.1
Fixed
- Add icons to
icons/
. The directory was empty on the WordPress plugin repository.