Font Library

src/wp-includes/default-filters.php

@@ -735,4 +735,7 @@
 // Font management.
 add_action( 'wp_head', 'wp_print_font_faces', 50 );
 
+// Font Library.
+add_action( 'init', 'wp_register_default_font_collection' );
+
 unset( $filter, $action );

src/wp-includes/fonts.php

@@ -51,3 +51,37 @@ function wp_print_font_faces( $fonts = array() ) {
 	$wp_font_face = new WP_Font_Face();
 	$wp_font_face->generate_and_print( $fonts );
 }
+
+/**
+ * Registers a new Font Collection in the Font Library.
+ *
+ * @since 6.4.0
+ *
+ * @param string[] $config {
+ *     Font collection associative array of configuration options.
+ *
+ *     @type string $id  The font collection's unique ID.
+ *     @type string $src The font collection's data JSON file.
+ * }
+ * @return WP_Font_Collection|WP_Error A font collection is it was registered
+ *                                     successfully, else WP_Error.
+ */
+function wp_register_font_collection( $config ) {
+	return WP_Font_Library::register_font_collection( $config );
+}
+
+/**
+ * Registers the default fonts collection for the Font Library.
+ *
+ * @since 6.4.0
+ */
+function wp_register_default_font_collection() {
+	wp_register_font_collection(
+		array(
+			'id'          => 'default-font-collection',
+			'name'        => 'Google Fonts',
+			'description' => __( 'Add from Google Fonts. Fonts are copied to and served from your site.' ),
+			'src'         => 'https://s.w.org/images/fonts/16.7/collections/google-fonts-with-preview.json',
+		)
+	);
+}

src/wp-includes/fonts/class-wp-font-collection.php

@@ -0,0 +1,109 @@
+<?php
+/**
+ * Font Collection class.
+ *
+ * This file contains the Font Collection class definition.
+ *
+ * @package    WordPress
+ * @subpackage Fonts
+ * @since      6.4.0
+ */
+
+/**
+ * Font Collection class.
+ *
+ * @since 6.4.0
+ */
+class WP_Font_Collection {
+
+	/**
+	 * Font collection configuration.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @var array
+	 */
+	private $config = array();
+
+	/**
+	 * WP_Font_Collection constructor.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param array $config Font collection config options.
+	 *                      See {@see wp_register_font_collection()} for the supported fields.
+	 * @throws Exception If the required parameters are missing.
+	 */
+	public function __construct( $config ) {
+		if ( empty( $config ) || ! is_array( $config ) ) {
+			throw new Exception( 'Font Collection config options is required as a non-empty array.' );
+		}
+
+		if ( empty( $config['id'] ) || ! is_string( $config['id'] ) ) {
+			throw new Exception( 'Font Collection config ID is required as a non-empty string.' );
+		}
+
+		if ( empty( $config['name'] ) || ! is_string( $config['name'] ) ) {
+			throw new Exception( 'Font Collection config name is required as a non-empty string.' );
+		}
+
+		if ( empty( $config['src'] ) || ! is_string( $config['src'] ) ) {
+			throw new Exception( 'Font Collection config "src" option is required as a non-empty string.' );
+		}
+
+		$this->config = $config;
+	}
+
+	/**
+	 * Gets the font collection config.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @return array An array containing the font collection config.
+	 */
+	public function get_config() {
+		return $this->config;
+	}
+
+	/**
+	 * Gets the font collection data.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @return array|WP_Error An array containing the list of font families in theme.json format on success,
+	 *                        else an instance of WP_Error on failure.
+	 */
+	public function get_data() {
+		// If the src is a URL, fetch the data from the URL.
+		if ( str_contains( $this->config['src'], 'http' ) && str_contains( $this->config['src'], '://' ) ) {
+			if ( ! wp_http_validate_url( $this->config['src'] ) ) {
+				return new WP_Error( 'font_collection_read_error', __( 'Invalid URL for font collection data.' ) );
+			}
+
+			$response = wp_remote_get( $this->config['src'] );
+			if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) {
+				return new WP_Error( 'font_collection_read_error', __( 'Error fetching the font collection data from a URL.' ) );
+			}
+
+			$data = json_decode( wp_remote_retrieve_body( $response ), true );
+			if ( empty( $data ) ) {
+				return new WP_Error( 'font_collection_read_error', __( 'Error decoding the font collection data from the REST response JSON.' ) );
+			}
+			// If the src is a file path, read the data from the file.
+		} else {
+			if ( ! file_exists( $this->config['src'] ) ) {
+				return new WP_Error( 'font_collection_read_error', __( 'Font collection data JSON file does not exist.' ) );
+			}
+			$data = wp_json_file_decode( $this->config['src'], array( 'associative' => true ) );
+			if ( empty( $data ) ) {
+				return new WP_Error( 'font_collection_read_error', __( 'Error reading the font collection data JSON file contents.' ) );
+			}
+		}
+
+		$collection_data         = $this->get_config();
+		$collection_data['data'] = $data;
+		unset( $collection_data['src'] );
+
+		return $collection_data;
+	}
+}

src/wp-includes/fonts/class-wp-font-family-utils.php

@@ -0,0 +1,89 @@
+<?php
+/**
+ * Font Family Utils class.
+ *
+ * This file contains utils for Font Family class.
+ *
+ * @package    WordPress
+ * @subpackage Fonts
+ * @since      6.4.0
+ */
+
+/**
+ * A class of utilities for working with the Font Library.
+ *
+ * @since 6.4.0
+ */
+class WP_Font_Family_Utils {
+
+	/**
+	 * Generates a filename for a font face asset.
+	 *
+	 * Creates a filename for a font face asset using font family, style, weight and
+	 * extension information.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param string $font_slug The font slug to use in the filename.
+	 * @param array  $font_face The font face array containing 'fontFamily', 'fontStyle', and
+	 *                          'fontWeight' attributes.
+	 * @param string $url       The URL of the font face asset, used to derive the file extension.
+	 * @param string $suffix    Optional. The suffix added to the resulting filename. Default empty string.
+	 * @return string The generated filename for the font face asset.
+	 */
+	public static function get_filename_from_font_face( $font_slug, $font_face, $url, $suffix = '' ) {
+		$extension = pathinfo( $url, PATHINFO_EXTENSION );
+		$filename  = "{$font_slug}_{$font_face['fontStyle']}_{$font_face['fontWeight']}";
+		if ( '' !== $suffix ) {
+			$filename .= "_{$suffix}";
+		}
+
+		return sanitize_file_name( "{$filename}.{$extension}" );
+	}
+
+	/**
+	 * Merges two fonts and their font faces.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param array $font1 The first font to merge.
+	 * @param array $font2 The second font to merge.
+	 * @return array|WP_Error The merged font or WP_Error if the fonts have different slugs.
+	 */
+	public static function merge_fonts_data( $font1, $font2 ) {
+		if ( $font1['slug'] !== $font2['slug'] ) {
+			return new WP_Error(
+				'fonts_must_have_same_slug',
+				__( 'Fonts must have the same slug to be merged.' )
+			);
+		}
+
+		$font_faces_1      = isset( $font1['fontFace'] ) ? $font1['fontFace'] : array();
+		$font_faces_2      = isset( $font2['fontFace'] ) ? $font2['fontFace'] : array();
+		$merged_font_faces = array_merge( $font_faces_1, $font_faces_2 );
+
+		$serialized_faces        = array_map( 'serialize', $merged_font_faces );
+		$unique_serialized_faces = array_unique( $serialized_faces );
+		$unique_faces            = array_map( 'unserialize', $unique_serialized_faces );
+
+		$merged_font             = array_merge( $font1, $font2 );
+		$merged_font['fontFace'] = array_values( $unique_faces );
+
+		return $merged_font;
+	}
+
+	/**
+	 * Returns whether the given file has a font MIME type.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param string $filepath The file to check.
+	 * @return bool True if the file has a font MIME type, false otherwise.
+	 */
+	public static function has_font_mime_type( $filepath ) {
+		$allowed_mime_types = WP_Font_Library::get_font_mime_types();
+		$filetype           = wp_check_filetype( $filepath, $allowed_mime_types );
+
+		return in_array( $filetype['type'], $allowed_mime_types, true );
+	}
+}