# gutenberg/trunk/lib/icons.php

Gutenberg, version trunk. 100 lines.

- Page: https://pluginprobe.com/plugins/gutenberg/trunk/code/lib/icons.php
- Raw: https://pluginprobe.com/plugins/gutenberg/trunk/raw/lib/icons.php
- Modified: 2026-09-30T09:29:30+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/gutenberg/trunk/code/lib/icons.php#L10-L20`.

```php
<?php
/**
 * Icons API: registration of the core icon collections and their icons from the
 * plugin's own `packages/icons` manifest, replacing the core registration.
 *
 * @package gutenberg
 */

/**
 * Registers the default icon collections for Gutenberg.
 */
function gutenberg_register_default_icon_collections() {
	wp_register_icon_collection(
		'core',
		array(
			'label'       => __( 'WordPress', 'gutenberg' ),
			'description' => __( 'Core icon collection.', 'gutenberg' ),
		)
	);
	wp_register_icon_collection(
		'core-admin',
		array(
			'label'       => __( 'WordPress Admin', 'gutenberg' ),
			'description' => __( 'Icon collection used by the WordPress admin interface.', 'gutenberg' ),
			'public'      => false,
		)
	);
}

$default_icon_collections_priority = has_action( 'init', '_wp_register_default_icon_collections' );
if ( false !== $default_icon_collections_priority ) {
	remove_action( 'init', '_wp_register_default_icon_collections', $default_icon_collections_priority );
}
add_action( 'init', 'gutenberg_register_default_icon_collections', 0 );

/**
 * Registers the default core and core-admin icons from the Gutenberg manifest.
 */
function gutenberg_register_default_icons() {
	$icons_directory = gutenberg_dir_path() . 'packages/icons/src';
	$icons_directory = trailingslashit( $icons_directory );
	$manifest_path   = $icons_directory . 'manifest.php';

	if ( ! is_readable( $manifest_path ) ) {
		wp_trigger_error(
			__FUNCTION__,
			__( 'Core icon collection manifest is missing or unreadable.', 'gutenberg' )
		);
		return;
	}

	$collection = include $manifest_path;

	if ( empty( $collection ) ) {
		wp_trigger_error(
			__FUNCTION__,
			__( 'Core icon collection manifest is empty or invalid.', 'gutenberg' )
		);
		return;
	}

	foreach ( $collection as $icon_name => $icon_data ) {
		if (
			empty( $icon_data['filePath'] )
			|| ! is_string( $icon_data['filePath'] )
		) {
			_doing_it_wrong(
				__FUNCTION__,
				__( 'Core icon collection manifest must provide a valid "filePath" for each icon.', 'gutenberg' ),
				'7.1.0'
			);
			return;
		}

		if ( empty( $icon_data['collections'] ) || ! is_array( $icon_data['collections'] ) ) {
			_doing_it_wrong(
				__FUNCTION__,
				__( 'Core icon collection manifest must provide a non-empty "collections" array for each icon.', 'gutenberg' ),
				'7.2.0'
			);
			return;
		}

		$icon_args = array(
			'label'     => $icon_data['label'],
			'file_path' => $icons_directory . $icon_data['filePath'],
		);

		foreach ( $icon_data['collections'] as $collection_slug ) {
			wp_register_icon( $collection_slug . '/' . $icon_name, $icon_args );
		}
	}
}

$default_icons_priority = has_action( 'init', '_wp_register_default_icons' );
if ( false !== $default_icons_priority ) {
	remove_action( 'init', '_wp_register_default_icons', $default_icons_priority );
}
add_action( 'init', 'gutenberg_register_default_icons' );

```