Edit File by line

<?php

[0] Fix | Delete

/**

[1] Fix | Delete

* Font Library class.

[2] Fix | Delete

[3] Fix | Delete

* This file contains the Font Library class definition.

[4] Fix | Delete

[5] Fix | Delete

* @package WordPress

[6] Fix | Delete

* @subpackage Fonts

[7] Fix | Delete

* @since 6.5.0

[8] Fix | Delete

[9] Fix | Delete

[10] Fix | Delete

/**

[11] Fix | Delete

* Font Library class.

[12] Fix | Delete

[13] Fix | Delete

* @since 6.5.0

[14] Fix | Delete

[15] Fix | Delete

class WP_Font_Library {

[16] Fix | Delete

[17] Fix | Delete

/**

[18] Fix | Delete

* Font collections.

[19] Fix | Delete

[20] Fix | Delete

* @since 6.5.0

[21] Fix | Delete

* @var array

[22] Fix | Delete

[23] Fix | Delete

private $collections = array();

[24] Fix | Delete

[25] Fix | Delete

/**

[26] Fix | Delete

* Container for the main instance of the class.

[27] Fix | Delete

[28] Fix | Delete

* @since 6.5.0

[29] Fix | Delete

* @var WP_Font_Library|null

[30] Fix | Delete

[31] Fix | Delete

private static $instance = null;

[32] Fix | Delete

[33] Fix | Delete

/**

[34] Fix | Delete

* Register a new font collection.

[35] Fix | Delete

[36] Fix | Delete

* @since 6.5.0

[37] Fix | Delete

[38] Fix | Delete

* @param string $slug Font collection slug. May only contain alphanumeric characters, dashes,

[39] Fix | Delete

* and underscores. See sanitize_title().

[40] Fix | Delete

* @param array $args Font collection data. See wp_register_font_collection() for information on accepted arguments.

[41] Fix | Delete

* @return WP_Font_Collection|WP_Error A font collection if it was registered successfully,

[42] Fix | Delete

* or WP_Error object on failure.

[43] Fix | Delete

[44] Fix | Delete

public function register_font_collection( string $slug, array $args ) {

[45] Fix | Delete

$new_collection = new WP_Font_Collection( $slug, $args );

[46] Fix | Delete

[47] Fix | Delete

if ( $this->is_collection_registered( $new_collection->slug ) ) {

[48] Fix | Delete

$error_message = sprintf(

[49] Fix | Delete

/* translators: %s: Font collection slug. */

[50] Fix | Delete

__( 'Font collection with slug: "%s" is already registered.' ),

[51] Fix | Delete

$new_collection->slug

[52] Fix | Delete

);

[53] Fix | Delete

_doing_it_wrong(

[54] Fix | Delete

__METHOD__,

[55] Fix | Delete

$error_message,

[56] Fix | Delete

'6.5.0'

[57] Fix | Delete

);

[58] Fix | Delete

return new WP_Error( 'font_collection_registration_error', $error_message );

[59] Fix | Delete

}

[60] Fix | Delete

$this->collections[ $new_collection->slug ] = $new_collection;

[61] Fix | Delete

return $new_collection;

[62] Fix | Delete

}

[63] Fix | Delete

[64] Fix | Delete

/**

[65] Fix | Delete

* Unregisters a previously registered font collection.

[66] Fix | Delete

[67] Fix | Delete

* @since 6.5.0

[68] Fix | Delete

[69] Fix | Delete

* @param string $slug Font collection slug.

[70] Fix | Delete

* @return bool True if the font collection was unregistered successfully and false otherwise.

[71] Fix | Delete

[72] Fix | Delete

public function unregister_font_collection( string $slug ) {

[73] Fix | Delete

if ( ! $this->is_collection_registered( $slug ) ) {

[74] Fix | Delete

_doing_it_wrong(

[75] Fix | Delete

__METHOD__,

[76] Fix | Delete

/* translators: %s: Font collection slug. */

[77] Fix | Delete

sprintf( __( 'Font collection "%s" not found.' ), $slug ),

[78] Fix | Delete

'6.5.0'

[79] Fix | Delete

);

[80] Fix | Delete

return false;

[81] Fix | Delete

}

[82] Fix | Delete

unset( $this->collections[ $slug ] );

[83] Fix | Delete

return true;

[84] Fix | Delete

}

[85] Fix | Delete

[86] Fix | Delete

/**

[87] Fix | Delete

* Checks if a font collection is registered.

[88] Fix | Delete

[89] Fix | Delete

* @since 6.5.0

[90] Fix | Delete

[91] Fix | Delete

* @param string $slug Font collection slug.

[92] Fix | Delete

* @return bool True if the font collection is registered and false otherwise.

[93] Fix | Delete

[94] Fix | Delete

private function is_collection_registered( string $slug ) {

[95] Fix | Delete

return array_key_exists( $slug, $this->collections );

[96] Fix | Delete

}

[97] Fix | Delete

[98] Fix | Delete

/**

[99] Fix | Delete

* Gets all the font collections available.

[100] Fix | Delete

[101] Fix | Delete

* @since 6.5.0

[102] Fix | Delete

[103] Fix | Delete

* @return array List of font collections.

[104] Fix | Delete

[105] Fix | Delete

public function get_font_collections() {

[106] Fix | Delete

return $this->collections;

[107] Fix | Delete

}

[108] Fix | Delete

[109] Fix | Delete

/**

[110] Fix | Delete

* Gets a font collection.

[111] Fix | Delete

[112] Fix | Delete

* @since 6.5.0

[113] Fix | Delete

[114] Fix | Delete

* @param string $slug Font collection slug.

[115] Fix | Delete

* @return WP_Font_Collection|null Font collection object, or null if the font collection doesn't exist.

[116] Fix | Delete

[117] Fix | Delete

public function get_font_collection( string $slug ) {

[118] Fix | Delete

if ( $this->is_collection_registered( $slug ) ) {

[119] Fix | Delete

return $this->collections[ $slug ];

[120] Fix | Delete

}

[121] Fix | Delete

return null;

[122] Fix | Delete

}

[123] Fix | Delete

[124] Fix | Delete

/**

[125] Fix | Delete

* Utility method to retrieve the main instance of the class.

[126] Fix | Delete

[127] Fix | Delete

* The instance will be created if it does not exist yet.

[128] Fix | Delete

[129] Fix | Delete

* @since 6.5.0

[130] Fix | Delete

[131] Fix | Delete

* @return WP_Font_Library The main instance.

[132] Fix | Delete

[133] Fix | Delete

public static function get_instance() {

[134] Fix | Delete

if ( null === self::$instance ) {

[135] Fix | Delete

self::$instance = new self();

[136] Fix | Delete

}

[137] Fix | Delete

[138] Fix | Delete

return self::$instance;

[139] Fix | Delete

}

[140] Fix | Delete

}

[141] Fix | Delete

[142] Fix | Delete