WP_Font_Collection

19final class WP_Font_Collection {20	/**21	 * The unique slug for the font collection.22	 *23	 * @since 6.5.024	 * @var string25	 */26	public $slug;27 28	/**29	 * Font collection data.30	 *31	 * @since 6.5.032	 * @var array|WP_Error|null33	 */34	private $data;35 36	/**37	 * Font collection JSON file path or URL.38	 *39	 * @since 6.5.040	 * @var string|null41	 */42	private $src;43 44	/**45	 * WP_Font_Collection constructor.46	 *47	 * @since 6.5.048	 *49	 * @param string $slug Font collection slug. May only contain alphanumeric characters, dashes,50	 *                     and underscores. See sanitize_title().51	 * @param array  $args Font collection data. See wp_register_font_collection() for information on accepted arguments.52	 */53	public function __construct( string $slug, array $args ) {54		$this->slug = sanitize_title( $slug );55		if ( $this->slug !== $slug ) {56			_doing_it_wrong(57				__METHOD__,58				/* translators: %s: Font collection slug. */59				sprintf( __( 'Font collection slug "%s" is not valid. Slugs must use only alphanumeric characters, dashes, and underscores.' ), $slug ),60				'6.5.0'61			);62		}63 64		$required_properties = array( 'name', 'font_families' );65 66		if ( isset( $args['font_families'] ) && is_string( $args['font_families'] ) ) {67			// JSON data is lazy loaded by ::get_data().68			$this->src = $args['font_families'];69			unset( $args['font_families'] );70 71			$required_properties = array( 'name' );72		}73 74		$this->data = $this->sanitize_and_validate_data( $args, $required_properties );75	}76 77	/**78	 * Retrieves the font collection data.79	 *80	 * @since 6.5.081	 *82	 * @return array|WP_Error An array containing the font collection data, or a WP_Error on failure.83	 */84	public function get_data() {85		if ( is_wp_error( $this->data ) ) {86			return $this->data;87		}88 89		// If the collection uses JSON data, load it and cache the data/error.90		if ( isset( $this->src ) ) {91			$this->data = $this->load_from_json( $this->src );92		}93 94		if ( is_wp_error( $this->data ) ) {95			return $this->data;96		}97 98		// Set defaults for optional properties.