WP_Icons_Registry

15class WP_Icons_Registry {16	/**17	 * Registered icons array.18	 *19	 * @var array[]20	 */21	protected $registered_icons = array();22 23 24	/**25	 * Container for the main instance of the class.26	 *27	 * @var WP_Icons_Registry|null28	 */29	protected static $instance = null;30 31	/**32	 * Constructor.33	 *34	 * WP_Icons_Registry is a singleton class, so keep this protected.35	 *36	 * For 7.0, the Icons Registry is closed for third-party icon registry,37	 * serving only a subset of core icons.38	 *39	 * These icons are defined in @wordpress/packages (Gutenberg repository) as40	 * SVG files and as entries in a single manifest file. On init, the41	 * registry is loaded with those icons listed in the manifest.42	 */43	protected function __construct() {44		$icons_directory = __DIR__ . '/images/icon-library/';45		$manifest_path   = __DIR__ . '/assets/icon-library-manifest.php';46 47		if ( ! is_readable( $manifest_path ) ) {48			wp_trigger_error(49				__METHOD__,50				__( 'Core icon collection manifest is missing or unreadable.' )51			);52			return;53		}54 55		$collection = include $manifest_path;56 57		if ( empty( $collection ) ) {58			wp_trigger_error(59				__METHOD__,60				__( 'Core icon collection manifest is empty or invalid.' )61			);62			return;63		}64 65		foreach ( $collection as $icon_name => $icon_data ) {66			if (67				empty( $icon_data['filePath'] )68				|| ! is_string( $icon_data['filePath'] )69			) {70				_doing_it_wrong(71					__METHOD__,72					__( 'Core icon collection manifest must provide valid a "filePath" for each icon.' ),73					'7.0.0'74				);75				return;76			}77 78			$this->register(79				'core/' . $icon_name,80				array(81					'label'    => $icon_data['label'],82					'filePath' => $icons_directory . $icon_data['filePath'],83				)84			);85		}86	}87 88	/**89	 * Registers an icon.90	 *91	 * @param string $icon_name       Icon name including namespace.92	 * @param array  $icon_properties {93	 *     List of properties for the icon.94	 *