Description
Adds an Inline icon format to the block editor toolbar. It works anywhere Rich Text allows formats (paragraphs, headings, buttons, lists, and more).
Icons come from the WordPress Icons API (the same library as the core/icon block), including collections registered by themes and plugins via wp_register_icon(). An optional Phosphor icon collection ships with the plugin and can be disabled from Settings or via a filter.
The format stores an icon name. On the front end, WordPress renders the SVG with wp_get_icon() so the icon inherits the surrounding text color.
Features
- Inline icon Rich Text format in the block editor toolbar
- Works in paragraphs, headings, buttons, and other Rich Text fields
- Uses the WordPress Icons API (
wp_get_icon,wp_register_icon) - Ships with a Phosphor icon collection under icon-collections/
- Toggle built-in collections via Settings or a filter
- Front-end SVG rendering that inherits text color
- Accessible labels via alt / aria-label (empty means decorative)
Credits
This plugin ships SVG icons from Phosphor Icons, distributed via the @phosphor-icons/core package.
Phosphor Icons is licensed under the MIT License. Copyright (c) 2023 Phosphor Icons.
Installation
- Upload the plugin files to the
/wp-content/plugins/mosne-button-iconsdirectory, or install the plugin through the WordPress plugins screen. - Activate the plugin through the ‘Plugins’ screen in WordPress.
- In the block editor, place the cursor in Rich Text and choose Inline icon from the format toolbar.
FAQ
-
Which WordPress version do I need?
-
WordPress 7.1 or later is required because the plugin relies on the Icons API.
-
Can I use icons from other collections?
-
Yes. Any collection registered with
wp_register_icon()/wp_register_icon_collection()is available in the picker. -
How do I disable a built-in collection?
-
Go to Settings Mosne Button Icons and uncheck the collection, or use the
mosne_button_icons_collection_enabledfilter in code. Collections are enabled by default. -
How do icons look on the front end?
-
Placeholders are replaced with SVG markup from
wp_get_icon(), so icons inherit the surrounding text color.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Mosne Button Icons” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Mosne Button Icons” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.2.1
- Move Phosphor icons under icon-collections/ for multiple collections.
- Add Settings page and mosne_button_icons_collection_enabled filter to disable collections.
- Cache icon file lists with a transient to avoid repeated filesystem scans.
0.2.0
- Replace custom SVG attributes with a global Rich Text format backed by the Icons API.
0.1.0
- Initial release.