mirror of
https://github.com/WordPress/WordPress.git
synced 2024-09-07 13:18:14 +02:00
Updates `wp_register_font_collection()` and `WP_Font_Collection` so that only font families can be loaded from a file or URL. All metadata, such as name, description, and list of font categories, needs to be passed directly in PHP so that it can be properly localized. Props swissspidy, mmaattiiaass, grantmkin, youknowriad. Fixes #60509. Built from https://develop.svn.wordpress.org/trunk@57686 git-svn-id: http://core.svn.wordpress.org/trunk@57187 1a063a9b-81f0-0310-95a4-ce76da25c4cd
143 lines
3.4 KiB
PHP
143 lines
3.4 KiB
PHP
<?php
|
|
/**
|
|
* Font Library class.
|
|
*
|
|
* This file contains the Font Library class definition.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Fonts
|
|
* @since 6.5.0
|
|
*/
|
|
|
|
/**
|
|
* Font Library class.
|
|
*
|
|
* @since 6.5.0
|
|
*/
|
|
class WP_Font_Library {
|
|
|
|
/**
|
|
* Font collections.
|
|
*
|
|
* @since 6.5.0
|
|
* @var array
|
|
*/
|
|
private $collections = array();
|
|
|
|
/**
|
|
* Container for the main instance of the class.
|
|
*
|
|
* @since 6.5.0
|
|
* @var WP_Font_Library|null
|
|
*/
|
|
private static $instance = null;
|
|
|
|
/**
|
|
* Register a new font collection.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param string $slug Font collection slug. May only contain alphanumeric characters, dashes,
|
|
* and underscores. See sanitize_title().
|
|
* @param array $args Font collection data. See wp_register_font_collection() for information on accepted arguments.
|
|
* @return WP_Font_Collection|WP_Error A font collection if it was registered successfully,
|
|
* or WP_Error object on failure.
|
|
*/
|
|
public function register_font_collection( string $slug, array $args ) {
|
|
$new_collection = new WP_Font_Collection( $slug, $args );
|
|
|
|
if ( $this->is_collection_registered( $new_collection->slug ) ) {
|
|
$error_message = sprintf(
|
|
/* translators: %s: Font collection slug. */
|
|
__( 'Font collection with slug: "%s" is already registered.' ),
|
|
$new_collection->slug
|
|
);
|
|
_doing_it_wrong(
|
|
__METHOD__,
|
|
$error_message,
|
|
'6.5.0'
|
|
);
|
|
return new WP_Error( 'font_collection_registration_error', $error_message );
|
|
}
|
|
$this->collections[ $new_collection->slug ] = $new_collection;
|
|
return $new_collection;
|
|
}
|
|
|
|
/**
|
|
* Unregisters a previously registered font collection.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param string $slug Font collection slug.
|
|
* @return bool True if the font collection was unregistered successfully and false otherwise.
|
|
*/
|
|
public function unregister_font_collection( string $slug ) {
|
|
if ( ! $this->is_collection_registered( $slug ) ) {
|
|
_doing_it_wrong(
|
|
__METHOD__,
|
|
/* translators: %s: Font collection slug. */
|
|
sprintf( __( 'Font collection "%s" not found.' ), $slug ),
|
|
'6.5.0'
|
|
);
|
|
return false;
|
|
}
|
|
unset( $this->collections[ $slug ] );
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Checks if a font collection is registered.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param string $slug Font collection slug.
|
|
* @return bool True if the font collection is registered and false otherwise.
|
|
*/
|
|
private function is_collection_registered( string $slug ) {
|
|
return array_key_exists( $slug, $this->collections );
|
|
}
|
|
|
|
/**
|
|
* Gets all the font collections available.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @return array List of font collections.
|
|
*/
|
|
public function get_font_collections() {
|
|
return $this->collections;
|
|
}
|
|
|
|
/**
|
|
* Gets a font collection.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param string $slug Font collection slug.
|
|
* @return WP_Font_Collection|null Font collection object, or null if the font collection doesn't exist.
|
|
*/
|
|
public function get_font_collection( string $slug ) {
|
|
if ( $this->is_collection_registered( $slug ) ) {
|
|
return $this->collections[ $slug ];
|
|
}
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* Utility method to retrieve the main instance of the class.
|
|
*
|
|
* The instance will be created if it does not exist yet.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @return WP_Font_Library The main instance.
|
|
*/
|
|
public static function get_instance() {
|
|
if ( null === self::$instance ) {
|
|
self::$instance = new self();
|
|
}
|
|
|
|
return self::$instance;
|
|
}
|
|
}
|