WP_Icon_Collections_Registry

18class WP_Icon_Collections_Registry {19 20	/**21	 * Registered icon collections array.22	 *23	 * @since 7.1.024	 * @var array[]25	 */26	protected $registered_collections = array();27 28	/**29	 * Container for the main instance of the class.30	 *31	 * @since 7.1.032	 * @var WP_Icon_Collections_Registry|null33	 */34	protected static $instance = null;35 36	/**37	 * Registers an icon collection.38	 *39	 * @since 7.1.040	 *41	 * @param string $collection_slug       Icon collection slug.42	 * @param array  $collection_properties {43	 *     List of properties for the icon collection.44	 *45	 *     @type string $label       Required. A human-readable label for the icon collection.46	 *     @type string $description Optional. A human-readable description for the icon collection.47	 * }48	 * @return bool True if the collection was registered successfully, false otherwise.49	 */50	public function register( $collection_slug, $collection_properties ) {51		if ( ! isset( $collection_slug ) || ! is_string( $collection_slug ) ) {52			_doing_it_wrong(53				__METHOD__,54				__( 'Icon collection slug must be a string.' ),55				'7.1.0'56			);57			return false;58		}59 60		if ( ! preg_match( '/^[a-z0-9]([a-z0-9_-]*[a-z0-9])?$/', $collection_slug ) ) {61			_doing_it_wrong(62				__METHOD__,63				__( 'Icon collection slug must start and end with a lowercase letter or digit and contain only lowercase letters, digits, hyphens, and underscores.' ),64				'7.1.0'65			);66			return false;67		}68 69		if ( $this->is_registered( $collection_slug ) ) {70			_doing_it_wrong(71				__METHOD__,72				__( 'Icon collection is already registered.' ),73				'7.1.0'74			);75			return false;76		}77 78		if ( ! is_array( $collection_properties ) ) {79			_doing_it_wrong(80				__METHOD__,81				__( 'Icon collection properties must be an array.' ),82				'7.1.0'83			);84			return false;85		}86 87		$allowed_keys = array_fill_keys( array( 'label', 'description' ), 1 );88		foreach ( array_keys( $collection_properties ) as $key ) {89			if ( ! array_key_exists( $key, $allowed_keys ) ) {90				_doing_it_wrong(91					__METHOD__,92					sprintf(93						/* translators: %s: The name of a user-provided key. */94						__( 'Invalid icon collection property: "%s".' ),95						$key96					),97					'7.1.0'