PHPackages                             s3rgiosan/icons-extended - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. s3rgiosan/icons-extended

ActiveWordpress-plugin[Utility & Helpers](/categories/utility)

s3rgiosan/icons-extended
========================

1.0.0(2mo ago)144GPL-3.0-or-laterPHPPHP ^8.2

Since May 20Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/s3rgiosan/icons-extended)[ Packagist](https://packagist.org/packages/s3rgiosan/icons-extended)[ GitHub Sponsors](https://github.com/s3rgiosan)[ Fund](https://ko-fi.com/s3rgiosan)[ RSS](/packages/s3rgiosan-icons-extended/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

Icons Extended
==============

[](#icons-extended)

> Extends the Icon block with custom icons and the ability to remove registered icons.

[![Try in WordPress Playground](https://camo.githubusercontent.com/0e14183f548eb9dfe684735d24fdc74446b0cd73ee1558f93f10a2ec82ceea6a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f547279253230696e2d576f72645072657373253230506c617967726f756e642d3338353845393f6c6f676f3d776f72647072657373266c6f676f436f6c6f723d7768697465)](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/s3rgiosan/icons-extended/main/.wp-playground/blueprint.json)

Register custom SVG icons against the core `core/icon` block via a stable PHP API, and remove icons (including the ones that ship with WordPress) from the registry. Changes are served through the existing Gutenberg icon picker. See [docs/icons.md](docs/icons.md) for the full guide.

> Looking for inline icons in rich-text fields? See my [Outstand Icons](https://github.com/pixelalbatross/outstand-icons) plugin.

Features
--------

[](#features)

### Custom icons

[](#custom-icons)

Register your own SVG icons against the core `core/icon` block through a stable PHP API (`s3s_register_icon()` or the `s3s_icons_registry` filter). Icons are validated at registration time and appear in any picker that consumes the registry. See [docs/icons.md](docs/icons.md) for the full guide.

### Removing icons

[](#removing-icons)

Remove icons from the registry — a single icon, or an entire namespace such as the `core/*` icons that ship with WordPress — either hard-removed or hidden from picker UIs via REST. See [docs/icons.md](docs/icons.md) for the full guide.

Installation
------------

[](#installation)

### Manual Installation

[](#manual-installation)

1. Download the latest release ZIP from the [Releases page](https://github.com/s3rgiosan/icons-extended/releases/latest).
2. Go to Plugins > Add New > Upload Plugin in your WordPress admin area.
3. Upload the ZIP file and click Install Now.
4. Activate the plugin.

### Install with Composer

[](#install-with-composer)

To include this plugin as a dependency in your Composer-managed WordPress project:

1. Add the plugin to your project using the following command:

```
composer require s3rgiosan/icons-extended
```

1. Run `composer install`.
2. Activate the plugin from your WordPress admin area or using WP-CLI.

Quick start
-----------

[](#quick-start)

1. Register an icon on `init` priority 1–4 via `s3s_register_icon( 'my-plugin/star', [ 'label' => 'Star', 'content' => '' ] )`.
2. In a post or page, insert a `core/icon` block and pick your icon from the picker.
3. Optionally remove WordPress's built-in icons with `s3s_unregister_icons_namespace( 'core' )` on `init` priority 6.

Requirements
------------

[](#requirements)

- WordPress 7.0 or higher
- PHP 8.2 or higher

### Tests

[](#tests)

PHP tests run inside a `wp-env` container:

```
npm run test:setup   # first time only — starts Docker WP + test DB
npm run test:unit
```

Changelog
---------

[](#changelog)

All notable changes to this project are documented in [CHANGELOG.md](https://github.com/s3rgiosan/icons-extended/blob/main/CHANGELOG.md).

License
-------

[](#license)

This project is licensed under the [GPL-3.0-or-later](https://spdx.org/licenses/GPL-3.0-or-later.html).

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance87

Actively maintained with recent releases

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

65d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/42eed63db46bd6dc4df88e37095ad4f8aeacfcc63f68e7e11c637eb9ec18a652?d=identicon)[s3rgiosan](/maintainers/s3rgiosan)

---

Top Contributors

[![s3rgiosan](https://avatars.githubusercontent.com/u/499982?v=4)](https://github.com/s3rgiosan "s3rgiosan (1 commits)")

---

Tags

block-editorgutenbergwordpresswordpress-plugin

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/s3rgiosan-icons-extended/health.svg)

```
[![Health](https://phpackages.com/badges/s3rgiosan-icons-extended/health.svg)](https://phpackages.com/packages/s3rgiosan-icons-extended)
```

###  Alternatives

[10up/10up-experience

The 10up Experience plugin configures WordPress to better protect and inform clients, aligned to 10up's best practices

139507.8k](/packages/10up-10up-experience)[folbert/fewbricks

Write code to create fields and more for Advanced Custom Fields

1196.0k](/packages/folbert-fewbricks)[davidanderson684/simba-plugin-manager-updater

This class is an updates checker and UI for WordPress plugins that are hosted using the Simba Plugin Manager plugin

2753.9k](/packages/davidanderson684-simba-plugin-manager-updater)[pixelalbatross/slider-block

132.3k](/packages/pixelalbatross-slider-block)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)