<?php
/**
 * Polyfills used by Behat to support multiple versions of WP.
 *
 * This file will get installed as a must-use plugin in WP installs that are run
 * by the functional tests.
 */

/*
 * Add a polyfill for the get_theme_file_uri(), as it is required for the
 * TwentyTwenty theme's starter content, and will fatal the site if you install
 * WP 5.3 first (setting TwentyTwenty as the active theme) and then downgrade
 * to a version of WP lower than 4.7.
 *
 * Note: This is a quick fix, and a cleaner solution would be to change the
 * active theme on downgrading, if the current theme declares it is not
 * supported.
 *
 * See: https://github.com/WordPress/twentytwenty/issues/973
 */
if ( ! function_exists( 'get_theme_file_uri' ) ) {
	/**
	 * Retrieves the URL of a file in the theme.
	 *
	 * Searches in the stylesheet directory before the template directory so themes
	 * which inherit from a parent theme can just override one file.
	 *
	 * @since 4.7.0
	 *
	 * @param string $file Optional. File to search for in the stylesheet directory.
	 * @return string The URL of the file.
	 */
	function get_theme_file_uri( $file = '' ) {
		$file = ltrim( $file, '/' );

		if ( empty( $file ) ) {
			$url = get_stylesheet_directory_uri();
		} elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
			$url = get_stylesheet_directory_uri() . '/' . $file;
		} else {
			$url = get_template_directory_uri() . '/' . $file;
		}

		/**
		 * Filters the URL to a file in the theme.
		 *
		 * @since 4.7.0
		 *
		 * @param string $url  The file URL.
		 * @param string $file The requested file to search for.
		 */
		return apply_filters( 'theme_file_uri', $url, $file );
	}
}

/*
 * Add a polyfill for the is_customize_preview(), as it is required for the
 * TwentyTwenty theme's starter content, and will fatal the site if you install
 * WP 5.3 first (setting TwentyTwenty as the active theme) and then downgrade
 * to a version of WP lower than 4.0.
 *
 * Note: This is a quick fix, and a cleaner solution would be to change the
 * active theme on downgrading, if the current theme declares it is not
 * supported.
 *
 * See: https://github.com/WordPress/twentytwenty/issues/973
 */
if ( ! function_exists( 'is_customize_preview' ) ) {
	/**
	 * Whether the site is being previewed in the Customizer.
	 *
	 * @since 4.0.0
	 *
	 * @global WP_Customize_Manager $wp_customize Customizer instance.
	 *
	 * @return bool True if the site is being previewed in the Customizer, false otherwise.
	 */
	function is_customize_preview() {
		return false;
	}
}