WP_Icons_Registry

14class WP_Icons_Registry {15	/**16	 * Registered icons array.17	 *18	 * @since 7.0.019	 * @var array[]20	 */21	protected $registered_icons = array();22 23	/**24	 * Container for the main instance of the class.25	 *26	 * @since 7.0.027	 * @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	 * Icons are populated via `_wp_register_default_icons()` during the37	 * `init` action. Third-party icons can be registered via38	 * {@see wp_register_icon()} once their collection is registered.39	 *40	 * @since 7.0.041	 */42	protected function __construct() {}43 44	/**45	 * Registers an icon.46	 *47	 * @since 7.0.048	 * @since 7.1.0 The icon name must be namespaced in the form "collection/icon-name".49	 *50	 * @param string $icon_name       Namespaced icon name in the form "collection/icon-name"51	 *                                (e.g. "core/arrow-left").52	 * @param array  $icon_properties {53	 *     List of properties for the icon.54	 *55	 *     @type string $label     Required. A human-readable label for the icon.56	 *     @type string $content   Optional. SVG markup for the icon.57	 *                             If not provided, the content will be retrieved from the `file_path` if set.58	 *                             If both `content` and `file_path` are not set, the icon will not be registered.59	 *     @type string $file_path Optional. The full path to the file containing the icon content.60	 * }61	 * @return bool True if the icon was registered with success and false otherwise.62	 */63	public function register( $icon_name, $icon_properties ) {64		if ( ! isset( $icon_name ) || ! is_string( $icon_name ) ) {65			_doing_it_wrong(66				__METHOD__,67				__( 'Icon name must be a string.' ),68				'7.0.0'69			);70			return false;71		}72 73		// Require a namespaced name in the form "collection/icon-name".74		if ( ! str_contains( $icon_name, '/' ) ) {75			_doing_it_wrong(76				__METHOD__,77				__( 'Icon name must be namespaced in the form "collection/icon-name".' ),78				'7.1.0'79			);80			return false;81		}82 83		// Split the namespaced name into a collection slug and an unqualified icon name.84		list( $collection, $unqualified_name ) = explode( '/', $icon_name, 2 );85 86		if ( preg_match( '/[A-Z]/', $unqualified_name ) ) {87			_doing_it_wrong(88				__METHOD__,89				__( 'Icon names must not contain uppercase characters.' ),90				'7.1.0'91			);92			return false;93		}