A native WordPress Icon block using an enabled Heroicons icon.<\\\/p>' . PHP_EOL . '' . PHP_EOL . PHP_EOL . ''; $post_id = wp_insert_post( array( 'post_title' => 'Aculect Icon Library demo', 'post_status' => 'publish', 'post_type' => 'page', 'post_content' => $post_content ), true ); if ( is_wp_error( $post_id ) || ! $post_id ) { throw new RuntimeException( is_wp_error( $post_id ) ? $post_id->get_error_message() : 'The Aculect Icon Library demo page could not be created.' ); } ?>\"}]}"}},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.1.0","1.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3695335,"resolution":"1","location":"assets","locale":"","width":2112,"height":745},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3695335,"resolution":"2","location":"assets","locale":"","width":2058,"height":764},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3695335,"resolution":"3","location":"assets","locale":"","width":1491,"height":1055}},"screenshots":{"1":"View bundled icon libraries and their active variants from Appearance > Icons.","2":"Search and filter bundled icons by library, variant, and category.","3":"Upload custom SVG icons, search uploaded icons, rename labels, and delete icons."}},"plugin_section":[],"plugin_tags":[3688,264365,178481,498,150599],"plugin_category":[50],"plugin_contributors":[133258,147734],"plugin_business_model":[],"class_list":["post-366877","plugin","type-plugin","status-publish","hentry","plugin_tags-custom-icons","plugin_tags-icon-library","plugin_tags-icon-block","plugin_tags-icons","plugin_tags-svg-icons","plugin_category-media","plugin_contributors-alkesh7","plugin_contributors-mehul0810","plugin_committers-mehul0810"],"banners":{"banner":"https:\/\/ps.w.org\/aculect-icon-library\/assets\/banner-772x250.png?rev=3695335","banner_2x":"https:\/\/ps.w.org\/aculect-icon-library\/assets\/banner-1544x500.png?rev=3695335","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/aculect-icon-library\/assets\/icon.svg?rev=3695335","icon":"https:\/\/ps.w.org\/aculect-icon-library\/assets\/icon.svg?rev=3695335","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/aculect-icon-library\/assets\/screenshot-1.png?rev=3695335","caption":"View bundled icon libraries and their active variants from Appearance > Icons."},{"src":"https:\/\/ps.w.org\/aculect-icon-library\/assets\/screenshot-2.png?rev=3695335","caption":"Search and filter bundled icons by library, variant, and category."},{"src":"https:\/\/ps.w.org\/aculect-icon-library\/assets\/screenshot-3.png?rev=3695335","caption":"Upload custom SVG icons, search uploaded icons, rename labels, and delete icons."}],"raw_content":"\n
Aculect Icon Library is a WordPress plugin that adds Heroicons, Bootstrap Icons,\nFont Awesome Free, Tabler Icons, Radix Icons, Rune Icons, Google Material Icons,\na compatible Iconoir Solid subset, Phosphor Icons, Ionicons, and custom SVG icons to the native WordPress\nIcon block. Choose bundled libraries from Appearance > Icons > Install Library, enable the styles you need in Library,\nand select icons in the WordPress block editor.<\/p>\n\n
Choose bundled libraries from Appearance > Icons > Install Library and enable them in Library. The 1.2.0 package includes all ten supported icon families and their\nlicense and exclusion notices. Existing sites retain their bundled libraries,\npreferences and saved icon names through an ordinary plugin update. No bridge\npackage or separate preservation stage is required. Remote discovery, preview,\nand downloaded-library installation are not part of this release.<\/p>\n\n
Preview bundled icons by library, variant, and category before choosing a library. Search and filter selected bundled icons where\navailable, and load more results as you browse. Enable or disable individual\nvariants as needed.<\/p>\n\n
Upload custom SVG files through the Upload tab, give them recognizable labels,\nand use them alongside library icons in the native Icon block. Rename labels\nor delete custom icons from the uploaded icons list.<\/p>\n\n
SVG uploads are validated before storage and are limited to supported SVG\nelements and attributes. Custom icons are managed by the plugin and do not\nenable SVG uploads in the WordPress Media Library.<\/p>\n\n
Enabled icons appear in the existing Icon block picker, where you can use the\nblock's own sizing and styling controls. Aculect Icon Library extends this\nworkflow without adding a separate icon block or using icon fonts.<\/p>\n\n
Included libraries and uploaded icons are stored locally. No external service\nconnection is required to browse or use them.<\/p>\n\n
The WordPress Abilities API integration lets compatible AI agents and tools\nsearch enabled icons and insert, replace, or remove Icon blocks. Actions respect\nWordPress permissions, including permission to edit the target post.<\/p>\n\n
Requires WordPress 7.1 or later and PHP 7.4 or later.<\/p>\n\n
Source and build tools: https:\/\/github.com\/mehul0810\/aculect-icon-library<\/p>\n\n
The editable DataViews source is assets\/src\/custom-icons-dataviews.js.\nTo rebuild assets\/build\/custom-icons-dataviews.js, run npm ci followed by\nnpm run build from the repository root. Dependencies and their exact versions\nare recorded in package.json and package-lock.json.<\/p>\n\n
Bundled libraries remain under their upstream terms:<\/p>\n\n
wp-content\/plugins\/aculect-icon-library<\/code> directory.<\/li>\n- Activate Aculect Icon Library in WordPress.<\/li>\n
- Open Appearance > Icons > Install Library and choose a bundled library. Then enable it in Library.<\/li>\n
- Open a post or page in the block editor, insert the Icon block, and select\nan icon from the enabled library. Adjust its sizing and styling, then save.<\/li>\n<\/ol>\n\n\n
\nWhich icon libraries are included?<\/h3><\/dt>\nHeroicons includes Outline and Solid. Bootstrap Icons includes Default and\nFilled. Font Awesome Free includes Solid, Regular, and Brands; Pro-only styles\nare not included. Tabler Icons includes 1,012 Filled icons after excluding its\nBrand category and selected trademark or character references. Radix Icons\nincludes its non-logo 15-pixel icon collection. Google Material Icons includes\na Core-compatible Filled 24px subset. Iconoir includes 210 compatible Solid\nicons; Regular and mixed-stroke icons are deferred. Rune Icons includes 215\npixelated icons. Phosphor Icons includes Regular and Fill. Ionicons includes\ncompatible Filled, Sharp, Outline, and Brands icons; unsupported assets are\nrecorded in the bundled exclusion report. Libraries are disabled by default.<\/p><\/dd>\n
How do I add an icon to a WordPress post or page?<\/h3><\/dt>\nEnable a bundled library or variant from Appearance > Icons, then insert the\nnative Icon block in the block editor. Choose an icon from an enabled library\nand use the block's sizing and styling controls.<\/p><\/dd>\n
Does this add a custom icon block?<\/h3><\/dt>\nNo. Aculect Icon Library integrates with the native WordPress core\/icon<\/code> block.<\/p><\/dd>\nCan administrators add custom SVG icons?<\/h3><\/dt>\nYes. Administrators can add SVG files through Appearance > Icons > Upload.\nSVG files must be no larger than 64 KB and use supported SVG geometry.\nUnsupported features can cause an upload to be rejected; arbitrary SVG files\nare not supported. Use flattened paths with explicit fills for complex exports.<\/p><\/dd>\n
Does this enable SVG uploads in the Media Library?<\/h3><\/dt>\nNo. Custom SVG icons are validated and stored separately by Aculect Icon Library.\nThe plugin does not enable general SVG uploads in the WordPress Media Library.<\/p><\/dd>\n
Are icons hosted locally?<\/h3><\/dt>\nYes. Included library SVGs and uploaded custom icons are stored on your site.\nNo external service connection is required to browse or use them.<\/p><\/dd>\n
Can I enable or disable individual icon styles?<\/h3><\/dt>\nYes. Open a library's detail screen to enable or disable its variants, such as\nSolid or Outline. Disabled variants stop appearing for new selections.<\/p><\/dd>\n
What happens when I disable a bundled library or variant?<\/h3><\/dt>\nIts icons stop appearing for new selections. Existing saved Icon blocks can\nstill resolve those icons while Aculect Icon Library remains active and its\nbundled SVG files remain available. This also applies to disabled variants.<\/p><\/dd>\n
What happens when I delete a custom icon?<\/h3><\/dt>\nDeleting a custom icon permanently removes its stored SVG and metadata.\nExisting blocks that reference it can no longer resolve that icon. Replace\nthose icons in your content before deleting them. Renaming a display label\ndoes not change the icon's registered name.<\/p><\/dd>\n
What happens when I deactivate or uninstall the plugin?<\/h3><\/dt>\nThe Icon block stores the registered icon name rather than an SVG copy. Existing\npost content remains, but plugin-provided icons cannot resolve while the plugin\nis inactive. Uninstalling also removes plugin settings, custom icon files, and\ncustom icon metadata. Back up custom icons before uninstalling.<\/p><\/dd>\n
Can AI agents manage icons?<\/h3><\/dt>\nCompatible agents and tools can use the WordPress Abilities API to search enabled\nicons and list, insert, replace, or remove native Icon blocks. The plugin does\nnot include an AI assistant. Read actions require editor-style access; post\nactions require permission to edit the target post. Ability inputs do not accept\nraw SVG, filesystem paths, arbitrary block markup, or post content.<\/p><\/dd>\n
What are the requirements?<\/h3><\/dt>\nAculect Icon Library requires WordPress 7.1 or later and PHP 7.4 or later.\nIt integrates with the native WordPress Icon block, not a page-builder-specific\nicon widget.<\/p><\/dd>\n\n<\/dl>\n\n\n
1.2.0<\/h4>\n\n\n- Added support for Phosphor Icons<\/a> (Regular and Fill).<\/li>\n
- Added support for Ionicons<\/a> (compatible Filled, Sharp, Outline, and Brands subset).<\/li>\n
- Added support for Iconoir<\/a> (compatible Solid subset).<\/li>\n
- Added support for Rune Icons<\/a> (Pixelated).<\/li>\n
- Added support for Google Material Icons<\/a> (compatible Filled 24px subset).<\/li>\n
- Add Install Library to choose from ten bundled icon families, then enable their styles in Library. Removing a library preserves saved icons.<\/li>\n
- Reduce icon picker loading and load custom icon previews one page at a time.<\/li>\n
- Protect library settings and custom icons during concurrent changes, and prevent uploads from replacing archived artwork.<\/li>\n
- Prevent automated post edits from overwriting newer changes.<\/li>\n
- Improve keyboard focus during icon picker pagination and upload retries, and close upload dialogs when switching tabs.<\/li>\n
- Show clearer upload and listing errors and retain existing results when a refresh fails.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- Added support for Tabler Icons<\/a>.<\/li>\n
- Added support for Radix Icons<\/a>.<\/li>\n
- Preserve upstream categories, searchable metadata, licenses, and source revisions for both libraries.<\/li>\n
- Add deterministic importers and exclusion reports without weakening the WordPress Icon API SVG contract.<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Add a WordPress.org Playground preview Blueprint that installs the latest stable package and creates an Icon block demo.<\/li>\n
- Validate the preview package source and fail clearly when the demo page cannot be created.<\/li>\n
- Extend PHPCS coverage so
shell_exec()<\/code> usage must remain explicitly reviewed. Props Alkesh Miyani (@alkesh7<\/code>).<\/li>\n- Document the reasoning behind security, filesystem, permissions, and concurrency safeguards. Props Alkesh Miyani (
@alkesh7<\/code>).<\/li>\n- Strengthen release-package validation and release documentation for the 1.0.1 candidate.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Integrate collections with the WordPress 7.1 public Icon API.<\/li>\n
- Bundle 648 Heroicons Outline and Solid icons, 2,073 Bootstrap Icons, and 2,883 Font Awesome Free style entries with the upstream 68-category taxonomy plus a Brands grouping, separately categorized variants, and deterministic manifests. Outline is opt-in while its WordPress 7.1 Core sanitization workaround is validated.<\/li>\n
- Expose available styles separately in the native Icon picker collection filter.<\/li>\n
- Add per-variant enable and disable controls with capability-checked REST routes.<\/li>\n
- Add Appearance > Icons library management and searchable previews.<\/li>\n
- Add strict local custom SVG icon management.<\/li>\n
- Preserve saved icons when bundled libraries are disabled.<\/li>\n
- Add reproducible validation and release packaging.<\/li>\n
- Add permissioned WordPress Abilities API actions for icon discovery and core\/icon block editing.<\/li>\n<\/ul>","raw_excerpt":"Easily add support for popular icon libraries and custom SVG icons to the native WordPress Icon block","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/366877","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=366877"}],"author":[{"embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mehul0810"}],"wp:attachment":[{"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=366877"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=366877"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=366877"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=366877"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=366877"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/tzm.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=366877"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}