توضیحات
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.
سوالات متداول
-
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” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کردهاند.
مشارکت کنندگانترجمه “Mosne Button Icons” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
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.