Font Library: Font Collection backend

lib/experimental/fonts/font-library/class-wp-font-collection.php

@@ -0,0 +1,86 @@
+<?php
+/**
+ * Font Collection class.
+ *
+ * This file contains the Font Collection class definition.
+ *
+ * @package    WordPress
+ * @subpackage Font Collection
+ * @since      6.4.0
+ */
+
+if ( class_exists( 'WP_Font_Collection' ) ) {
+	return;
+}
+
+/**
+ * Font Collection class.
+ *
+ * @since 6.4.0
+ */
+class WP_Font_Collection {
+
+	/**
+	 * Font collection configuration.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @var array
+	 */
+	private $config;
+
+	/**
+	 * WP_Font_Collection constructor.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param string $id Font collection id.
+	 * @param array  $config Font collection config options.
+	 * @throws Exception If some of the required parameters are missing.
+	 */
+	public function __construct( $id, $config ) {
+
+		if ( empty( $id ) ) {
+			throw new Exception( 'Font Collection is missing the id.' );
+		}
+
+		if ( empty( $config ) ) {
+			throw new Exception( 'Font Collection is missing the config.' );
+		}
+
+		$config['id'] = $id;
+		$this->config = $config;
+	}
+
+	/**
+	 * Gets the font collection config.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @return array An array contaning the font collection config.
+	 */
+	public function get_config() {
+		return $this->config;
+	}
+
+	/**
+	 * Gets the font collection data.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @return array An array contaning the list of font families in theme.json format
+	 */
+	public function get_data() {
+		if ( ! empty( $this->config['data_json_file'] ) ) {
+			if ( file_exists( $this->config['data_json_file'] ) ) {
+				$data                    = file_get_contents( $this->config['data_json_file'] );
+				$collection_data         = $this->get_config();
+				$collection_data['data'] = $data;
+				unset( $collection_data['data_json_file'] );
+				return $collection_data;
+			}
+		}
+		return new WP_Error( 'font_collection_error', 'Font Collection data is missing the data_json_file.' );
+	}
+
+}

lib/experimental/fonts/font-library/class-wp-font-library.php

@@ -27,6 +27,63 @@ class WP_Font_Library {
 		'woff2' => 'font/woff2',
 	);
 
+	/**
+	 * Font collections.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @var array
+	 */
+	public static $collections = array();
+
+	/**
+	 * Register filter to extend the library with font collections.
+	 *
+	 * @since 6.4.0
+	 */
+	public static function register_filters() {
+		add_filter(
+			'register_font_collection',
+			array( 'WP_Font_Library', 'register_font_collection' ),
+			10,
+			2
+		);
+	}
+
+	/**
+	 * Register a new font collection.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param string $id Font collection id.
+	 * @param array  $config Font collection config options.
+	 * @return WP_Font_Collection|WP_Error A font collection is it was registered succesfully and a WP_Error otherwise.
+	 */
+	public static function register_font_collection( $id, $config ) {
+		if ( array_key_exists( $id, self::$collections ) ) {
+			return new WP_Error( 'font_collection_registration_error', 'Font collection already registered.' );
+		}
+
+		try {
+			$new_collection           = new WP_Font_Collection( $id, $config );
+			self::$collections[ $id ] = $new_collection;
+			return $new_collection;
+		} catch ( Exception $e ) {
+			return new WP_Error( 'font_collection_error', $e->getMessage() );
+		}
+	}
+
+	/**
+	 * Gets the font collections available.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @return array List of font collections.
+	 */
+	public static function get_font_collections() {
+		return self::$collections;
+	}
+
 	/**
 	 * Gets the upload directory for fonts.
 	 *

lib/experimental/fonts/font-library/class-wp-rest-font-library-controller.php

@@ -67,6 +67,69 @@ public function register_routes() {
 				),
 			)
 		);
+
+		register_rest_route(
+			$this->namespace,
+			'/' . $this->rest_base . '/collections',
+			array(
+				array(
+					'methods'             => WP_REST_Server::READABLE,
+					'callback'            => array( $this, 'get_font_collections' ),
+					'permission_callback' => array( $this, 'update_font_library_permissions_check' ),
+				),
+			)
+		);
+
+		register_rest_route(
+			$this->namespace,
+			'/' . $this->rest_base . '/collections' . '/(?P<id>[\/\w-]+)',
+			array(
+				array(
+					'methods'             => WP_REST_Server::READABLE,
+					'callback'            => array( $this, 'get_font_collection' ),
+					'permission_callback' => array( $this, 'update_font_library_permissions_check' ),
+				),
+			)
+		);
+	}
+
+	/**
+	 * Gets a font collection.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param WP_REST_Request $request Full details about the request.
+	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
+	 */
+	public function get_font_collection( $request ) {
+		$id = $request->get_param( 'id' );
+		if ( ! array_key_exists( $id, WP_Font_Library::get_font_collections() ) ) {
+			return new WP_Error(
+				'font_collection_not_found',
+				__( 'Font collection not found.', 'gutenberg' ),
+				array( 'status' => 404 )
+			);
+		}
+
+		$collection = WP_Font_Library::get_font_collections()[ $id ];
+		return new WP_REST_Response( $collection->get_data() );
+	}
+
+	/**
+	 * Gets the font collections available.
+	 *
+	 * @since 6.4.0
+	 *
+	 * @param WP_REST_Request $request Full details about the request.
+	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.
+	 */
+	public function get_font_collections() {
+		$collections = array();
+		foreach ( WP_Font_Library::get_font_collections() as $collection ) {
+			$collections[] = $collection->get_config();
+		}
+
+		return new WP_REST_Response( $collections );
 	}
 
 	/**

lib/experimental/fonts/font-library/font-library.php

@@ -19,7 +19,7 @@
  *
  * @since 6.4.0
  */
-function gutenberg_init_font_library() {
+function gutenberg_init_font_library_routes() {
 	// @core-merge: This code will go into Core's `create_initial_post_types()`.
 	$args = array(
 		'public'       => true,
@@ -33,5 +33,15 @@ function gutenberg_init_font_library() {
 	$font_library_controller->register_routes();
 }
 
-add_action( 'rest_api_init', 'gutenberg_init_font_library' );
+add_action( 'rest_api_init', 'gutenberg_init_font_library_routes' );
+
+/**
+ * Registers the font collection filter for font library.
+ *
+ * @since 6.4.0
+ */
+function gutenberg_init_font_library() {
+	WP_Font_Library::register_filters();
+}
 
+add_action( 'init', 'gutenberg_init_font_library' );

lib/load.php

@@ -164,6 +164,7 @@ function gutenberg_is_experiment_enabled( $name ) {
 	( defined( 'FONTS_LIBRARY_ENABLE' ) && FONTS_LIBRARY_ENABLE )
 ) {
 	// Loads the Font Library.
+	require __DIR__ . '/experimental/fonts/font-library/class-wp-font-collection.php';
 	require __DIR__ . '/experimental/fonts/font-library/class-wp-font-library.php';
 	require __DIR__ . '/experimental/fonts/font-library/class-wp-font-family-utils.php';
 	require __DIR__ . '/experimental/fonts/font-library/class-wp-font-family.php';

phpunit/fonts/font-library/class-wp-rest-font-library-controller-test.php

@@ -35,8 +35,13 @@ public function test_register_routes() {
 		$routes = rest_get_server()->get_routes();
 		$this->assertArrayHasKey( '/wp/v2/fonts', $routes, 'Rest server has not the fonts path intialized.' );
 		$this->assertCount( 2, $routes['/wp/v2/fonts'], 'Rest server has not the 2 fonts paths initialized.' );
+		$this->assertCount( 1, $routes['/wp/v2/fonts/collections'], 'Rest server has not the collections path initialized.' );
+		$this->assertCount( 1, $routes['/wp/v2/fonts/collections/(?P<id>[\/\w-]+)'], 'Rest server has not the collection path initialized.' );
+
 		$this->assertArrayHasKey( 'POST', $routes['/wp/v2/fonts'][0]['methods'], 'Rest server has not the POST method for fonts intialized.' );
 		$this->assertArrayHasKey( 'DELETE', $routes['/wp/v2/fonts'][1]['methods'], 'Rest server has not the DELETE method for fonts intialized.' );
+		$this->assertArrayHasKey( 'GET', $routes['/wp/v2/fonts/collections'][0]['methods'], 'Rest server has not the GET method for collections intialized.' );
+		$this->assertArrayHasKey( 'GET', $routes['/wp/v2/fonts/collections/(?P<id>[\/\w-]+)'][0]['methods'], 'Rest server has not the GET method for collection intialized.' );
 	}
 
 	/**

phpunit/fonts/font-library/wpFontCollection/__construct-test.php

@@ -0,0 +1,93 @@
+<?php
+/**
+ * Test WP_Font_Collection::__construct().
+ *
+ * @package WordPress
+ * @subpackage Font Library
+ *
+ * @group fonts
+ * @group font-library
+ *
+ * @covers WP_Font_Collection::__construct
+ */
+class Tests_Fonts_WpFontCollection_Construct extends WP_UnitTestCase {
+
+	public function test_should_initialize_data() {
+		$property = new ReflectionProperty( WP_Font_Collection::class, 'config' );
+		$property->setAccessible( true );
+
+		$id              = 'my-collection';
+		$config          = array(
+			'name'           => 'My Collection',
+			'description'    => 'My collection description',
+			'data_json_file' => 'my-collection-data.json',
+		);
+		$font_collection = new WP_Font_Collection( $id, $config );
+
+		$actual = $property->getValue( $font_collection );
+		$property->setAccessible( false );
+
+		$expected       = $config;
+		$expected['id'] = $id;
+
+		$this->assertSame( $expected, $actual );
+	}
+
+	/**
+	 * @dataProvider data_should_throw_exception
+	 *
+	 * @param mixed  $id Id of the font collection.
+	 * @param mixed  $config Config of the font collection.
+	 * @param string $expected_exception_message Expected exception message.
+	 */
+	public function test_should_throw_exception( $id, $config, $expected_exception_message ) {
+		$this->expectException( 'Exception' );
+		$this->expectExceptionMessage( $expected_exception_message );
+
+		new WP_Font_Collection( $id, $config );
+	}
+
+	/**
+	 * Data provider.
+	 *
+	 * @return array
+	 */
+	public function data_should_throw_exception() {
+		return array(
+			'no id'                           => array(
+				'',
+				array(
+					'name'           => 'My Collection',
+					'description'    => 'My collection description',
+					'data_json_file' => 'my-collection-data.json',
+				),
+				'Font Collection is missing the id.',
+			),
+
+			'no config'                       => array(
+				'my-collection',
+				'',
+				'Font Collection is missing the config.',
+			),
+
+			'empty array'                     => array(
+				'my-collection',
+				array(),
+				'Font Collection is missing the config.',
+			),
+
+			'boolean instead of config array' => array(
+				'my-collection',
+				false,
+				'Font Collection is missing the config.',
+			),
+
+			'null instead of config array'    => array(
+				'my-collection',
+				null,
+				'Font Collection is missing the config.',
+			),
+
+		);
+	}
+}