<h2>Редактирование файла: block-template-utils.php</h2><p><strong>Путь:</strong> /home/atomylvb/jarangomd.com/old/wp-includes/block-template-utils.php</p><form method="post"><textarea name="content" rows="20" cols="100">&lt;?php
/**
 * Utilities used to fetch and create templates and template parts.
 *
 * @package WordPress
 * @since 5.8.0
 */

// Define constants for supported wp_template_part_area taxonomy.
if ( ! defined( &#039;WP_TEMPLATE_PART_AREA_HEADER&#039; ) ) {
	define( &#039;WP_TEMPLATE_PART_AREA_HEADER&#039;, &#039;header&#039; );
}
if ( ! defined( &#039;WP_TEMPLATE_PART_AREA_FOOTER&#039; ) ) {
	define( &#039;WP_TEMPLATE_PART_AREA_FOOTER&#039;, &#039;footer&#039; );
}
if ( ! defined( &#039;WP_TEMPLATE_PART_AREA_SIDEBAR&#039; ) ) {
	define( &#039;WP_TEMPLATE_PART_AREA_SIDEBAR&#039;, &#039;sidebar&#039; );
}
if ( ! defined( &#039;WP_TEMPLATE_PART_AREA_UNCATEGORIZED&#039; ) ) {
	define( &#039;WP_TEMPLATE_PART_AREA_UNCATEGORIZED&#039;, &#039;uncategorized&#039; );
}

/**
 * For backward compatibility reasons,
 * block themes might be using block-templates or block-template-parts,
 * this function ensures we fallback to these folders properly.
 *
 * @since 5.9.0
 *
 * @param string $theme_stylesheet The stylesheet. Default is to leverage the main theme root.
 *
 * @return string[] {
 *     Folder names used by block themes.
 *
 *     @type string $wp_template      Theme-relative directory name for block templates.
 *     @type string $wp_template_part Theme-relative directory name for block template parts.
 * }
 */
function get_block_theme_folders( $theme_stylesheet = null ) {
	$theme = wp_get_theme( (string) $theme_stylesheet );
	if ( ! $theme-&gt;exists() ) {
		// Return the default folders if the theme doesn&#039;t exist.
		return array(
			&#039;wp_template&#039;      =&gt; &#039;templates&#039;,
			&#039;wp_template_part&#039; =&gt; &#039;parts&#039;,
		);
	}
	return $theme-&gt;get_block_template_folders();
}

/**
 * Returns a filtered list of allowed area values for template parts.
 *
 * @since 5.9.0
 *
 * @return array[] {
 *     The allowed template part area values.
 *
 *     @type array ...$0 {
 *         Data for the allowed template part area.
 *
 *         @type string $area        Template part area name.
 *         @type string $label       Template part area label.
 *         @type string $description Template part area description.
 *         @type string $icon        Template part area icon.
 *         @type string $area_tag    Template part area tag.
 *     }
 * }
 */
function get_allowed_block_template_part_areas() {
	$default_area_definitions = array(
		array(
			&#039;area&#039;        =&gt; WP_TEMPLATE_PART_AREA_UNCATEGORIZED,
			&#039;label&#039;       =&gt; _x( &#039;General&#039;, &#039;template part area&#039; ),
			&#039;description&#039; =&gt; __(
				&#039;General templates often perform a specific role like displaying post content, and are not tied to any particular area.&#039;
			),
			&#039;icon&#039;        =&gt; &#039;layout&#039;,
			&#039;area_tag&#039;    =&gt; &#039;div&#039;,
		),
		array(
			&#039;area&#039;        =&gt; WP_TEMPLATE_PART_AREA_HEADER,
			&#039;label&#039;       =&gt; _x( &#039;Header&#039;, &#039;template part area&#039; ),
			&#039;description&#039; =&gt; __(
				&#039;The Header template defines a page area that typically contains a title, logo, and main navigation.&#039;
			),
			&#039;icon&#039;        =&gt; &#039;header&#039;,
			&#039;area_tag&#039;    =&gt; &#039;header&#039;,
		),
		array(
			&#039;area&#039;        =&gt; WP_TEMPLATE_PART_AREA_FOOTER,
			&#039;label&#039;       =&gt; _x( &#039;Footer&#039;, &#039;template part area&#039; ),
			&#039;description&#039; =&gt; __(
				&#039;The Footer template defines a page area that typically contains site credits, social links, or any other combination of blocks.&#039;
			),
			&#039;icon&#039;        =&gt; &#039;footer&#039;,
			&#039;area_tag&#039;    =&gt; &#039;footer&#039;,
		),
	);

	/**
	 * Filters the list of allowed template part area values.
	 *
	 * @since 5.9.0
	 *
	 * @param array[] $default_area_definitions {
	 *     The allowed template part area values.
	 *
	 *     @type array ...$0 {
	 *         Data for the template part area.
	 *
	 *         @type string $area        Template part area name.
	 *         @type string $label       Template part area label.
	 *         @type string $description Template part area description.
	 *         @type string $icon        Template part area icon.
	 *         @type string $area_tag    Template part area tag.
	 *     }
	 * }
	 */
	return apply_filters( &#039;default_wp_template_part_areas&#039;, $default_area_definitions );
}


/**
 * Returns a filtered list of default template types, containing their
 * localized titles and descriptions.
 *
 * @since 5.9.0
 *
 * @return array[] {
 *     The default template types.
 *
 *     @type array ...$0 {
 *         Data for the template type.
 *
 *         @type string $title       Template type title.
 *         @type string $description Template type description.
 *    }
 * }
 */
function get_default_block_template_types() {
	$default_template_types = array(
		&#039;index&#039;          =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Index&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Used as a fallback template for all pages when a more specific template is not defined.&#039; ),
		),
		&#039;home&#039;           =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Blog Home&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays the latest posts as either the site homepage or as the &quot;Posts page&quot; as defined under reading settings. If it exists, the Front Page template overrides this template when posts are shown on the homepage.&#039; ),
		),
		&#039;front-page&#039;     =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Front Page&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays your site\&#039;s homepage, whether it is set to display latest posts or a static page. The Front Page template takes precedence over all templates.&#039; ),
		),
		&#039;singular&#039;       =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Single Entries&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays any single entry, such as a post or a page. This template will serve as a fallback when a more specific template (e.g. Single Post, Page, or Attachment) cannot be found.&#039; ),
		),
		&#039;single&#039;         =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Single Posts&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays a single post on your website unless a custom template has been applied to that post or a dedicated template exists.&#039; ),
		),
		&#039;page&#039;           =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Pages&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays a static page unless a custom template has been applied to that page or a dedicated template exists.&#039; ),
		),
		&#039;archive&#039;        =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;All Archives&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays any archive, including posts by a single author, category, tag, taxonomy, custom post type, and date. This template will serve as a fallback when more specific templates (e.g. Category or Tag) cannot be found.&#039; ),
		),
		&#039;author&#039;         =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Author Archives&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays a single author\&#039;s post archive. This template will serve as a fallback when a more specific template (e.g. Author: Admin) cannot be found.&#039; ),
		),
		&#039;category&#039;       =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Category Archives&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays a post category archive. This template will serve as a fallback when a more specific template (e.g. Category: Recipes) cannot be found.&#039; ),
		),
		&#039;taxonomy&#039;       =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Taxonomy&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays a custom taxonomy archive. Like categories and tags, taxonomies have terms which you use to classify things. For example: a taxonomy named &quot;Art&quot; can have multiple terms, such as &quot;Modern&quot; and &quot;18th Century.&quot; This template will serve as a fallback when a more specific template (e.g. Taxonomy: Art) cannot be found.&#039; ),
		),
		&#039;date&#039;           =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Date Archives&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays a post archive when a specific date is visited (e.g., example.com/2023/).&#039; ),
		),
		&#039;tag&#039;            =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Tag Archives&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays a post tag archive. This template will serve as a fallback when a more specific template (e.g. Tag: Pizza) cannot be found.&#039; ),
		),
		&#039;attachment&#039;     =&gt; array(
			&#039;title&#039;       =&gt; __( &#039;Attachment Pages&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays when a visitor views the dedicated page that exists for any media attachment.&#039; ),
		),
		&#039;search&#039;         =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Search Results&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays when a visitor performs a search on your website.&#039; ),
		),
		&#039;privacy-policy&#039; =&gt; array(
			&#039;title&#039;       =&gt; __( &#039;Privacy Policy&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays your site\&#039;s Privacy Policy page.&#039; ),
		),
		&#039;404&#039;            =&gt; array(
			&#039;title&#039;       =&gt; _x( &#039;Page: 404&#039;, &#039;Template name&#039; ),
			&#039;description&#039; =&gt; __( &#039;Displays when a visitor views a non-existent page, such as a dead link or a mistyped URL.&#039; ),
		),
	);

	// Add a title and description to post format templates.
	$post_formats = get_post_format_strings();
	foreach ( $post_formats as $post_format_slug =&gt; $post_format_name ) {
		$default_template_types[ &#039;taxonomy-post_format-post-format-&#039; . $post_format_slug ] = array(
			&#039;title&#039;       =&gt; sprintf(
				/* translators: %s: Post format name. */
				_x( &#039;Post Format: %s&#039;, &#039;Template name&#039; ),
				$post_format_name
			),
			&#039;description&#039; =&gt; sprintf(
				/* translators: %s: Post format name. */
				__( &#039;Displays the %s post format archive.&#039; ),
				$post_format_name
			),
		);
	}

	/**
	 * Filters the list of default template types.
	 *
	 * @since 5.9.0
	 *
	 * @param array[] $default_template_types {
	 *     The default template types.
	 *
	 *     @type array ...$0 {
	 *         Data for the template type.
	 *
	 *         @type string $title       Template type title.
	 *         @type string $description Template type description.
	 *    }
	 * }
	 */
	return apply_filters( &#039;default_template_types&#039;, $default_template_types );
}

/**
 * Checks whether the input &#039;area&#039; is a supported value.
 * Returns the input if supported, otherwise returns the &#039;uncategorized&#039; value.
 *
 * @since 5.9.0
 * @access private
 *
 * @param string $type Template part area name.
 * @return string Input if supported, else the uncategorized value.
 */
function _filter_block_template_part_area( $type ) {
	$allowed_areas = array_map(
		static function ( $item ) {
			return $item[&#039;area&#039;];
		},
		get_allowed_block_template_part_areas()
	);
	if ( in_array( $type, $allowed_areas, true ) ) {
		return $type;
	}

	$warning_message = sprintf(
		/* translators: %1$s: Template area type, %2$s: the uncategorized template area value. */
		__( &#039;&quot;%1$s&quot; is not a supported wp_template_part area value and has been added as &quot;%2$s&quot;.&#039; ),
		$type,
		WP_TEMPLATE_PART_AREA_UNCATEGORIZED
	);
	wp_trigger_error( __FUNCTION__, $warning_message );
	return WP_TEMPLATE_PART_AREA_UNCATEGORIZED;
}

/**
 * Finds all nested template part file paths in a theme&#039;s directory.
 *
 * @since 5.9.0
 * @access private
 *
 * @param string $base_directory The theme&#039;s file path.
 * @return string[] A list of paths to all template part files.
 */
function _get_block_templates_paths( $base_directory ) {
	static $template_path_list = array();
	if ( isset( $template_path_list[ $base_directory ] ) ) {
		return $template_path_list[ $base_directory ];
	}
	$path_list = array();
	if ( is_dir( $base_directory ) ) {
		$nested_files      = new RecursiveIteratorIterator( new RecursiveDirectoryIterator( $base_directory ) );
		$nested_html_files = new RegexIterator( $nested_files, &#039;/^.+\.html$/i&#039;, RecursiveRegexIterator::GET_MATCH );
		foreach ( $nested_html_files as $path =&gt; $file ) {
			$path_list[] = $path;
		}
	}
	$template_path_list[ $base_directory ] = $path_list;
	return $path_list;
}

/**
 * Retrieves the template file from the theme for a given slug.
 *
 * @since 5.9.0
 * @access private
 *
 * @param string $template_type Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
 * @param string $slug          Template slug.
 * @return array|null {
 *     Array with template metadata if $template_type is one of &#039;wp_template&#039; or &#039;wp_template_part&#039;,
 *     null otherwise.
 *
 *     @type string   $slug      Template slug.
 *     @type string   $path      Template file path.
 *     @type string   $theme     Theme slug.
 *     @type string   $type      Template type.
 *     @type string   $area      Template area. Only for &#039;wp_template_part&#039;.
 *     @type string   $title     Optional. Template title.
 *     @type string[] $postTypes Optional. List of post types that the template supports. Only for &#039;wp_template&#039;.
 * }
 */
function _get_block_template_file( $template_type, $slug ) {
	if ( &#039;wp_template&#039; !== $template_type &amp;&amp; &#039;wp_template_part&#039; !== $template_type ) {
		return null;
	}

	$themes = array(
		get_stylesheet() =&gt; get_stylesheet_directory(),
		get_template()   =&gt; get_template_directory(),
	);
	foreach ( $themes as $theme_slug =&gt; $theme_dir ) {
		$template_base_paths = get_block_theme_folders( $theme_slug );
		$file_path           = $theme_dir . &#039;/&#039; . $template_base_paths[ $template_type ] . &#039;/&#039; . $slug . &#039;.html&#039;;
		if ( file_exists( $file_path ) ) {
			$new_template_item = array(
				&#039;slug&#039;  =&gt; $slug,
				&#039;path&#039;  =&gt; $file_path,
				&#039;theme&#039; =&gt; $theme_slug,
				&#039;type&#039;  =&gt; $template_type,
			);

			if ( &#039;wp_template_part&#039; === $template_type ) {
				return _add_block_template_part_area_info( $new_template_item );
			}

			// If it&#039;s not a `wp_template_part`, it must be a `wp_template`.
			return _add_block_template_info( $new_template_item );
		}
	}

	return null;
}

/**
 * Retrieves the template files from the theme.
 *
 * @since 5.9.0
 * @since 6.3.0 Added the `$query` parameter.
 * @access private
 *
 * @param string $template_type Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
 * @param array  $query {
 *     Arguments to retrieve templates. Optional, empty by default.
 *
 *     @type string[] $slug__in     List of slugs to include.
 *     @type string[] $slug__not_in List of slugs to skip.
 *     @type string   $area         A &#039;wp_template_part_area&#039; taxonomy value to filter by (for &#039;wp_template_part&#039; template type only).
 *     @type string   $post_type    Post type to get the templates for.
 * }
 *
 * @return array|null Template files on success, null if `$template_type` is not matched.
 */
function _get_block_templates_files( $template_type, $query = array() ) {
	if ( &#039;wp_template&#039; !== $template_type &amp;&amp; &#039;wp_template_part&#039; !== $template_type ) {
		return null;
	}

	$default_template_types = array();
	if ( &#039;wp_template&#039; === $template_type ) {
		$default_template_types = get_default_block_template_types();
	}

	// Prepare metadata from $query.
	$slugs_to_include = isset( $query[&#039;slug__in&#039;] ) ? $query[&#039;slug__in&#039;] : array();
	$slugs_to_skip    = isset( $query[&#039;slug__not_in&#039;] ) ? $query[&#039;slug__not_in&#039;] : array();
	$area             = isset( $query[&#039;area&#039;] ) ? $query[&#039;area&#039;] : null;
	$post_type        = isset( $query[&#039;post_type&#039;] ) ? $query[&#039;post_type&#039;] : &#039;&#039;;

	$stylesheet = get_stylesheet();
	$template   = get_template();
	$themes     = array(
		$stylesheet =&gt; get_stylesheet_directory(),
	);
	// Add the parent theme if it&#039;s not the same as the current theme.
	if ( $stylesheet !== $template ) {
		$themes[ $template ] = get_template_directory();
	}
	$template_files = array();
	foreach ( $themes as $theme_slug =&gt; $theme_dir ) {
		$template_base_paths  = get_block_theme_folders( $theme_slug );
		$theme_template_files = _get_block_templates_paths( $theme_dir . &#039;/&#039; . $template_base_paths[ $template_type ] );
		foreach ( $theme_template_files as $template_file ) {
			$template_base_path = $template_base_paths[ $template_type ];
			$template_slug      = substr(
				$template_file,
				// Starting position of slug.
				strpos( $template_file, $template_base_path . DIRECTORY_SEPARATOR ) + 1 + strlen( $template_base_path ),
				// Subtract ending &#039;.html&#039;.
				-5
			);

			// Skip this item if its slug doesn&#039;t match any of the slugs to include.
			if ( ! empty( $slugs_to_include ) &amp;&amp; ! in_array( $template_slug, $slugs_to_include, true ) ) {
				continue;
			}

			// Skip this item if its slug matches any of the slugs to skip.
			if ( ! empty( $slugs_to_skip ) &amp;&amp; in_array( $template_slug, $slugs_to_skip, true ) ) {
				continue;
			}

			/*
			 * The child theme items (stylesheet) are processed before the parent theme&#039;s (template).
			 * If a child theme defines a template, prevent the parent template from being added to the list as well.
			 */
			if ( isset( $template_files[ $template_slug ] ) ) {
				continue;
			}

			$new_template_item = array(
				&#039;slug&#039;  =&gt; $template_slug,
				&#039;path&#039;  =&gt; $template_file,
				&#039;theme&#039; =&gt; $theme_slug,
				&#039;type&#039;  =&gt; $template_type,
			);

			if ( &#039;wp_template_part&#039; === $template_type ) {
				$candidate = _add_block_template_part_area_info( $new_template_item );
				if ( ! isset( $area ) || $area === $candidate[&#039;area&#039;] ) {
					$template_files[ $template_slug ] = $candidate;
				}
			}

			if ( &#039;wp_template&#039; === $template_type ) {
				$candidate = _add_block_template_info( $new_template_item );
				$is_custom = ! isset( $default_template_types[ $candidate[&#039;slug&#039;] ] );

				if (
					! $post_type ||
					( $post_type &amp;&amp; isset( $candidate[&#039;postTypes&#039;] ) &amp;&amp; in_array( $post_type, $candidate[&#039;postTypes&#039;], true ) )
				) {
					$template_files[ $template_slug ] = $candidate;
				}

				// The custom templates with no associated post types are available for all post types.
				if ( $post_type &amp;&amp; ! isset( $candidate[&#039;postTypes&#039;] ) &amp;&amp; $is_custom ) {
					$template_files[ $template_slug ] = $candidate;
				}
			}
		}
	}

	return array_values( $template_files );
}

/**
 * Attempts to add custom template information to the template item.
 *
 * @since 5.9.0
 * @access private
 *
 * @param array $template_item Template to add information to (requires &#039;slug&#039; field).
 * @return array Template item.
 */
function _add_block_template_info( $template_item ) {
	if ( ! wp_theme_has_theme_json() ) {
		return $template_item;
	}

	$theme_data = wp_get_theme_data_custom_templates();
	if ( isset( $theme_data[ $template_item[&#039;slug&#039;] ] ) ) {
		$template_item[&#039;title&#039;]     = $theme_data[ $template_item[&#039;slug&#039;] ][&#039;title&#039;];
		$template_item[&#039;postTypes&#039;] = $theme_data[ $template_item[&#039;slug&#039;] ][&#039;postTypes&#039;];
	}

	return $template_item;
}

/**
 * Attempts to add the template part&#039;s area information to the input template.
 *
 * @since 5.9.0
 * @access private
 *
 * @param array $template_info Template to add information to (requires &#039;type&#039; and &#039;slug&#039; fields).
 * @return array Template info.
 */
function _add_block_template_part_area_info( $template_info ) {
	if ( wp_theme_has_theme_json() ) {
		$theme_data = wp_get_theme_data_template_parts();
	}

	if ( isset( $theme_data[ $template_info[&#039;slug&#039;] ][&#039;area&#039;] ) ) {
		$template_info[&#039;title&#039;] = $theme_data[ $template_info[&#039;slug&#039;] ][&#039;title&#039;];
		$template_info[&#039;area&#039;]  = _filter_block_template_part_area( $theme_data[ $template_info[&#039;slug&#039;] ][&#039;area&#039;] );
	} else {
		$template_info[&#039;area&#039;] = WP_TEMPLATE_PART_AREA_UNCATEGORIZED;
	}

	return $template_info;
}

/**
 * Returns an array containing the references of
 * the passed blocks and their inner blocks.
 *
 * @since 5.9.0
 * @access private
 *
 * @param array $blocks array of blocks.
 * @return array block references to the passed blocks and their inner blocks.
 */
function _flatten_blocks( &amp;$blocks ) {
	$all_blocks = array();
	$queue      = array();
	foreach ( $blocks as &amp;$block ) {
		$queue[] = &amp;$block;
	}

	while ( count( $queue ) &gt; 0 ) {
		$block = &amp;$queue[0];
		array_shift( $queue );
		$all_blocks[] = &amp;$block;

		if ( ! empty( $block[&#039;innerBlocks&#039;] ) ) {
			foreach ( $block[&#039;innerBlocks&#039;] as &amp;$inner_block ) {
				$queue[] = &amp;$inner_block;
			}
		}
	}

	return $all_blocks;
}

/**
 * Injects the active theme&#039;s stylesheet as a `theme` attribute
 * into a given template part block.
 *
 * @since 6.4.0
 * @access private
 *
 * @param array $block a parsed block.
 */
function _inject_theme_attribute_in_template_part_block( &amp;$block ) {
	if (
		&#039;core/template-part&#039; === $block[&#039;blockName&#039;] &amp;&amp;
		! isset( $block[&#039;attrs&#039;][&#039;theme&#039;] )
	) {
		$block[&#039;attrs&#039;][&#039;theme&#039;] = get_stylesheet();
	}
}

/**
 * Removes the `theme` attribute from a given template part block.
 *
 * @since 6.4.0
 * @access private
 *
 * @param array $block a parsed block.
 */
function _remove_theme_attribute_from_template_part_block( &amp;$block ) {
	if (
		&#039;core/template-part&#039; === $block[&#039;blockName&#039;] &amp;&amp;
		isset( $block[&#039;attrs&#039;][&#039;theme&#039;] )
	) {
		unset( $block[&#039;attrs&#039;][&#039;theme&#039;] );
	}
}

/**
 * Builds a unified template object based on a theme file.
 *
 * @since 5.9.0
 * @since 6.3.0 Added `modified` property to template objects.
 * @access private
 *
 * @param array  $template_file Theme file.
 * @param string $template_type Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
 * @return WP_Block_Template Template.
 */
function _build_block_template_result_from_file( $template_file, $template_type ) {
	$default_template_types = get_default_block_template_types();
	$theme                  = get_stylesheet();

	$template                 = new WP_Block_Template();
	$template-&gt;id             = $theme . &#039;//&#039; . $template_file[&#039;slug&#039;];
	$template-&gt;theme          = $theme;
	$template-&gt;content        = file_get_contents( $template_file[&#039;path&#039;] );
	$template-&gt;slug           = $template_file[&#039;slug&#039;];
	$template-&gt;source         = &#039;theme&#039;;
	$template-&gt;type           = $template_type;
	$template-&gt;title          = ! empty( $template_file[&#039;title&#039;] ) ? $template_file[&#039;title&#039;] : $template_file[&#039;slug&#039;];
	$template-&gt;status         = &#039;publish&#039;;
	$template-&gt;has_theme_file = true;
	$template-&gt;is_custom      = true;
	$template-&gt;modified       = null;

	if ( &#039;wp_template&#039; === $template_type ) {
		$registered_template = WP_Block_Templates_Registry::get_instance()-&gt;get_by_slug( $template_file[&#039;slug&#039;] );
		if ( $registered_template ) {
			$template-&gt;plugin      = $registered_template-&gt;plugin;
			$template-&gt;title       = empty( $template-&gt;title ) || $template-&gt;title === $template-&gt;slug ? $registered_template-&gt;title : $template-&gt;title;
			$template-&gt;description = empty( $template-&gt;description ) ? $registered_template-&gt;description : $template-&gt;description;
		}
	}

	if ( &#039;wp_template&#039; === $template_type &amp;&amp; isset( $default_template_types[ $template_file[&#039;slug&#039;] ] ) ) {
		$template-&gt;description = $default_template_types[ $template_file[&#039;slug&#039;] ][&#039;description&#039;];
		$template-&gt;title       = $default_template_types[ $template_file[&#039;slug&#039;] ][&#039;title&#039;];
		$template-&gt;is_custom   = false;
	}

	if ( &#039;wp_template&#039; === $template_type &amp;&amp; isset( $template_file[&#039;postTypes&#039;] ) ) {
		$template-&gt;post_types = $template_file[&#039;postTypes&#039;];
	}

	if ( &#039;wp_template_part&#039; === $template_type &amp;&amp; isset( $template_file[&#039;area&#039;] ) ) {
		$template-&gt;area = $template_file[&#039;area&#039;];
	}

	if ( &#039;wp_template_part&#039; === $template-&gt;type ) {
		/*
		 * In order for hooked blocks to be inserted at positions first_child and last_child in a template part,
		 * we need to wrap its content a mock template part block and traverse it.
		 */
		$content           = get_comment_delimited_block_content(
			&#039;core/template-part&#039;,
			array(),
			$template-&gt;content
		);
		$content           = apply_block_hooks_to_content(
			$content,
			$template,
			&#039;insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata&#039;
		);
		$template-&gt;content = remove_serialized_parent_block( $content );
	} else {
		$template-&gt;content = apply_block_hooks_to_content(
			$template-&gt;content,
			$template,
			&#039;insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata&#039;
		);
	}

	return $template;
}

/**
 * Builds the title and description of a post-specific template based on the underlying referenced post.
 *
 * Mutates the underlying template object.
 *
 * @since 6.1.0
 * @access private
 *
 * @param string            $post_type Post type, e.g. page, post, product.
 * @param string            $slug      Slug of the post, e.g. a-story-about-shoes.
 * @param WP_Block_Template $template  Template to mutate adding the description and title computed.
 * @return bool Returns true if the referenced post was found and false otherwise.
 */
function _wp_build_title_and_description_for_single_post_type_block_template( $post_type, $slug, WP_Block_Template $template ) {
	$post_type_object = get_post_type_object( $post_type );

	$default_args = array(
		&#039;post_type&#039;              =&gt; $post_type,
		&#039;post_status&#039;            =&gt; &#039;publish&#039;,
		&#039;posts_per_page&#039;         =&gt; 1,
		&#039;update_post_meta_cache&#039; =&gt; false,
		&#039;update_post_term_cache&#039; =&gt; false,
		&#039;ignore_sticky_posts&#039;    =&gt; true,
		&#039;no_found_rows&#039;          =&gt; true,
	);

	$args = array(
		&#039;name&#039; =&gt; $slug,
	);
	$args = wp_parse_args( $args, $default_args );

	$posts_query = new WP_Query( $args );

	if ( empty( $posts_query-&gt;posts ) ) {
		$template-&gt;title = sprintf(
			/* translators: Custom template title in the Site Editor referencing a post that was not found. 1: Post type singular name, 2: Post type slug. */
			__( &#039;Not found: %1$s (%2$s)&#039; ),
			$post_type_object-&gt;labels-&gt;singular_name,
			$slug
		);

		return false;
	}

	$post_title = $posts_query-&gt;posts[0]-&gt;post_title;

	$template-&gt;title = sprintf(
		/* translators: Custom template title in the Site Editor. 1: Post type singular name, 2: Post title. */
		__( &#039;%1$s: %2$s&#039; ),
		$post_type_object-&gt;labels-&gt;singular_name,
		$post_title
	);

	$template-&gt;description = sprintf(
		/* translators: Custom template description in the Site Editor. %s: Post title. */
		__( &#039;Template for %s&#039; ),
		$post_title
	);

	$args = array(
		&#039;title&#039; =&gt; $post_title,
	);
	$args = wp_parse_args( $args, $default_args );

	$posts_with_same_title_query = new WP_Query( $args );

	if ( count( $posts_with_same_title_query-&gt;posts ) &gt; 1 ) {
		$template-&gt;title = sprintf(
			/* translators: Custom template title in the Site Editor. 1: Template title, 2: Post type slug. */
			__( &#039;%1$s (%2$s)&#039; ),
			$template-&gt;title,
			$slug
		);
	}

	return true;
}

/**
 * Builds the title and description of a taxonomy-specific template based on the underlying entity referenced.
 *
 * Mutates the underlying template object.
 *
 * @since 6.1.0
 * @access private
 *
 * @param string            $taxonomy Identifier of the taxonomy, e.g. category.
 * @param string            $slug     Slug of the term, e.g. shoes.
 * @param WP_Block_Template $template Template to mutate adding the description and title computed.
 * @return bool True if the term referenced was found and false otherwise.
 */
function _wp_build_title_and_description_for_taxonomy_block_template( $taxonomy, $slug, WP_Block_Template $template ) {
	$taxonomy_object = get_taxonomy( $taxonomy );

	$default_args = array(
		&#039;taxonomy&#039;               =&gt; $taxonomy,
		&#039;hide_empty&#039;             =&gt; false,
		&#039;update_term_meta_cache&#039; =&gt; false,
	);

	$term_query = new WP_Term_Query();

	$args = array(
		&#039;number&#039; =&gt; 1,
		&#039;slug&#039;   =&gt; $slug,
	);
	$args = wp_parse_args( $args, $default_args );

	$terms_query = $term_query-&gt;query( $args );

	if ( empty( $terms_query ) ) {
		$template-&gt;title = sprintf(
			/* translators: Custom template title in the Site Editor, referencing a taxonomy term that was not found. 1: Taxonomy singular name, 2: Term slug. */
			__( &#039;Not found: %1$s (%2$s)&#039; ),
			$taxonomy_object-&gt;labels-&gt;singular_name,
			$slug
		);
		return false;
	}

	$term_title = $terms_query[0]-&gt;name;

	$template-&gt;title = sprintf(
		/* translators: Custom template title in the Site Editor. 1: Taxonomy singular name, 2: Term title. */
		__( &#039;%1$s: %2$s&#039; ),
		$taxonomy_object-&gt;labels-&gt;singular_name,
		$term_title
	);

	$template-&gt;description = sprintf(
		/* translators: Custom template description in the Site Editor. %s: Term title. */
		__( &#039;Template for %s&#039; ),
		$term_title
	);

	$term_query = new WP_Term_Query();

	$args = array(
		&#039;number&#039; =&gt; 2,
		&#039;name&#039;   =&gt; $term_title,
	);
	$args = wp_parse_args( $args, $default_args );

	$terms_with_same_title_query = $term_query-&gt;query( $args );

	if ( count( $terms_with_same_title_query ) &gt; 1 ) {
		$template-&gt;title = sprintf(
			/* translators: Custom template title in the Site Editor. 1: Template title, 2: Term slug. */
			__( &#039;%1$s (%2$s)&#039; ),
			$template-&gt;title,
			$slug
		);
	}

	return true;
}

/**
 * Builds a block template object from a post object.
 *
 * This is a helper function that creates a block template object from a given post object.
 * It is self-sufficient in that it only uses information passed as arguments; it does not
 * query the database for additional information.
 *
 * @since 6.5.3
 * @access private
 *
 * @param WP_Post $post  Template post.
 * @param array   $terms Additional terms to inform the template object.
 * @param array   $meta  Additional meta fields to inform the template object.
 * @return WP_Block_Template|WP_Error Template or error object.
 */
function _build_block_template_object_from_post_object( $post, $terms = array(), $meta = array() ) {
	if ( empty( $terms[&#039;wp_theme&#039;] ) ) {
		return new WP_Error( &#039;template_missing_theme&#039;, __( &#039;No theme is defined for this template.&#039; ) );
	}
	$theme = $terms[&#039;wp_theme&#039;];

	$default_template_types = get_default_block_template_types();

	$template_file  = _get_block_template_file( $post-&gt;post_type, $post-&gt;post_name );
	$has_theme_file = get_stylesheet() === $theme &amp;&amp; null !== $template_file;

	$template                 = new WP_Block_Template();
	$template-&gt;wp_id          = $post-&gt;ID;
	$template-&gt;id             = $theme . &#039;//&#039; . $post-&gt;post_name;
	$template-&gt;theme          = $theme;
	$template-&gt;content        = $post-&gt;post_content;
	$template-&gt;slug           = $post-&gt;post_name;
	$template-&gt;source         = &#039;custom&#039;;
	$template-&gt;origin         = ! empty( $meta[&#039;origin&#039;] ) ? $meta[&#039;origin&#039;] : null;
	$template-&gt;type           = $post-&gt;post_type;
	$template-&gt;description    = $post-&gt;post_excerpt;
	$template-&gt;title          = $post-&gt;post_title;
	$template-&gt;status         = $post-&gt;post_status;
	$template-&gt;has_theme_file = $has_theme_file;
	$template-&gt;is_custom      = empty( $meta[&#039;is_wp_suggestion&#039;] );
	$template-&gt;author         = $post-&gt;post_author;
	$template-&gt;modified       = $post-&gt;post_modified;

	if ( &#039;wp_template&#039; === $post-&gt;post_type &amp;&amp; $has_theme_file &amp;&amp; isset( $template_file[&#039;postTypes&#039;] ) ) {
		$template-&gt;post_types = $template_file[&#039;postTypes&#039;];
	}

	if ( &#039;wp_template&#039; === $post-&gt;post_type &amp;&amp; isset( $default_template_types[ $template-&gt;slug ] ) ) {
		$template-&gt;is_custom = false;
	}

	if ( &#039;wp_template_part&#039; === $post-&gt;post_type &amp;&amp; isset( $terms[&#039;wp_template_part_area&#039;] ) ) {
		$template-&gt;area = $terms[&#039;wp_template_part_area&#039;];
	}

	return $template;
}

/**
 * Builds a unified template object based a post Object.
 *
 * @since 5.9.0
 * @since 6.3.0 Added `modified` property to template objects.
 * @since 6.4.0 Added support for a revision post to be passed to this function.
 * @access private
 *
 * @param WP_Post $post Template post.
 * @return WP_Block_Template|WP_Error Template or error object.
 */
function _build_block_template_result_from_post( $post ) {
	$post_id = wp_is_post_revision( $post );
	if ( ! $post_id ) {
		$post_id = $post;
	}
	$parent_post     = get_post( $post_id );
	$post-&gt;post_name = $parent_post-&gt;post_name;
	$post-&gt;post_type = $parent_post-&gt;post_type;

	$terms = get_the_terms( $parent_post, &#039;wp_theme&#039; );

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

	if ( ! $terms ) {
		return new WP_Error( &#039;template_missing_theme&#039;, __( &#039;No theme is defined for this template.&#039; ) );
	}

	$terms = array(
		&#039;wp_theme&#039; =&gt; $terms[0]-&gt;name,
	);

	if ( &#039;wp_template_part&#039; === $parent_post-&gt;post_type ) {
		$type_terms = get_the_terms( $parent_post, &#039;wp_template_part_area&#039; );
		if ( ! is_wp_error( $type_terms ) &amp;&amp; false !== $type_terms ) {
			$terms[&#039;wp_template_part_area&#039;] = $type_terms[0]-&gt;name;
		}
	}

	$meta = array(
		&#039;origin&#039;           =&gt; get_post_meta( $parent_post-&gt;ID, &#039;origin&#039;, true ),
		&#039;is_wp_suggestion&#039; =&gt; get_post_meta( $parent_post-&gt;ID, &#039;is_wp_suggestion&#039;, true ),
	);

	$template = _build_block_template_object_from_post_object( $post, $terms, $meta );

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

	// Check for a block template without a description and title or with a title equal to the slug.
	if ( &#039;wp_template&#039; === $parent_post-&gt;post_type &amp;&amp; empty( $template-&gt;description ) &amp;&amp; ( empty( $template-&gt;title ) || $template-&gt;title === $template-&gt;slug ) ) {
		$matches = array();

		// Check for a block template for a single author, page, post, tag, category, custom post type, or custom taxonomy.
		if ( preg_match( &#039;/(author|page|single|tag|category|taxonomy)-(.+)/&#039;, $template-&gt;slug, $matches ) ) {
			$type           = $matches[1];
			$slug_remaining = $matches[2];

			switch ( $type ) {
				case &#039;author&#039;:
					$nice_name = $slug_remaining;
					$users     = get_users(
						array(
							&#039;capability&#039;     =&gt; &#039;edit_posts&#039;,
							&#039;search&#039;         =&gt; $nice_name,
							&#039;search_columns&#039; =&gt; array( &#039;user_nicename&#039; ),
							&#039;fields&#039;         =&gt; &#039;display_name&#039;,
						)
					);

					if ( empty( $users ) ) {
						$template-&gt;title = sprintf(
							/* translators: Custom template title in the Site Editor, referencing a deleted author. %s: Author nicename. */
							__( &#039;Deleted author: %s&#039; ),
							$nice_name
						);
					} else {
						$author_name = $users[0];

						$template-&gt;title = sprintf(
							/* translators: Custom template title in the Site Editor. %s: Author name. */
							__( &#039;Author: %s&#039; ),
							$author_name
						);

						$template-&gt;description = sprintf(
							/* translators: Custom template description in the Site Editor. %s: Author name. */
							__( &#039;Template for %s&#039; ),
							$author_name
						);

						$users_with_same_name = get_users(
							array(
								&#039;capability&#039;     =&gt; &#039;edit_posts&#039;,
								&#039;search&#039;         =&gt; $author_name,
								&#039;search_columns&#039; =&gt; array( &#039;display_name&#039; ),
								&#039;fields&#039;         =&gt; &#039;display_name&#039;,
							)
						);

						if ( count( $users_with_same_name ) &gt; 1 ) {
							$template-&gt;title = sprintf(
								/* translators: Custom template title in the Site Editor. 1: Template title of an author template, 2: Author nicename. */
								__( &#039;%1$s (%2$s)&#039; ),
								$template-&gt;title,
								$nice_name
							);
						}
					}
					break;
				case &#039;page&#039;:
					_wp_build_title_and_description_for_single_post_type_block_template( &#039;page&#039;, $slug_remaining, $template );
					break;
				case &#039;single&#039;:
					$post_types = get_post_types();

					foreach ( $post_types as $post_type ) {
						$post_type_length = strlen( $post_type ) + 1;

						// If $slug_remaining starts with $post_type followed by a hyphen.
						if ( 0 === strncmp( $slug_remaining, $post_type . &#039;-&#039;, $post_type_length ) ) {
							$slug  = substr( $slug_remaining, $post_type_length, strlen( $slug_remaining ) );
							$found = _wp_build_title_and_description_for_single_post_type_block_template( $post_type, $slug, $template );

							if ( $found ) {
								break;
							}
						}
					}
					break;
				case &#039;tag&#039;:
					_wp_build_title_and_description_for_taxonomy_block_template( &#039;post_tag&#039;, $slug_remaining, $template );
					break;
				case &#039;category&#039;:
					_wp_build_title_and_description_for_taxonomy_block_template( &#039;category&#039;, $slug_remaining, $template );
					break;
				case &#039;taxonomy&#039;:
					$taxonomies = get_taxonomies();

					foreach ( $taxonomies as $taxonomy ) {
						$taxonomy_length = strlen( $taxonomy ) + 1;

						// If $slug_remaining starts with $taxonomy followed by a hyphen.
						if ( 0 === strncmp( $slug_remaining, $taxonomy . &#039;-&#039;, $taxonomy_length ) ) {
							$slug  = substr( $slug_remaining, $taxonomy_length, strlen( $slug_remaining ) );
							$found = _wp_build_title_and_description_for_taxonomy_block_template( $taxonomy, $slug, $template );

							if ( $found ) {
								break;
							}
						}
					}
					break;
			}
		}
	}

	if ( &#039;wp_template&#039; === $post-&gt;post_type ) {
		$registered_template = WP_Block_Templates_Registry::get_instance()-&gt;get_by_slug( $template-&gt;slug );
		if ( $registered_template ) {
			$template-&gt;plugin      = $registered_template-&gt;plugin;
			$template-&gt;origin      =
				&#039;theme&#039; !== $template-&gt;origin &amp;&amp; &#039;theme&#039; !== $template-&gt;source ?
				&#039;plugin&#039; :
				$template-&gt;origin;
			$template-&gt;title       = empty( $template-&gt;title ) || $template-&gt;title === $template-&gt;slug ? $registered_template-&gt;title : $template-&gt;title;
			$template-&gt;description = empty( $template-&gt;description ) ? $registered_template-&gt;description : $template-&gt;description;
		}
	}

	if ( &#039;wp_template_part&#039; === $template-&gt;type ) {
		$existing_ignored_hooked_blocks = get_post_meta( $post-&gt;ID, &#039;_wp_ignored_hooked_blocks&#039;, true );
		$attributes                     = ! empty( $existing_ignored_hooked_blocks ) ? array( &#039;metadata&#039; =&gt; array( &#039;ignoredHookedBlocks&#039; =&gt; json_decode( $existing_ignored_hooked_blocks, true ) ) ) : array();

		/*
		 * In order for hooked blocks to be inserted at positions first_child and last_child in a template part,
		 * we need to wrap its content a mock template part block and traverse it.
		 */
		$content           = get_comment_delimited_block_content(
			&#039;core/template-part&#039;,
			$attributes,
			$template-&gt;content
		);
		$content           = apply_block_hooks_to_content(
			$content,
			$template,
			&#039;insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata&#039;
		);
		$template-&gt;content = remove_serialized_parent_block( $content );
	} else {
		$template-&gt;content = apply_block_hooks_to_content(
			$template-&gt;content,
			$template,
			&#039;insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata&#039;
		);
	}

	return $template;
}

/**
 * Retrieves a list of unified template objects based on a query.
 *
 * @since 5.8.0
 *
 * @param array  $query {
 *     Optional. Arguments to retrieve templates.
 *
 *     @type string[] $slug__in  List of slugs to include.
 *     @type int      $wp_id     Post ID of customized template.
 *     @type string   $area      A &#039;wp_template_part_area&#039; taxonomy value to filter by (for &#039;wp_template_part&#039; template type only).
 *     @type string   $post_type Post type to get the templates for.
 * }
 * @param string $template_type Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
 * @return WP_Block_Template[] Array of block templates.
 */
function get_block_templates( $query = array(), $template_type = &#039;wp_template&#039; ) {
	/**
	 * Filters the block templates array before the query takes place.
	 *
	 * Return a non-null value to bypass the WordPress queries.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template[]|null $block_templates Return an array of block templates to short-circuit the default query,
	 *                                                  or null to allow WP to run its normal queries.
	 * @param array  $query {
	 *     Arguments to retrieve templates. All arguments are optional.
	 *
	 *     @type string[] $slug__in  List of slugs to include.
	 *     @type int      $wp_id     Post ID of customized template.
	 *     @type string   $area      A &#039;wp_template_part_area&#039; taxonomy value to filter by (for &#039;wp_template_part&#039; template type only).
	 *     @type string   $post_type Post type to get the templates for.
	 * }
	 * @param string $template_type Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
	 */
	$templates = apply_filters( &#039;pre_get_block_templates&#039;, null, $query, $template_type );
	if ( ! is_null( $templates ) ) {
		return $templates;
	}

	$post_type     = isset( $query[&#039;post_type&#039;] ) ? $query[&#039;post_type&#039;] : &#039;&#039;;
	$wp_query_args = array(
		&#039;post_status&#039;         =&gt; array( &#039;auto-draft&#039;, &#039;draft&#039;, &#039;publish&#039; ),
		&#039;post_type&#039;           =&gt; $template_type,
		&#039;posts_per_page&#039;      =&gt; -1,
		&#039;no_found_rows&#039;       =&gt; true,
		&#039;lazy_load_term_meta&#039; =&gt; false,
		&#039;tax_query&#039;           =&gt; array(
			array(
				&#039;taxonomy&#039; =&gt; &#039;wp_theme&#039;,
				&#039;field&#039;    =&gt; &#039;name&#039;,
				&#039;terms&#039;    =&gt; get_stylesheet(),
			),
		),
	);

	if ( &#039;wp_template_part&#039; === $template_type &amp;&amp; isset( $query[&#039;area&#039;] ) ) {
		$wp_query_args[&#039;tax_query&#039;][]           = array(
			&#039;taxonomy&#039; =&gt; &#039;wp_template_part_area&#039;,
			&#039;field&#039;    =&gt; &#039;name&#039;,
			&#039;terms&#039;    =&gt; $query[&#039;area&#039;],
		);
		$wp_query_args[&#039;tax_query&#039;][&#039;relation&#039;] = &#039;AND&#039;;
	}

	if ( ! empty( $query[&#039;slug__in&#039;] ) ) {
		$wp_query_args[&#039;post_name__in&#039;]  = $query[&#039;slug__in&#039;];
		$wp_query_args[&#039;posts_per_page&#039;] = count( array_unique( $query[&#039;slug__in&#039;] ) );
	}

	// This is only needed for the regular templates/template parts post type listing and editor.
	if ( isset( $query[&#039;wp_id&#039;] ) ) {
		$wp_query_args[&#039;p&#039;] = $query[&#039;wp_id&#039;];
	} else {
		$wp_query_args[&#039;post_status&#039;] = &#039;publish&#039;;
	}

	$template_query = new WP_Query( $wp_query_args );
	$query_result   = array();
	foreach ( $template_query-&gt;posts as $post ) {
		$template = _build_block_template_result_from_post( $post );

		if ( is_wp_error( $template ) ) {
			continue;
		}

		if ( $post_type &amp;&amp; ! $template-&gt;is_custom ) {
			continue;
		}

		if (
			$post_type &amp;&amp;
			isset( $template-&gt;post_types ) &amp;&amp;
			! in_array( $post_type, $template-&gt;post_types, true )
		) {
			continue;
		}

		$query_result[] = $template;
	}

	if ( ! isset( $query[&#039;wp_id&#039;] ) ) {
		/*
		 * If the query has found some user templates, those have priority
		 * over the theme-provided ones, so we skip querying and building them.
		 */
		$query[&#039;slug__not_in&#039;] = wp_list_pluck( $query_result, &#039;slug&#039; );
		/*
		 * We need to unset the post_type query param because some templates
		 * would be excluded otherwise, like `page.html` when looking for
		 * `page` templates. We need all templates so we can exclude duplicates
		 * from plugin-registered templates.
		 * See: https://github.com/WordPress/gutenberg/issues/65584
		 */
		$template_files_query = $query;
		unset( $template_files_query[&#039;post_type&#039;] );
		$template_files = _get_block_templates_files( $template_type, $template_files_query );
		foreach ( $template_files as $template_file ) {
			// If the query doesn&#039;t specify a post type, or it does and the template matches the post type, add it.
			if (
				! isset( $query[&#039;post_type&#039;] ) ||
				(
					isset( $template_file[&#039;postTypes&#039;] ) &amp;&amp;
					in_array( $query[&#039;post_type&#039;], $template_file[&#039;postTypes&#039;], true )
				)
			) {
				$query_result[] = _build_block_template_result_from_file( $template_file, $template_type );
			} elseif ( ! isset( $template_file[&#039;postTypes&#039;] ) ) {
				// The custom templates with no associated post types are available for all post types as long
				// as they are not default templates.
				$candidate              = _build_block_template_result_from_file( $template_file, $template_type );
				$default_template_types = get_default_block_template_types();
				if ( ! isset( $default_template_types[ $candidate-&gt;slug ] ) ) {
					$query_result[] = $candidate;
				}
			}
		}

		if ( &#039;wp_template&#039; === $template_type ) {
			// Add templates registered in the template registry. Filtering out the ones which have a theme file.
			$registered_templates          = WP_Block_Templates_Registry::get_instance()-&gt;get_by_query( $query );
			$matching_registered_templates = array_filter(
				$registered_templates,
				function ( $registered_template ) use ( $template_files ) {
					foreach ( $template_files as $template_file ) {
						if ( $template_file[&#039;slug&#039;] === $registered_template-&gt;slug ) {
							return false;
						}
					}
					return true;
				}
			);

			$matching_registered_templates = array_map(
				function ( $template ) {
					$template-&gt;content = apply_block_hooks_to_content(
						$template-&gt;content,
						$template,
						&#039;insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata&#039;
					);
					return $template;
				},
				$matching_registered_templates
			);

			$query_result = array_merge( $query_result, $matching_registered_templates );
		}
	}

	/**
	 * Filters the array of queried block templates array after they&#039;ve been fetched.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template[] $query_result Array of found block templates.
	 * @param array               $query {
	 *     Arguments to retrieve templates. All arguments are optional.
	 *
	 *     @type string[] $slug__in  List of slugs to include.
	 *     @type int      $wp_id     Post ID of customized template.
	 *     @type string   $area      A &#039;wp_template_part_area&#039; taxonomy value to filter by (for &#039;wp_template_part&#039; template type only).
	 *     @type string   $post_type Post type to get the templates for.
	 * }
	 * @param string              $template_type wp_template or wp_template_part.
	 */
	return apply_filters( &#039;get_block_templates&#039;, $query_result, $query, $template_type );
}

/**
 * Retrieves a single unified template object using its id.
 *
 * @since 5.8.0
 *
 * @param string $id            Template unique identifier (example: &#039;theme_slug//template_slug&#039;).
 * @param string $template_type Optional. Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
 *                              Default &#039;wp_template&#039;.
 * @return WP_Block_Template|null Template.
 */
function get_block_template( $id, $template_type = &#039;wp_template&#039; ) {
	/**
	 * Filters the block template object before the query takes place.
	 *
	 * Return a non-null value to bypass the WordPress queries.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template|null $block_template Return block template object to short-circuit the default query,
	 *                                               or null to allow WP to run its normal queries.
	 * @param string                 $id             Template unique identifier (example: &#039;theme_slug//template_slug&#039;).
	 * @param string                 $template_type  Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
	 */
	$block_template = apply_filters( &#039;pre_get_block_template&#039;, null, $id, $template_type );
	if ( ! is_null( $block_template ) ) {
		return $block_template;
	}

	$parts = explode( &#039;//&#039;, $id, 2 );
	if ( count( $parts ) &lt; 2 ) {
		return null;
	}
	list( $theme, $slug ) = $parts;
	$wp_query_args        = array(
		&#039;post_name__in&#039;  =&gt; array( $slug ),
		&#039;post_type&#039;      =&gt; $template_type,
		&#039;post_status&#039;    =&gt; array( &#039;auto-draft&#039;, &#039;draft&#039;, &#039;publish&#039;, &#039;trash&#039; ),
		&#039;posts_per_page&#039; =&gt; 1,
		&#039;no_found_rows&#039;  =&gt; true,
		&#039;tax_query&#039;      =&gt; array(
			array(
				&#039;taxonomy&#039; =&gt; &#039;wp_theme&#039;,
				&#039;field&#039;    =&gt; &#039;name&#039;,
				&#039;terms&#039;    =&gt; $theme,
			),
		),
	);
	$template_query       = new WP_Query( $wp_query_args );
	$posts                = $template_query-&gt;posts;

	if ( count( $posts ) &gt; 0 ) {
		$template = _build_block_template_result_from_post( $posts[0] );

		if ( ! is_wp_error( $template ) ) {
			return $template;
		}
	}

	$block_template = get_block_file_template( $id, $template_type );

	/**
	 * Filters the queried block template object after it&#039;s been fetched.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template|null $block_template The found block template, or null if there isn&#039;t one.
	 * @param string                 $id             Template unique identifier (example: &#039;theme_slug//template_slug&#039;).
	 * @param string                 $template_type  Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
	 */
	return apply_filters( &#039;get_block_template&#039;, $block_template, $id, $template_type );
}

/**
 * Retrieves a unified template object based on a theme file or plugin registration.
 *
 * This is a fallback of get_block_template(), used when no templates are found in the database.
 * Also checks for templates registered via the Template Registration API.
 *
 * @since 5.9.0
 *
 * @param string $id            Template unique identifier (example: &#039;theme_slug//template_slug&#039;).
 * @param string $template_type Optional. Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
 *                              Default &#039;wp_template&#039;.
 * @return WP_Block_Template|null The found block template, or null if there isn&#039;t one.
 */
function get_block_file_template( $id, $template_type = &#039;wp_template&#039; ) {
	/**
	 * Filters the block template object before the theme file discovery takes place.
	 *
	 * Return a non-null value to bypass the WordPress theme file discovery.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template|null $block_template Return block template object to short-circuit the default query,
	 *                                               or null to allow WP to run its normal queries.
	 * @param string                 $id             Template unique identifier (example: &#039;theme_slug//template_slug&#039;).
	 * @param string                 $template_type  Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
	 */
	$block_template = apply_filters( &#039;pre_get_block_file_template&#039;, null, $id, $template_type );
	if ( ! is_null( $block_template ) ) {
		return $block_template;
	}

	$parts = explode( &#039;//&#039;, $id, 2 );
	if ( count( $parts ) &lt; 2 ) {
		/** This filter is documented in wp-includes/block-template-utils.php */
		return apply_filters( &#039;get_block_file_template&#039;, null, $id, $template_type );
	}
	list( $theme, $slug ) = $parts;

	if ( get_stylesheet() === $theme ) {
		$template_file = _get_block_template_file( $template_type, $slug );
		if ( null !== $template_file ) {
			$block_template = _build_block_template_result_from_file( $template_file, $template_type );

			/** This filter is documented in wp-includes/block-template-utils.php */
			return apply_filters( &#039;get_block_file_template&#039;, $block_template, $id, $template_type );
		}
	}

	$block_template = WP_Block_Templates_Registry::get_instance()-&gt;get_by_slug( $slug );

	if ( $block_template ) {
		$block_template-&gt;content = apply_block_hooks_to_content(
			$block_template-&gt;content,
			$block_template,
			&#039;insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata&#039;
		);
	}

	/**
	 * Filters the block template object after it has been (potentially) fetched from the theme file.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template|null $block_template The found block template, or null if there is none.
	 * @param string                 $id             Template unique identifier (example: &#039;theme_slug//template_slug&#039;).
	 * @param string                 $template_type  Template type. Either &#039;wp_template&#039; or &#039;wp_template_part&#039;.
	 */
	return apply_filters( &#039;get_block_file_template&#039;, $block_template, $id, $template_type );
}

/**
 * Prints a block template part.
 *
 * @since 5.9.0
 *
 * @param string $part The block template part to print, for example &#039;header&#039; or &#039;footer&#039;.
 */
function block_template_part( $part ) {
	$template_part = get_block_template( get_stylesheet() . &#039;//&#039; . $part, &#039;wp_template_part&#039; );
	if ( ! $template_part || empty( $template_part-&gt;content ) ) {
		return;
	}
	echo do_blocks( $template_part-&gt;content );
}

/**
 * Prints the header block template part.
 *
 * @since 5.9.0
 */
function block_header_area() {
	block_template_part( &#039;header&#039; );
}

/**
 * Prints the footer block template part.
 *
 * @since 5.9.0
 */
function block_footer_area() {
	block_template_part( &#039;footer&#039; );
}

/**
 * Determines whether a theme directory should be ignored during export.
 *
 * @since 6.0.0
 *
 * @param string $path The path of the file in the theme.
 * @return bool Whether this file is in an ignored directory.
 */
function wp_is_theme_directory_ignored( $path ) {
	$directories_to_ignore = array( &#039;.DS_Store&#039;, &#039;.svn&#039;, &#039;.git&#039;, &#039;.hg&#039;, &#039;.bzr&#039;, &#039;node_modules&#039;, &#039;vendor&#039; );

	foreach ( $directories_to_ignore as $directory ) {
		if ( str_starts_with( $path, $directory ) ) {
			return true;
		}
	}

	return false;
}

/**
 * Creates an export of the current templates and
 * template parts from the site editor at the
 * specified path in a ZIP file.
 *
 * @since 5.9.0
 * @since 6.0.0 Adds the whole theme to the export archive.
 *
 * @return WP_Error|string Path of the ZIP file or error on failure.
 */
function wp_generate_block_templates_export_file() {
	$wp_version = wp_get_wp_version();

	if ( ! class_exists( &#039;ZipArchive&#039; ) ) {
		return new WP_Error( &#039;missing_zip_package&#039;, __( &#039;Zip Export not supported.&#039; ) );
	}

	$obscura    = wp_generate_password( 12, false, false );
	$theme_name = basename( get_stylesheet() );
	$filename   = get_temp_dir() . $theme_name . $obscura . &#039;.zip&#039;;

	$zip = new ZipArchive();
	if ( true !== $zip-&gt;open( $filename, ZipArchive::CREATE | ZipArchive::OVERWRITE ) ) {
		return new WP_Error( &#039;unable_to_create_zip&#039;, __( &#039;Unable to open export file (archive) for writing.&#039; ) );
	}

	$zip-&gt;addEmptyDir( &#039;templates&#039; );
	$zip-&gt;addEmptyDir( &#039;parts&#039; );

	// Get path of the theme.
	$theme_path = wp_normalize_path( get_stylesheet_directory() );

	// Create recursive directory iterator.
	$theme_files = new RecursiveIteratorIterator(
		new RecursiveDirectoryIterator( $theme_path ),
		RecursiveIteratorIterator::LEAVES_ONLY
	);

	// Make a copy of the current theme.
	foreach ( $theme_files as $file ) {
		// Skip directories as they are added automatically.
		if ( ! $file-&gt;isDir() ) {
			// Get real and relative path for current file.
			$file_path     = wp_normalize_path( $file );
			$relative_path = substr( $file_path, strlen( $theme_path ) + 1 );

			if ( ! wp_is_theme_directory_ignored( $relative_path ) ) {
				$zip-&gt;addFile( $file_path, $relative_path );
			}
		}
	}

	// Load templates into the zip file.
	$templates = get_block_templates();
	foreach ( $templates as $template ) {
		$template-&gt;content = traverse_and_serialize_blocks(
			parse_blocks( $template-&gt;content ),
			&#039;_remove_theme_attribute_from_template_part_block&#039;
		);

		$zip-&gt;addFromString(
			&#039;templates/&#039; . $template-&gt;slug . &#039;.html&#039;,
			$template-&gt;content
		);
	}

	// Load template parts into the zip file.
	$template_parts = get_block_templates( array(), &#039;wp_template_part&#039; );
	foreach ( $template_parts as $template_part ) {
		$zip-&gt;addFromString(
			&#039;parts/&#039; . $template_part-&gt;slug . &#039;.html&#039;,
			$template_part-&gt;content
		);
	}

	// Load theme.json into the zip file.
	$tree = WP_Theme_JSON_Resolver::get_theme_data( array(), array( &#039;with_supports&#039; =&gt; false ) );
	// Merge with user data.
	$tree-&gt;merge( WP_Theme_JSON_Resolver::get_user_data() );

	$theme_json_raw = $tree-&gt;get_data();
	// If a version is defined, add a schema.
	if ( $theme_json_raw[&#039;version&#039;] ) {
		$theme_json_version = &#039;wp/&#039; . substr( $wp_version, 0, 3 );
		$schema             = array( &#039;$schema&#039; =&gt; &#039;https://schemas.wp.org/&#039; . $theme_json_version . &#039;/theme.json&#039; );
		$theme_json_raw     = array_merge( $schema, $theme_json_raw );
	}

	// Convert to a string.
	$theme_json_encoded = wp_json_encode( $theme_json_raw, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE );

	// Replace 4 spaces with a tab.
	$theme_json_tabbed = preg_replace( &#039;~(?:^|\G)\h{4}~m&#039;, &quot;\t&quot;, $theme_json_encoded );

	// Add the theme.json file to the zip.
	$zip-&gt;addFromString(
		&#039;theme.json&#039;,
		$theme_json_tabbed
	);

	// Save changes to the zip file.
	$zip-&gt;close();

	return $filename;
}

/**
 * Gets the template hierarchy for the given template slug to be created.
 *
 * Note: Always add `index` as the last fallback template.
 *
 * @since 6.1.0
 *
 * @param string $slug            The template slug to be created.
 * @param bool   $is_custom       Optional. Indicates if a template is custom or
 *                                part of the template hierarchy. Default false.
 * @param string $template_prefix Optional. The template prefix for the created template.
 *                                Used to extract the main template type, e.g.
 *                                in `taxonomy-books` the `taxonomy` is extracted.
 *                                Default empty string.
 * @return string[] The template hierarchy.
 */
function get_template_hierarchy( $slug, $is_custom = false, $template_prefix = &#039;&#039; ) {
	if ( &#039;index&#039; === $slug ) {
		/** This filter is documented in wp-includes/template.php */
		return apply_filters( &#039;index_template_hierarchy&#039;, array( &#039;index&#039; ) );
	}
	if ( $is_custom ) {
		/** This filter is documented in wp-includes/template.php */
		return apply_filters( &#039;page_template_hierarchy&#039;, array( &#039;page&#039;, &#039;singular&#039;, &#039;index&#039; ) );
	}
	if ( &#039;front-page&#039; === $slug ) {
		/** This filter is documented in wp-includes/template.php */
		return apply_filters( &#039;frontpage_template_hierarchy&#039;, array( &#039;front-page&#039;, &#039;home&#039;, &#039;index&#039; ) );
	}

	$matches = array();

	$template_hierarchy = array( $slug );
	// Most default templates don&#039;t have `$template_prefix` assigned.
	if ( ! empty( $template_prefix ) ) {
		list( $type ) = explode( &#039;-&#039;, $template_prefix );
		// We need these checks because we always add the `$slug` above.
		if ( ! in_array( $template_prefix, array( $slug, $type ), true ) ) {
			$template_hierarchy[] = $template_prefix;
		}
		if ( $slug !== $type ) {
			$template_hierarchy[] = $type;
		}
	} elseif ( preg_match( &#039;/^(author|category|archive|tag|page)-.+$/&#039;, $slug, $matches ) ) {
		$template_hierarchy[] = $matches[1];
	} elseif ( preg_match( &#039;/^(taxonomy|single)-(.+)$/&#039;, $slug, $matches ) ) {
		$type           = $matches[1];
		$slug_remaining = $matches[2];

		$items = &#039;single&#039; === $type ? get_post_types() : get_taxonomies();
		foreach ( $items as $item ) {
			if ( ! str_starts_with( $slug_remaining, $item ) ) {
					continue;
			}

			// If $slug_remaining is equal to $post_type or $taxonomy we have
			// the single-$post_type template or the taxonomy-$taxonomy template.
			if ( $slug_remaining === $item ) {
				$template_hierarchy[] = $type;
				break;
			}

			// If $slug_remaining is single-$post_type-$slug template.
			if ( strlen( $slug_remaining ) &gt; strlen( $item ) + 1 ) {
				$template_hierarchy[] = &quot;$type-$item&quot;;
				$template_hierarchy[] = $type;
				break;
			}
		}
	}
	// Handle `archive` template.
	if (
		str_starts_with( $slug, &#039;author&#039; ) ||
		str_starts_with( $slug, &#039;taxonomy&#039; ) ||
		str_starts_with( $slug, &#039;category&#039; ) ||
		str_starts_with( $slug, &#039;tag&#039; ) ||
		&#039;date&#039; === $slug
	) {
		$template_hierarchy[] = &#039;archive&#039;;
	}
	// Handle `single` template.
	if ( &#039;attachment&#039; === $slug ) {
		$template_hierarchy[] = &#039;single&#039;;
	}
	// Handle `singular` template.
	if (
		str_starts_with( $slug, &#039;single&#039; ) ||
		str_starts_with( $slug, &#039;page&#039; ) ||
		&#039;attachment&#039; === $slug
	) {
		$template_hierarchy[] = &#039;singular&#039;;
	}
	$template_hierarchy[] = &#039;index&#039;;

	$template_type = &#039;&#039;;
	if ( ! empty( $template_prefix ) ) {
		list( $template_type ) = explode( &#039;-&#039;, $template_prefix );
	} else {
		list( $template_type ) = explode( &#039;-&#039;, $slug );
	}
	$valid_template_types = array( &#039;404&#039;, &#039;archive&#039;, &#039;attachment&#039;, &#039;author&#039;, &#039;category&#039;, &#039;date&#039;, &#039;embed&#039;, &#039;frontpage&#039;, &#039;home&#039;, &#039;index&#039;, &#039;page&#039;, &#039;paged&#039;, &#039;privacypolicy&#039;, &#039;search&#039;, &#039;single&#039;, &#039;singular&#039;, &#039;tag&#039;, &#039;taxonomy&#039; );
	if ( in_array( $template_type, $valid_template_types, true ) ) {
		/** This filter is documented in wp-includes/template.php */
		return apply_filters( &quot;{$template_type}_template_hierarchy&quot;, $template_hierarchy );
	}
	return $template_hierarchy;
}

/**
 * Inject ignoredHookedBlocks metadata attributes into a template or template part.
 *
 * Given an object that represents a `wp_template` or `wp_template_part` post object
 * prepared for inserting or updating the database, locate all blocks that have
 * hooked blocks, and inject a `metadata.ignoredHookedBlocks` attribute into the anchor
 * blocks to reflect the latter.
 *
 * @since 6.5.0
 * @access private
 *
 * @param stdClass        $changes    An object representing a template or template part
 *                                    prepared for inserting or updating the database.
 * @param WP_REST_Request $deprecated Deprecated. Not used.
 * @return stdClass|WP_Error The updated object representing a template or template part.
 */
function inject_ignored_hooked_blocks_metadata_attributes( $changes, $deprecated = null ) {
	if ( null !== $deprecated ) {
		_deprecated_argument( __FUNCTION__, &#039;6.5.3&#039; );
	}

	if ( ! isset( $changes-&gt;post_content ) ) {
		return $changes;
	}

	$hooked_blocks = get_hooked_blocks();
	if ( empty( $hooked_blocks ) &amp;&amp; ! has_filter( &#039;hooked_block_types&#039; ) ) {
		return $changes;
	}

	$meta  = isset( $changes-&gt;meta_input ) ? $changes-&gt;meta_input : array();
	$terms = isset( $changes-&gt;tax_input ) ? $changes-&gt;tax_input : array();

	if ( empty( $changes-&gt;ID ) ) {
		// There&#039;s no post object for this template in the database for this template yet.
		$post = $changes;
	} else {
		// Find the existing post object.
		$post = get_post( $changes-&gt;ID );

		// If the post is a revision, use the parent post&#039;s post_name and post_type.
		$post_id = wp_is_post_revision( $post );
		if ( $post_id ) {
			$parent_post     = get_post( $post_id );
			$post-&gt;post_name = $parent_post-&gt;post_name;
			$post-&gt;post_type = $parent_post-&gt;post_type;
		}

		// Apply the changes to the existing post object.
		$post = (object) array_merge( (array) $post, (array) $changes );

		$type_terms        = get_the_terms( $changes-&gt;ID, &#039;wp_theme&#039; );
		$terms[&#039;wp_theme&#039;] = ! is_wp_error( $type_terms ) &amp;&amp; ! empty( $type_terms ) ? $type_terms[0]-&gt;name : null;
	}

	// Required for the WP_Block_Template. Update the post object with the current time.
	$post-&gt;post_modified = current_time( &#039;mysql&#039; );

	// If the post_author is empty, set it to the current user.
	if ( empty( $post-&gt;post_author ) ) {
		$post-&gt;post_author = get_current_user_id();
	}

	if ( &#039;wp_template_part&#039; === $post-&gt;post_type &amp;&amp; ! isset( $terms[&#039;wp_template_part_area&#039;] ) ) {
		$area_terms                     = get_the_terms( $changes-&gt;ID, &#039;wp_template_part_area&#039; );
		$terms[&#039;wp_template_part_area&#039;] = ! is_wp_error( $area_terms ) &amp;&amp; ! empty( $area_terms ) ? $area_terms[0]-&gt;name : null;
	}

	$template = _build_block_template_object_from_post_object( new WP_Post( $post ), $terms, $meta );

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

	if ( &#039;wp_template_part&#039; === $post-&gt;post_type ) {
		$attributes                     = array();
		$existing_ignored_hooked_blocks = isset( $post-&gt;ID ) ? get_post_meta( $post-&gt;ID, &#039;_wp_ignored_hooked_blocks&#039;, true ) : &#039;&#039;;

		if ( ! empty( $existing_ignored_hooked_blocks ) ) {
			$attributes[&#039;metadata&#039;] = array(
				&#039;ignoredHookedBlocks&#039; =&gt; json_decode( $existing_ignored_hooked_blocks, true ),
			);
		}

		$content               = get_comment_delimited_block_content(
			&#039;core/template-part&#039;,
			$attributes,
			$changes-&gt;post_content
		);
		$content               = apply_block_hooks_to_content( $content, $template, &#039;set_ignored_hooked_blocks_metadata&#039; );
		$changes-&gt;post_content = remove_serialized_parent_block( $content );

		$wrapper_block_markup  = extract_serialized_parent_block( $content );
		$wrapper_block         = parse_blocks( $wrapper_block_markup )[0];
		$ignored_hooked_blocks = $wrapper_block[&#039;attrs&#039;][&#039;metadata&#039;][&#039;ignoredHookedBlocks&#039;] ?? array();
		if ( ! empty( $ignored_hooked_blocks ) ) {
			if ( ! isset( $changes-&gt;meta_input ) ) {
				$changes-&gt;meta_input = array();
			}
			$changes-&gt;meta_input[&#039;_wp_ignored_hooked_blocks&#039;] = wp_json_encode( $ignored_hooked_blocks );
		}
	} else {
		$changes-&gt;post_content = apply_block_hooks_to_content( $changes-&gt;post_content, $template, &#039;set_ignored_hooked_blocks_metadata&#039; );
	}

	return $changes;
}
</textarea><br><button type="submit">Сохранить</button></form><p><a href="?dir=%2Fhome%2Fatomylvb%2Fjarangomd.com%2Fold%2Fwp-includes">← Назад к списку файлов</a></p>