mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-14 14:45:45 +01:00
ea8080d8c8
This is the first step towards adding the font library to WordPress. This commit includes the font library and font face CPTs. It also adds the necessary APIs and classes to register and manipulate font collections. This PR backports the font library post types and low level APIs to Core. This is the first step to include the font library entirely into Core. Once this merged, we'll open a PR with the necessary REST API controllers. Props youknowriad, get_dave, grantmkin, swissspidy, hellofromtonya, mukesh27, mcsf. See #59166. Built from https://develop.svn.wordpress.org/trunk@57539 git-svn-id: http://core.svn.wordpress.org/trunk@57040 1a063a9b-81f0-0310-95a4-ce76da25c4cd
191 lines
6.9 KiB
PHP
191 lines
6.9 KiB
PHP
<?php
|
|
/**
|
|
* Fonts functions.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Fonts
|
|
* @since 6.4.0
|
|
*/
|
|
|
|
/**
|
|
* Generates and prints font-face styles for given fonts or theme.json fonts.
|
|
*
|
|
* @since 6.4.0
|
|
*
|
|
* @param array[][] $fonts {
|
|
* Optional. The font-families and their font variations. Default empty array.
|
|
*
|
|
* @type string $font-family => array[] $variations {
|
|
* Optional. An associated array of font variations for this font-family.
|
|
* Each variation has the following structure.
|
|
*
|
|
* @type array $font_variation {
|
|
* @type string $font-family The font-family property.
|
|
* @type string|string[] $src The URL(s) to each resource containing the font data.
|
|
* @type string $font-style Optional. The font-style property. Default 'normal'.
|
|
* @type string $font-weight Optional. The font-weight property. Default '400'.
|
|
* @type string $font-display Optional. The font-display property. Default 'fallback'.
|
|
* @type string $ascent-override Optional. The ascent-override property.
|
|
* @type string $descent-override Optional. The descent-override property.
|
|
* @type string $font-stretch Optional. The font-stretch property.
|
|
* @type string $font-variant Optional. The font-variant property.
|
|
* @type string $font-feature-settings Optional. The font-feature-settings property.
|
|
* @type string $font-variation-settings Optional. The font-variation-settings property.
|
|
* @type string $line-gap-override Optional. The line-gap-override property.
|
|
* @type string $size-adjust Optional. The size-adjust property.
|
|
* @type string $unicode-range Optional. The unicode-range property.
|
|
* }
|
|
* }
|
|
* }
|
|
*/
|
|
function wp_print_font_faces( $fonts = array() ) {
|
|
|
|
if ( empty( $fonts ) ) {
|
|
$fonts = WP_Font_Face_Resolver::get_fonts_from_theme_json();
|
|
}
|
|
|
|
if ( empty( $fonts ) ) {
|
|
return;
|
|
}
|
|
|
|
$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.5.0
|
|
*
|
|
* @param string $slug Font collection slug. May only contain alphanumeric characters, dashes,
|
|
* and underscores. See sanitize_title().
|
|
* @param array|string $data_or_file {
|
|
* Font collection data array or a path/URL to a JSON file containing the font collection.
|
|
*
|
|
* @link https://schemas.wp.org/trunk/font-collection.json
|
|
*
|
|
* @type string $name Required. Name of the font collection shown in the Font Library.
|
|
* @type string $description Optional. A short descriptive summary of the font collection. Default empty.
|
|
* @type array $font_families Required. Array of font family definitions that are in the collection.
|
|
* @type array $categories Optional. Array of categories, each with a name and slug, that are used by the
|
|
* fonts in the collection. Default empty.
|
|
* }
|
|
* @return WP_Font_Collection|WP_Error A font collection if it was registered
|
|
* successfully, or WP_Error object on failure.
|
|
*/
|
|
function wp_register_font_collection( $slug, $data_or_file ) {
|
|
return WP_Font_Library::get_instance()->register_font_collection( $slug, $data_or_file );
|
|
}
|
|
|
|
/**
|
|
* Unregisters a font collection from the Font Library.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param string $slug Font collection slug.
|
|
* @return bool True if the font collection was unregistered successfully, else false.
|
|
*/
|
|
function wp_unregister_font_collection( $slug ) {
|
|
return WP_Font_Library::get_instance()->unregister_font_collection( $slug );
|
|
}
|
|
|
|
/**
|
|
* Returns an array containing the current fonts upload directory's path and URL.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param array $defaults {
|
|
* Array of information about the upload directory.
|
|
*
|
|
* @type string $path Base directory and subdirectory or full path to the fonts upload directory.
|
|
* @type string $url Base URL and subdirectory or absolute URL to the fonts upload directory.
|
|
* @type string $subdir Subdirectory
|
|
* @type string $basedir Path without subdir.
|
|
* @type string $baseurl URL path without subdir.
|
|
* @type string|false $error False or error message.
|
|
* }
|
|
* @return array $defaults {
|
|
* Array of information about the upload directory.
|
|
*
|
|
* @type string $path Base directory and subdirectory or full path to the fonts upload directory.
|
|
* @type string $url Base URL and subdirectory or absolute URL to the fonts upload directory.
|
|
* @type string $subdir Subdirectory
|
|
* @type string $basedir Path without subdir.
|
|
* @type string $baseurl URL path without subdir.
|
|
* @type string|false $error False or error message.
|
|
* }
|
|
*/
|
|
function wp_get_font_dir( $defaults = array() ) {
|
|
$site_path = '';
|
|
if ( is_multisite() && ! ( is_main_network() && is_main_site() ) ) {
|
|
$site_path = '/sites/' . get_current_blog_id();
|
|
}
|
|
|
|
// Sets the defaults.
|
|
$defaults['path'] = path_join( WP_CONTENT_DIR, 'fonts' ) . $site_path;
|
|
$defaults['url'] = untrailingslashit( content_url( 'fonts' ) ) . $site_path;
|
|
$defaults['subdir'] = '';
|
|
$defaults['basedir'] = path_join( WP_CONTENT_DIR, 'fonts' ) . $site_path;
|
|
$defaults['baseurl'] = untrailingslashit( content_url( 'fonts' ) ) . $site_path;
|
|
$defaults['error'] = false;
|
|
|
|
/**
|
|
* Filters the fonts directory data.
|
|
*
|
|
* This filter allows developers to modify the fonts directory data.
|
|
*
|
|
* @since 6.5.0
|
|
*
|
|
* @param array $defaults The original fonts directory data.
|
|
*/
|
|
return apply_filters( 'font_dir', $defaults );
|
|
}
|
|
|
|
/**
|
|
* Deletes child font faces when a font family is deleted.
|
|
*
|
|
* @access private
|
|
* @since 6.5.0
|
|
*
|
|
* @param int $post_id Post ID.
|
|
* @param WP_Post $post Post object.
|
|
*/
|
|
function _wp_after_delete_font_family( $post_id, $post ) {
|
|
if ( 'wp_font_family' !== $post->post_type ) {
|
|
return;
|
|
}
|
|
|
|
$font_faces = get_children(
|
|
array(
|
|
'post_parent' => $post_id,
|
|
'post_type' => 'wp_font_face',
|
|
)
|
|
);
|
|
|
|
foreach ( $font_faces as $font_face ) {
|
|
wp_delete_post( $font_face->ID, true );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Deletes associated font files when a font face is deleted.
|
|
*
|
|
* @access private
|
|
* @since 6.5.0
|
|
*
|
|
* @param int $post_id Post ID.
|
|
* @param WP_Post $post Post object.
|
|
*/
|
|
function _wp_before_delete_font_face( $post_id, $post ) {
|
|
if ( 'wp_font_face' !== $post->post_type ) {
|
|
return;
|
|
}
|
|
|
|
$font_files = get_post_meta( $post_id, '_wp_font_face_file', false );
|
|
$font_dir = wp_get_font_dir()['path'];
|
|
|
|
foreach ( $font_files as $font_file ) {
|
|
wp_delete_file( $font_dir . '/' . $font_file );
|
|
}
|
|
}
|