<h2>File Contents: /home/planet5/www/yanhuanghealthcare.co.uk/wp-includes/fonts/class-wp-font-collection.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/yanhuanghealthcare.co.uk/wp-includes/fonts/class-wp-font-collection.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php
/**
 * Font Collection class.
 *
 * This file contains the Font Collection class definition.
 *
 * @package    WordPress
 * @subpackage Fonts
 * @since      6.5.0
 */

/**
 * Font Collection class.
 *
 * @since 6.5.0
 *
 * @see wp_register_font_collection()
 */
final class WP_Font_Collection {
	/**
	 * The unique slug for the font collection.
	 *
	 * @since 6.5.0
	 * @var string
	 */
	public $slug;

	/**
	 * Font collection data.
	 *
	 * @since 6.5.0
	 * @var array|WP_Error|null
	 */
	private $data;

	/**
	 * Font collection JSON file path or URL.
	 *
	 * @since 6.5.0
	 * @var string|null
	 */
	private $src;

	/**
	 * WP_Font_Collection constructor.
	 *
	 * @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.
	 */
	public function __construct( string $slug, array $args ) {
		$this-&gt;slug = sanitize_title( $slug );
		if ( $this-&gt;slug !== $slug ) {
			_doing_it_wrong(
				__METHOD__,
				/* translators: %s: Font collection slug. */
				sprintf( __( &#039;Font collection slug &quot;%s&quot; is not valid. Slugs must use only alphanumeric characters, dashes, and underscores.&#039; ), $slug ),
				&#039;6.5.0&#039;
			);
		}

		$required_properties = array( &#039;name&#039;, &#039;font_families&#039; );

		if ( isset( $args[&#039;font_families&#039;] ) &amp;&amp; is_string( $args[&#039;font_families&#039;] ) ) {
			// JSON data is lazy loaded by ::get_data().
			$this-&gt;src = $args[&#039;font_families&#039;];
			unset( $args[&#039;font_families&#039;] );

			$required_properties = array( &#039;name&#039; );
		}

		$this-&gt;data = $this-&gt;sanitize_and_validate_data( $args, $required_properties );
	}

	/**
	 * Retrieves the font collection data.
	 *
	 * @since 6.5.0
	 *
	 * @return array|WP_Error An array containing the font collection data, or a WP_Error on failure.
	 */
	public function get_data() {
		if ( is_wp_error( $this-&gt;data ) ) {
			return $this-&gt;data;
		}

		// If the collection uses JSON data, load it and cache the data/error.
		if ( isset( $this-&gt;src ) ) {
			$this-&gt;data = $this-&gt;load_from_json( $this-&gt;src );
		}

		if ( is_wp_error( $this-&gt;data ) ) {
			return $this-&gt;data;
		}

		// Set defaults for optional properties.
		$defaults = array(
			&#039;description&#039; =&gt; &#039;&#039;,
			&#039;categories&#039;  =&gt; array(),
		);

		return wp_parse_args( $this-&gt;data, $defaults );
	}

	/**
	 * Loads font collection data from a JSON file or URL.
	 *
	 * @since 6.5.0
	 *
	 * @param string $file_or_url File path or URL to a JSON file containing the font collection data.
	 * @return array|WP_Error An array containing the font collection data on success,
	 *                        else an instance of WP_Error on failure.
	 */
	private function load_from_json( $file_or_url ) {
		$url  = wp_http_validate_url( $file_or_url );
		$file = file_exists( $file_or_url ) ? wp_normalize_path( realpath( $file_or_url ) ) : false;

		if ( ! $url &amp;&amp; ! $file ) {
			// translators: %s: File path or URL to font collection JSON file.
			$message = __( &#039;Font collection JSON file is invalid or does not exist.&#039; );
			_doing_it_wrong( __METHOD__, $message, &#039;6.5.0&#039; );
			return new WP_Error( &#039;font_collection_json_missing&#039;, $message );
		}

		$data = $url ? $this-&gt;load_from_url( $url ) : $this-&gt;load_from_file( $file );

		if ( is_wp_error( $data ) ) {
			return $data;
		}

		$data = array(
			&#039;name&#039;          =&gt; $this-&gt;data[&#039;name&#039;],
			&#039;font_families&#039; =&gt; $data[&#039;font_families&#039;],
		);

		if ( isset( $this-&gt;data[&#039;description&#039;] ) ) {
			$data[&#039;description&#039;] = $this-&gt;data[&#039;description&#039;];
		}

		if ( isset( $this-&gt;data[&#039;categories&#039;] ) ) {
			$data[&#039;categories&#039;] = $this-&gt;data[&#039;categories&#039;];
		}

		return $data;
	}

	/**
	 * Loads the font collection data from a JSON file path.
	 *
	 * @since 6.5.0
	 *
	 * @param string $file File path to a JSON file containing the font collection data.
	 * @return array|WP_Error An array containing the font collection data on success,
	 *                        else an instance of WP_Error on failure.
	 */
	private function load_from_file( $file ) {
		$data = wp_json_file_decode( $file, array( &#039;associative&#039; =&gt; true ) );
		if ( empty( $data ) ) {
			return new WP_Error( &#039;font_collection_decode_error&#039;, __( &#039;Error decoding the font collection JSON file contents.&#039; ) );
		}

		return $this-&gt;sanitize_and_validate_data( $data, array( &#039;font_families&#039; ) );
	}

	/**
	 * Loads the font collection data from a JSON file URL.
	 *
	 * @since 6.5.0
	 *
	 * @param string $url URL to a JSON file containing the font collection data.
	 * @return array|WP_Error An array containing the font collection data on success,
	 *                        else an instance of WP_Error on failure.
	 */
	private function load_from_url( $url ) {
		// Limit key to 167 characters to avoid failure in the case of a long URL.
		$transient_key = substr( &#039;wp_font_collection_url_&#039; . $url, 0, 167 );
		$data          = get_site_transient( $transient_key );

		if ( false === $data ) {
			$response = wp_safe_remote_get( $url );
			if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) {
				return new WP_Error(
					&#039;font_collection_request_error&#039;,
					sprintf(
						// translators: %s: Font collection URL.
						__( &#039;Error fetching the font collection data from &quot;%s&quot;.&#039; ),
						$url
					)
				);
			}

			$data = json_decode( wp_remote_retrieve_body( $response ), true );
			if ( empty( $data ) ) {
				return new WP_Error( &#039;font_collection_decode_error&#039;, __( &#039;Error decoding the font collection data from the HTTP response JSON.&#039; ) );
			}

			// Make sure the data is valid before storing it in a transient.
			$data = $this-&gt;sanitize_and_validate_data( $data, array( &#039;font_families&#039; ) );
			if ( is_wp_error( $data ) ) {
				return $data;
			}

			set_site_transient( $transient_key, $data, DAY_IN_SECONDS );
		}

		return $data;
	}

	/**
	 * Sanitizes and validates the font collection data.
	 *
	 * @since 6.5.0
	 *
	 * @param array $data                Font collection data to sanitize and validate.
	 * @param array $required_properties Required properties that must exist in the passed data.
	 * @return array|WP_Error Sanitized data if valid, otherwise a WP_Error instance.
	 */
	private function sanitize_and_validate_data( $data, $required_properties = array() ) {
		$schema = self::get_sanitization_schema();
		$data   = WP_Font_Utils::sanitize_from_schema( $data, $schema );

		foreach ( $required_properties as $property ) {
			if ( empty( $data[ $property ] ) ) {
				$message = sprintf(
					// translators: 1: Font collection slug, 2: Missing property name, e.g. &quot;font_families&quot;.
					__( &#039;Font collection &quot;%1$s&quot; has missing or empty property: &quot;%2$s&quot;.&#039; ),
					$this-&gt;slug,
					$property
				);
				_doing_it_wrong( __METHOD__, $message, &#039;6.5.0&#039; );
				return new WP_Error( &#039;font_collection_missing_property&#039;, $message );
			}
		}

		return $data;
	}

	/**
	 * Retrieves the font collection sanitization schema.
	 *
	 * @since 6.5.0
	 *
	 * @return array Font collection sanitization schema.
	 */
	private static function get_sanitization_schema() {
		return array(
			&#039;name&#039;          =&gt; &#039;sanitize_text_field&#039;,
			&#039;description&#039;   =&gt; &#039;sanitize_text_field&#039;,
			&#039;font_families&#039; =&gt; array(
				array(
					&#039;font_family_settings&#039; =&gt; array(
						&#039;name&#039;       =&gt; &#039;sanitize_text_field&#039;,
						&#039;slug&#039;       =&gt; static function ( $value ) {
							return _wp_to_kebab_case( sanitize_title( $value ) );
						},
						&#039;fontFamily&#039; =&gt; &#039;WP_Font_Utils::sanitize_font_family&#039;,
						&#039;preview&#039;    =&gt; &#039;sanitize_url&#039;,
						&#039;fontFace&#039;   =&gt; array(
							array(
								&#039;fontFamily&#039;            =&gt; &#039;sanitize_text_field&#039;,
								&#039;fontStyle&#039;             =&gt; &#039;sanitize_text_field&#039;,
								&#039;fontWeight&#039;            =&gt; &#039;sanitize_text_field&#039;,
								&#039;src&#039;                   =&gt; static function ( $value ) {
									return is_array( $value )
										? array_map( &#039;sanitize_text_field&#039;, $value )
										: sanitize_text_field( $value );
								},
								&#039;preview&#039;               =&gt; &#039;sanitize_url&#039;,
								&#039;fontDisplay&#039;           =&gt; &#039;sanitize_text_field&#039;,
								&#039;fontStretch&#039;           =&gt; &#039;sanitize_text_field&#039;,
								&#039;ascentOverride&#039;        =&gt; &#039;sanitize_text_field&#039;,
								&#039;descentOverride&#039;       =&gt; &#039;sanitize_text_field&#039;,
								&#039;fontVariant&#039;           =&gt; &#039;sanitize_text_field&#039;,
								&#039;fontFeatureSettings&#039;   =&gt; &#039;sanitize_text_field&#039;,
								&#039;fontVariationSettings&#039; =&gt; &#039;sanitize_text_field&#039;,
								&#039;lineGapOverride&#039;       =&gt; &#039;sanitize_text_field&#039;,
								&#039;sizeAdjust&#039;            =&gt; &#039;sanitize_text_field&#039;,
								&#039;unicodeRange&#039;          =&gt; &#039;sanitize_text_field&#039;,
							),
						),
					),
					&#039;categories&#039;           =&gt; array( &#039;sanitize_title&#039; ),
				),
			),
			&#039;categories&#039;    =&gt; array(
				array(
					&#039;name&#039; =&gt; &#039;sanitize_text_field&#039;,
					&#039;slug&#039; =&gt; &#039;sanitize_title&#039;,
				),
			),
		);
	}
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyanhuanghealthcare.co.uk%2Fwp-includes%2Ffonts'>⬅ Back to Directory</a>