Font Library: unregister font collection

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

@@ -63,15 +63,57 @@ public static function get_expected_font_mime_types_per_php_version( $php_versio
 	 */
 	public static function register_font_collection( $config ) {
 		$new_collection = new WP_Font_Collection( $config );
-
-		if ( isset( self::$collections[ $config['id'] ] ) ) {
-			return new WP_Error( 'font_collection_registration_error', 'Font collection already registered.' );
+		if ( self::is_collection_registered( $config['id'] ) ) {
+			$error_message = sprintf(
+				/* translators: %s: Font collection id. */
+				__( 'Font collection with id: "%s" is already registered.', 'default' ),
+				$config['id']
+			);
+			_doing_it_wrong(
+				__METHOD__,
+				$error_message,
+				'6.5.0'
+			);
+			return new WP_Error( 'font_collection_registration_error', $error_message );
 		}
-
 		self::$collections[ $config['id'] ] = $new_collection;
 		return $new_collection;
 	}
 
+	/**
+	 * Unregisters a previously registered font collection.
+	 *
+	 * @since 6.5.0
+	 *
+	 * @param string $collection_id Font collection ID.
+	 * @return bool True if the font collection was unregistered successfully and false otherwise.
+	 */
+	public static function unregister_font_collection( $collection_id ) {
+		if ( ! self::is_collection_registered( $collection_id ) ) {
+			_doing_it_wrong(
+				__METHOD__,
+				/* translators: %s: Font collection id. */
+				sprintf( __( 'Font collection "%s" not found.', 'default' ), $collection_id ),
+				'6.5.0'
+			);
+			return false;
+		}
+		unset( self::$collections[ $collection_id ] );
+		return true;
+	}
+
+	/**
+	 * Checks if a font collection is registered.
+	 *
+	 * @since 6.5.0
+	 *
+	 * @param string $collection_id Font collection ID.
+	 * @return bool True if the font collection is registered and false otherwise.
+	 */
+	private static function is_collection_registered( $collection_id ) {
+		return array_key_exists( $collection_id, self::$collections );
+	}
+
 	/**
 	 * Gets all the font collections available.
 	 *

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

@@ -57,6 +57,19 @@ function wp_register_font_collection( $config ) {
 	}
 }
 
+if ( ! function_exists( 'wp_unregister_font_collection' ) ) {
+	/**
+	 * Unregisters a font collection from the Font Library.
+	 *
+	 * @since 6.5.0
+	 *
+	 * @param string $collection_id The font collection ID.
+	 */
+	function wp_unregister_font_collection( $collection_id ) {
+		WP_Font_Library::unregister_font_collection( $collection_id );
+	}
+
+}
 
 $default_font_collection = array(
 	'id'          => 'default-font-collection',

phpunit/tests/fonts/font-library/wpFontLibrary/getFontCollections.php

@@ -12,33 +12,40 @@
  */
 class Tests_Fonts_WpFontLibrary_GetFontCollections extends WP_UnitTestCase {
 
-	public static function set_up_before_class() {
-		$font_library = new WP_Font_Library();
+	public function set_up() {
+		// Resets the private static property WP_Font_Library::$collections to empty array.
+		$reflection = new ReflectionClass( 'WP_Font_Library' );
+		$property   = $reflection->getProperty( 'collections' );
+		$property->setAccessible( true );
+		$property->setValue( array() );
+	}
+
+	public function tear_down() {
+		// Resets the private static property WP_Font_Library::$collections to empty array.
+		$reflection = new ReflectionClass( 'WP_Font_Library' );
+		$property   = $reflection->getProperty( 'collections' );
+		$property->setAccessible( true );
+		$property->setValue( array() );
+	}
+
+	public function test_should_get_an_empty_list() {
+		$font_collections = WP_Font_Library::get_font_collections();
+		$this->assertEmpty( $font_collections, 'Should return an empty array.' );
+	}
 
+	public function test_should_get_mock_font_collection() {
 		$my_font_collection_config = array(
 			'id'          => 'my-font-collection',
 			'name'        => 'My Font Collection',
 			'description' => 'Demo about how to a font collection to your WordPress Font Library.',
 			'src'         => path_join( __DIR__, 'my-font-collection-data.json' ),
 		);
 
-		$font_library::register_font_collection( $my_font_collection_config );
-	}
+		WP_Font_Library::register_font_collection( $my_font_collection_config );
 
-	public function test_should_get_the_default_font_collection() {
-		$font_collections = WP_Font_Library::get_font_collections();
-		$this->assertArrayHasKey( 'default-font-collection', $font_collections, 'Default Google Fonts collection should be registered' );
-		$this->assertInstanceOf( 'WP_Font_Collection', $font_collections['default-font-collection'], 'The value of the array $font_collections[id] should be an instance of WP_Font_Collection class.' );
-	}
-
-	public function test_should_get_the_right_number_of_collections() {
 		$font_collections = WP_Font_Library::get_font_collections();
 		$this->assertNotEmpty( $font_collections, 'Sould return an array of font collections.' );
-		$this->assertCount( 2, $font_collections, 'Should return an array with one font collection.' );
-	}
-
-	public function test_should_get_mock_font_collection() {
-		$font_collections = WP_Font_Library::get_font_collections();
+		$this->assertCount( 1, $font_collections, 'Should return an array with one font collection.' );
 		$this->assertArrayHasKey( 'my-font-collection', $font_collections, 'The array should have the key of the registered font collection id.' );
 		$this->assertInstanceOf( 'WP_Font_Collection', $font_collections['my-font-collection'], 'The value of the array $font_collections[id] should be an instance of WP_Font_Collection class.' );
 	}

phpunit/tests/fonts/font-library/wpFontLibrary/registerFontCollection.php

@@ -70,6 +70,8 @@ public function test_should_return_error_if_id_is_repeated() {
 		$collection1 = WP_Font_Library::register_font_collection( $config1 );
 		$this->assertInstanceOf( 'WP_Font_Collection', $collection1, 'A collection should be registered.' );
 
+		// Expects a _doing_it_wrong notice.
+		$this->setExpectedIncorrectUsage( 'WP_Font_Library::register_font_collection' );
 		// Try to register a second collection with same id.
 		$collection2 = WP_Font_Library::register_font_collection( $config2 );
 		$this->assertWPError( $collection2, 'Second collection with the same id should fail.' );

phpunit/tests/fonts/font-library/wpFontLibrary/unregisterFontCollection.php

@@ -0,0 +1,61 @@
+<?php
+/**
+ * Test WP_Font_Library::unregister_font_collection().
+ *
+ * @package WordPress
+ * @subpackage Font Library
+ *
+ * @group fonts
+ * @group font-library
+ *
+ * @covers WP_Font_Library::unregister_font_collection
+ */
+class Tests_Fonts_WpFontLibrary_UnregisterFontCollection extends WP_UnitTestCase {
+
+	public function set_up() {
+		// Resets the private static property WP_Font_Library::$collections to empty array.
+		$reflection = new ReflectionClass( 'WP_Font_Library' );
+		$property   = $reflection->getProperty( 'collections' );
+		$property->setAccessible( true );
+		$property->setValue( array() );
+
+		// Registers two mock font collections.
+		$config = array(
+			'id'          => 'mock-font-collection-1',
+			'name'        => 'Mock Collection to be unregistered',
+			'description' => 'A mock font collection to be unregistered.',
+			'src'         => 'my-collection-data.json',
+		);
+		WP_Font_Library::register_font_collection( $config );
+
+		$config = array(
+			'id'          => 'mock-font-collection-2',
+			'name'        => 'Mock Collection',
+			'description' => 'A mock font collection.',
+			'src'         => 'my-mock-data.json',
+		);
+		WP_Font_Library::register_font_collection( $config );
+	}
+
+	public function test_should_unregister_font_collection() {
+		// Unregister mock font collection.
+		WP_Font_Library::unregister_font_collection( 'mock-font-collection-1' );
+		$collections = WP_Font_Library::get_font_collections();
+		$this->assertArrayNotHasKey( 'mock-font-collection-1', $collections, 'Font collection was not unregistered.' );
+
+		// Unregisters remaining mock font collection.
+		WP_Font_Library::unregister_font_collection( 'mock-font-collection-2' );
+		$collections = WP_Font_Library::get_font_collections();
+		$this->assertArrayNotHasKey( 'mock-font-collection-2', $collections, 'Mock font collection was not unregistered.' );
+
+		// Checks that all font collections were unregistered.
+		$this->assertEmpty( $collections, 'Font collections were not unregistered.' );
+	}
+
+	public function unregister_non_existing_collection() {
+		// Unregisters non existing font collection.
+		WP_Font_Library::unregister_font_collection( 'non-existing-collection' );
+		$collections = WP_Font_Library::get_font_collections();
+		$this->assertEmpty( $collections, 'Should not be registered collections.' );
+	}
+}