説明
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.
インストール
- 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.
評価
このプラグインにはレビューがありません。
貢献者と開発者
“Mosne Button Icons” をあなたの言語に翻訳しましょう。
開発に興味がありますか ?
変更履歴
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.