_wp_theme_json_webfonts_handler()

Description

Uses · 19

• _deprecated_function()Marks a function as deprecated and inform when it has been used.
• wp_installing()Checks or sets whether WordPress is in "installation" mode.
• wp_theme_has_theme_json()Checks whether a theme or its parent has a theme.json file.
• is_admin()Determines whether the current request is for an administrative interface page.
• wp_is_rest_endpoint()Checks whether a REST API endpoint request is currently being handled.
• str_starts_with()Polyfill for `str_starts_with()` function added in PHP 8.0.
• get_theme_file_uri()Retrieves the URL of a file in the theme.
• _wp_to_kebab_case()This function is trying to replicate what lodash's kebabCase (JS library) does in the client.
• wp_parse_args()Merges user defined arguments into defaults array.
• __()Retrieves the translation of $text.
• sanitize_url()Sanitizes a URL for database or redirect usage.
• str_contains()Polyfill for `str_contains()` function added in PHP 8.0.

Source

View on Trac ↗View on GitHub ↗

5417function _wp_theme_json_webfonts_handler() {5418	_deprecated_function( __FUNCTION__, '6.4.0', 'wp_print_font_faces' );5419 5420	// Block themes are unavailable during installation.5421	if ( wp_installing() ) {5422		return;5423	}5424 5425	if ( ! wp_theme_has_theme_json() ) {5426		return;5427	}5428 5429	// Webfonts to be processed.5430	$registered_webfonts = array();5431 5432	/**5433	 * Gets the webfonts from theme.json.5434	 *5435	 * @since 6.0.05436	 *5437	 * @return array Array of defined webfonts.5438	 */5439	$fn_get_webfonts_from_theme_json = static function() {5440		// Get settings from theme.json.5441		$settings = WP_Theme_JSON_Resolver::get_merged_data()->get_settings();5442 5443		// If in the editor, add webfonts defined in variations.5444		if ( is_admin() || wp_is_rest_endpoint() ) {5445			$variations = WP_Theme_JSON_Resolver::get_style_variations();5446			foreach ( $variations as $variation ) {5447				// Skip if fontFamilies are not defined in the variation.5448				if ( empty( $variation['settings']['typography']['fontFamilies'] ) ) {5449					continue;5450				}5451 5452				// Initialize the array structure.5453				if ( empty( $settings['typography'] ) ) {5454					$settings['typography'] = array();5455				}5456				if ( empty( $settings['typography']['fontFamilies'] ) ) {5457					$settings['typography']['fontFamilies'] = array();5458				}5459				if ( empty( $settings['typography']['fontFamilies']['theme'] ) ) {5460					$settings['typography']['fontFamilies']['theme'] = array();5461				}5462 5463				// Combine variations with settings. Remove duplicates.5464				$settings['typography']['fontFamilies']['theme'] = array_merge( $settings['typography']['fontFamilies']['theme'], $variation['settings']['typography']['fontFamilies']['theme'] );5465				$settings['typography']['fontFamilies']          = array_unique( $settings['typography']['fontFamilies'] );5466			}5467		}5468 5469		// Bail out early if there are no settings for webfonts.5470		if ( empty( $settings['typography']['fontFamilies'] ) ) {5471			return array();5472		}5473 5474		$webfonts = array();5475 5476		// Look for fontFamilies.5477		foreach ( $settings['typography']['fontFamilies'] as $font_families ) {5478			foreach ( $font_families as $font_family ) {5479 5480				// Skip if fontFace is not defined.5481				if ( empty( $font_family['fontFace'] ) ) {5482					continue;5483				}5484 5485				// Skip if fontFace is not an array of webfonts.5486				if ( ! is_array( $font_family['fontFace'] ) ) {5487					continue;5488				}5489 5490				$webfonts = array_merge( $webfonts, $font_family['fontFace'] );5491			}5492		}5493 5494		return $webfonts;5495	};5496

History

Introduced in 6.0.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-includes/deprecated.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.