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. s3rgiosan/icons-extended

ActiveWordpress-plugin

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

1.0.0(2w ago)18GPL-3.0-or-laterPHPPHP ^8.2

Since May 20Pushed 2w 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 1w 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.

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

Maintenance96

Actively maintained with recent releases

Popularity8

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

20d 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

139498.5k](/packages/10up-10up-experience)[harness-software/wp-graphql-gravity-forms

Adds WPGraphQL support for Gravity Forms

17189.7k](/packages/harness-software-wp-graphql-gravity-forms)[blockstudio/blockstudio

The block framework for WordPress.

531.2k](/packages/blockstudio-blockstudio)[folbert/fewbricks

Write code to create fields and more for Advanced Custom Fields

1216.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.4k](/packages/davidanderson684-simba-plugin-manager-updater)[creuna-fi/color-space-fixer

Convert Adobe RGB / CMYK images to sRGB on upload. Requires ImageMagick built with lcms2 delegate.

173.4k](/packages/creuna-fi-color-space-fixer)

PHPackages © 2026

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