PHPackages                             apiki/carbon-field-icon - 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 &amp; Helpers](/categories/utility)
4. /
5. apiki/carbon-field-icon

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

apiki/carbon-field-icon
=======================

Carbon Fields extension, that adds a Icon field type.

v3.1.1(5y ago)11.8k—0%[5 PRs](https://github.com/Apiki/carbon-field-icon/pulls)GPL-2.0+JavaScript

Since Dec 23Pushed 2y agoCompare

[ Source](https://github.com/Apiki/carbon-field-icon)[ Packagist](https://packagist.org/packages/apiki/carbon-field-icon)[ RSS](/packages/apiki-carbon-field-icon/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (1)Versions (16)Used By (0)

Carbon Field Icon
=================

[](#carbon-field-icon)

[![Packagist](https://camo.githubusercontent.com/34d8cd1d38b7ccebdf61bbde5f272e31f03dbf4394fec82ed028f51906941f8f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f767072652f68746d6c6275726765722f636172626f6e2d6669656c642d69636f6e2e7376673f7374796c653d666c61742d73717561726526636f6c6f72423d303336366436)](https://packagist.org/packages/htmlburger/carbon-field-icon)

Provides the ability to select an icon or a glyph.

Supported glyphs
----------------

[](#supported-glyphs)

- Font Awesome (v5.8.1)
- Dashicons
- Custom

Usage
-----

[](#usage)

Font Awesome only (default):

```
Field::make( 'icon', 'social_site_icon', __( 'Icon', 'crb' ) ),
```

Dashicons only:

```
Field::make( 'icon', 'social_site_icon', __( 'Icon', 'crb' ) )
	->add_dashicons_options(),
```

Dashicons and Font Awesome:

```
Field::make( 'icon', 'social_site_icon', __( 'Icon', 'crb' ) )
	->add_dashicons_options()
	->add_fontawesome_options(),
```

Custom icon list:

```
Field::make( 'icon', 'social_site_icon', __( 'Icon', 'crb' ) )
	->set_options( array(
		// Minimal settings:
		'my-custom-icon-1' => array(
			'name' => __( 'My Custom Icon 1' ),
			'icon' => get_template_directory() . '/icons/my-custom-icon-1.svg',
		),

		// Full settings:
		'my-custom-icon-2' => array(
			'name'         => __( 'My Custom Icon 2' ),
			'icon'         => get_template_directory() . '/icons/my-custom-icon-2.svg',
			'id'           => 'my-custom-icon-2',
			'class'        => 'my-custom-prefix-class',
			'search_terms' => array( 'shop', 'checkout', 'product' ),
		),
	) ),
```

Custom icon list (using providers):

```
class Custom_Icon_Provider implements Carbon_Field_Icon\Providers\Icon_Provider_Interface {
	public function parse_options() {
		return array(
			// Minimal settings:
			'custom-icon-1' => array(
				'name' => __( 'Custom Icon 1' ),
				'icon' => get_template_directory() . '/icons/custom-icon-1.svg',
			),

			// Full settings:
			'custom-icon-2' => array(
				'name'         => __( 'Custom Icon 2' ),
				'icon'         => get_template_directory() . '/icons/custom-icon-2.svg',
				'id'           => 'custom-icon-2',
				'class'        => 'custom-prefix-class',
				'search_terms' => array( 'shop', 'checkout', 'product' ),
			),
		);
	}
}

add_action( 'carbon_fields_icon_field_loaded', 'crb_register_custom_icon_field_provider' );
function crb_register_custom_icon_field_provider() {
	$provider_id = 'custom';

	\Carbon_Fields\Carbon_Fields::instance()->ioc['icon_field_providers'][ $provider_id ] = function( $container ) {
		return new Custom_Icon_Provider();
	};

	\Carbon_Field_Icon\Icon_Field::add_provider( [ $provider_id ] );
}

Container::make( 'theme_options', __( 'Theme Options', 'crb' ) )
	->set_page_file( 'crbn-theme-options.php' )
	->add_fields( array(
		Field::make( 'icon', 'crb_custom_icon', __( 'Choose Custom Icon', 'crb' ) )
			->add_provider_options( 'custom' ),
	) );
```

###  Health Score

34

—

LowBetter than 79% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity19

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 63.2% 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

Every ~152 days

Recently: every ~210 days

Total

9

Last Release

2157d ago

Major Versions

v1.0.2 → 2.0.02017-08-02

2.2.0 → v3.0.02019-04-24

### Community

Maintainers

![](https://www.gravatar.com/avatar/ef81bb06c1f02fc40dae243c432b2271a2ca654de450f7c43a727727549c1daf?d=identicon)[elvishp2006](/maintainers/elvishp2006)

---

Top Contributors

[![jorostoyanov](https://avatars.githubusercontent.com/u/6777091?v=4)](https://github.com/jorostoyanov "jorostoyanov (36 commits)")[![atanas-dev](https://avatars.githubusercontent.com/u/22746396?v=4)](https://github.com/atanas-dev "atanas-dev (17 commits)")[![elvishp2006](https://avatars.githubusercontent.com/u/7463100?v=4)](https://github.com/elvishp2006 "elvishp2006 (2 commits)")[![yuliyan](https://avatars.githubusercontent.com/u/2722412?v=4)](https://github.com/yuliyan "yuliyan (2 commits)")

---

Tags

wordpresscarbon-fieldcarbon-field-icon

### Embed Badge

![Health badge](/badges/apiki-carbon-field-icon/health.svg)

```
[![Health](https://phpackages.com/badges/apiki-carbon-field-icon/health.svg)](https://phpackages.com/packages/apiki-carbon-field-icon)
```

###  Alternatives

[aristath/kirki

Extending the WordPress customizer

1.3k73.0k4](/packages/aristath-kirki)[afragen/git-updater

A plugin to automatically update GitHub, Bitbucket, GitLab, or Gitea hosted plugins, themes, and language packs.

3.3k1.5k](/packages/afragen-git-updater)[iamntz/carbon-fields-urlpicker

Carbon Fields extension that adds a URL picker field type.

1437.7k](/packages/iamntz-carbon-fields-urlpicker)[htmlburger/carbon-field-icon

Carbon Fields extension, that adds a Icon field type.

208.5k](/packages/htmlburger-carbon-field-icon)

PHPackages © 2026

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