File Manager

📂 File Manager

📝 Edit File: fonts.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 faces. Default empty array.
 *
 *     @type array ...$0 {
 *         An indexed or associative (keyed by font-family) array of font variations for this font-family.
 *         Each font face has the following structure.
 *
 *         @type array ...$0 {
 *             The font face properties.
 *
 *             @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 );
}

/**
 * Generates and prints font-face styles defined the the theme style variations.
 *
 * @since 6.7.0
 *
 */
function wp_print_font_faces_from_style_variations() {
	$fonts = WP_Font_Face_Resolver::get_fonts_from_style_variations();

if ( empty( $fonts ) ) {
		return;
	}

wp_print_font_faces( $fonts );
}

/**
 * Registers a new font collection in the font library.
 *
 * See {@link https://schemas.wp.org/trunk/font-collection.json} for the schema
 * the font collection data must adhere to.
 *
 * @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.
 *
 *     @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|string $font_families Required. Array of font family definitions that are in the collection,
 *                                       or a string containing the path or URL to a JSON file containing the font 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( string $slug, array $args ) {
	return WP_Font_Library::get_instance()->register_font_collection( $slug, $args );
}

/**
 * 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( string $slug ) {
	return WP_Font_Library::get_instance()->unregister_font_collection( $slug );
}

/**
 * Retrieves font uploads directory information.
 *
 * Same as wp_font_dir() but "light weight" as it doesn't attempt to create the font uploads directory.
 * Intended for use in themes, when only 'basedir' and 'baseurl' are needed, generally in all cases
 * when not uploading files.
 *
 * @since 6.5.0
 *
 * @see wp_font_dir()
 *
 * @return array See wp_font_dir() for description.
 */
function wp_get_font_dir() {
	return wp_font_dir( false );
}

/**
 * Returns an array containing the current fonts upload directory's path and URL.
 *
 * @since 6.5.0
 *
 * @param bool $create_dir Optional. Whether to check and create the font uploads directory. Default true.
 * @return array {
 *     Array of information about the font 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_font_dir( $create_dir = true ) {
	/*
	 * Allow extenders to manipulate the font directory consistently.
	 *
	 * Ensures the upload_dir filter is fired both when calling this function
	 * directly and when the upload directory is filtered in the Font Face
	 * REST API endpoint.
	 */
	add_filter( 'upload_dir', '_wp_filter_font_directory' );
	$font_dir = wp_upload_dir( null, $create_dir, false );
	remove_filter( 'upload_dir', '_wp_filter_font_directory' );
	return $font_dir;
}

/**
 * A callback function for use in the {@see 'upload_dir'} filter.
 *
 * This function is intended for internal use only and should not be used by plugins and themes.
 * Use wp_get_font_dir() instead.
 *
 * @since 6.5.0
 * @access private
 *
 * @param string $font_dir The font directory.
 * @return string The modified font directory.
 */
function _wp_filter_font_directory( $font_dir ) {
	if ( doing_filter( 'font_dir' ) ) {
		// Avoid an infinite loop.
		return $font_dir;
	}

$font_dir = array(
		'path'    => untrailingslashit( $font_dir['basedir'] ) . '/fonts',
		'url'     => untrailingslashit( $font_dir['baseurl'] ) . '/fonts',
		'subdir'  => '',
		'basedir' => untrailingslashit( $font_dir['basedir'] ) . '/fonts',
		'baseurl' => untrailingslashit( $font_dir['baseurl'] ) . '/fonts',
		'error'   => false,
	);

/**
	 * Filters the fonts directory data.
	 *
	 * This filter allows developers to modify the fonts directory data.
	 *
	 * @since 6.5.0
	 *
	 * @param array $font_dir {
	 *     Array of information about the font 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 apply_filters( 'font_dir', $font_dir );
}

/**
 * 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   = untrailingslashit( wp_get_font_dir()['basedir'] );

foreach ( $font_files as $font_file ) {
		wp_delete_file( $font_dir . '/' . $font_file );
	}
}

/**
 * Register the default font collections.
 *
 * @access private
 * @since 6.5.0
 */
function _wp_register_default_font_collections() {
	wp_register_font_collection(
		'google-fonts',
		array(
			'name'          => _x( 'Google Fonts', 'font collection name' ),
			'description'   => __( 'Install from Google Fonts. Fonts are copied to and served from your site.' ),
			'font_families' => 'https://s.w.org/images/fonts/wp-6.7/collections/google-fonts-with-preview.json',
			'categories'    => array(
				array(
					'name' => _x( 'Sans Serif', 'font category' ),
					'slug' => 'sans-serif',
				),
				array(
					'name' => _x( 'Display', 'font category' ),
					'slug' => 'display',
				),
				array(
					'name' => _x( 'Serif', 'font category' ),
					'slug' => 'serif',
				),
				array(
					'name' => _x( 'Handwriting', 'font category' ),
					'slug' => 'handwriting',
				),
				array(
					'name' => _x( 'Monospace', 'font category' ),
					'slug' => 'monospace',
				),
			),
		)
	);
}

Type	Item Name	Actions
📁	..
📁	assets
📁	block-bindings
📁	block-patterns
📁	block-supports
📁	blocks
📁	certificates
📁	css
📁	customize
📁	fonts
📁	html-api
📁	ID3
📁	images
📁	interactivity-api
📁	IXR
📁	js
📁	l10n
📁	php-compat
📁	PHPMailer
📁	pomo
📁	Requests
📁	rest-api
📁	SimplePie
📁	sitemaps
📁	sodium_compat
📁	style-engine
📁	Text
📁	theme-compat
📁	widgets
📄	admin-bar.php
📄	atomlib.php
📄	author-template.php
📄	block-bindings.php
📄	block-editor.php
📄	block-i18n.json
📄	block-patterns.php
📄	block-template-utils.php
📄	block-template.php
📄	blocks.php
📄	bookmark-template.php
📄	bookmark.php
📄	cache-compat.php
📄	cache.php
📄	canonical.php
📄	capabilities.php
📄	category-template.php
📄	category.php
📄	class-avif-info.php
📄	class-feed.php
📄	class-http.php
📄	class-IXR.php
📄	class-json.php
📄	class-oembed.php
📄	class-phpass.php
📄	class-phpmailer.php
📄	class-pop3.php
📄	class-requests.php
📄	class-simplepie.php
📄	class-smtp.php
📄	class-snoopy.php
📄	class-walker-category-dropdown.php
📄	class-walker-category.php
📄	class-walker-comment.php
📄	class-walker-nav-menu.php
📄	class-walker-page-dropdown.php
📄	class-walker-page.php
📄	class-wp-admin-bar.php
📄	class-wp-ajax-response.php
📄	class-wp-application-passwords.php
📄	class-wp-block-bindings-registry.php
📄	class-wp-block-bindings-source.php
📄	class-wp-block-editor-context.php
📄	class-wp-block-list.php
📄	class-wp-block-metadata-registry.php
📄	class-wp-block-parser-block.php
📄	class-wp-block-parser-frame.php
📄	class-wp-block-parser.php
📄	class-wp-block-pattern-categories-registry.php
📄	class-wp-block-patterns-registry.php
📄	class-wp-block-styles-registry.php
📄	class-wp-block-supports.php
📄	class-wp-block-template.php
📄	class-wp-block-templates-registry.php
📄	class-wp-block-type-registry.php
📄	class-wp-block-type.php
📄	class-wp-block.php
📄	class-wp-classic-to-block-menu-converter.php
📄	class-wp-comment-query.php
📄	class-wp-comment.php
📄	class-wp-customize-control.php
📄	class-wp-customize-manager.php
📄	class-wp-customize-nav-menus.php
📄	class-wp-customize-panel.php
📄	class-wp-customize-section.php
📄	class-wp-customize-setting.php
📄	class-wp-customize-widgets.php
📄	class-wp-date-query.php
📄	class-wp-dependencies.php
📄	class-wp-dependency.php
📄	class-wp-duotone.php
📄	class-wp-editor.php
📄	class-wp-embed.php
📄	class-wp-error.php
📄	class-wp-exception.php
📄	class-wp-fatal-error-handler.php
📄	class-wp-feed-cache-transient.php
📄	class-wp-feed-cache.php
📄	class-wp-hook.php
📄	class-wp-http-cookie.php
📄	class-wp-http-curl.php
📄	class-wp-http-encoding.php
📄	class-wp-http-ixr-client.php
📄	class-wp-http-proxy.php
📄	class-wp-http-requests-hooks.php
📄	class-wp-http-requests-response.php
📄	class-wp-http-response.php
📄	class-wp-http-streams.php
📄	class-wp-http.php
📄	class-wp-image-editor-gd.php
📄	class-wp-image-editor-imagick.php
📄	class-wp-image-editor.php
📄	class-wp-list-util.php
📄	class-wp-locale-switcher.php
📄	class-wp-locale.php
📄	class-wp-matchesmapregex.php
📄	class-wp-meta-query.php
📄	class-wp-metadata-lazyloader.php
📄	class-wp-navigation-fallback.php
📄	class-wp-network-query.php
📄	class-wp-network.php
📄	class-wp-object-cache.php
📄	class-wp-oembed-controller.php
📄	class-wp-oembed.php
📄	class-wp-paused-extensions-storage.php
📄	class-wp-plugin-dependencies.php
📄	class-wp-post-type.php
📄	class-wp-post.php
📄	class-wp-query.php
📄	class-wp-recovery-mode-cookie-service.php
📄	class-wp-recovery-mode-email-service.php
📄	class-wp-recovery-mode-key-service.php
📄	class-wp-recovery-mode-link-service.php
📄	class-wp-recovery-mode.php
📄	class-wp-rewrite.php
📄	class-wp-role.php
📄	class-wp-roles.php
📄	class-wp-script-modules.php
📄	class-wp-scripts.php
📄	class-wp-session-tokens.php
📄	class-wp-simplepie-file.php
📄	class-wp-simplepie-sanitize-kses.php
📄	class-wp-site-query.php
📄	class-wp-site.php
📄	class-wp-styles.php
📄	class-wp-tax-query.php
📄	class-wp-taxonomy.php
📄	class-wp-term-query.php
📄	class-wp-term.php
📄	class-wp-text-diff-renderer-inline.php
📄	class-wp-text-diff-renderer-table.php
📄	class-wp-textdomain-registry.php
📄	class-wp-theme-json-data.php
📄	class-wp-theme-json-resolver.php
📄	class-wp-theme-json-schema.php
📄	class-wp-theme-json.php
📄	class-wp-theme.php
📄	class-wp-token-map.php
📄	class-wp-user-meta-session-tokens.php
📄	class-wp-user-query.php
📄	class-wp-user-request.php
📄	class-wp-user.php
📄	class-wp-walker.php
📄	class-wp-widget-factory.php
📄	class-wp-widget.php
📄	class-wp-xmlrpc-server.php
📄	class-wp.php
📄	class-wpdb.php
📄	class.wp-dependencies.php
📄	class.wp-scripts.php
📄	class.wp-styles.php
📄	comment-template.php
📄	comment.php
📄	compat.php
📄	cron.php
📄	date.php
📄	default-constants.php
📄	default-filters.php
📄	default-widgets.php
📄	deprecated.php
📄	embed-template.php
📄	embed.php
📄	error-protection.php
📄	feed-atom-comments.php
📄	feed-atom.php
📄	feed-rdf.php
📄	feed-rss.php
📄	feed-rss2-comments.php
📄	feed-rss2.php
📄	feed.php
📄	fonts.php
📄	formatting.php
📄	functions.php
📄	functions.wp-scripts.php
📄	functions.wp-styles.php
📄	general-template.php
📄	global-styles-and-settings.php
📄	http.php
📄	https-detection.php
📄	https-migration.php
📄	kses.php
📄	l10n.php
📄	link-template.php
📄	load.php
📄	locale.php
📄	media-template.php
📄	media.php
📄	meta.php
📄	ms-blogs.php
📄	ms-default-constants.php
📄	ms-default-filters.php
📄	ms-deprecated.php
📄	ms-files.php
📄	ms-functions.php
📄	ms-load.php
📄	ms-network.php
📄	ms-settings.php
📄	ms-site.php
📄	nav-menu-template.php
📄	nav-menu.php
📄	option.php
📄	pluggable-deprecated.php
📄	pluggable.php
📄	plugin.php
📄	post-formats.php
📄	post-template.php
📄	post-thumbnail-template.php
📄	post.php
📄	query.php
📄	registration-functions.php
📄	registration.php
📄	rest-api.php
📄	revision.php
📄	rewrite.php
📄	robots-template.php
📄	rss-functions.php
📄	rss.php
📄	script-loader.php
📄	script-modules.php
📄	session.php
📄	shortcodes.php
📄	sitemaps.php
📄	spl-autoload-compat.php
📄	style-engine.php
📄	taxonomy.php
📄	template-canvas.php
📄	template-loader.php
📄	template.php
📄	theme-i18n.json
📄	theme-previews.php
📄	theme-templates.php
📄	theme.json
📄	theme.php
📄	update.php
📄	user.php
📄	vars.php
📄	version.php
📄	widgets.php
📄	wp-db.php
📄	wp-diff.php