Na}{

Path: ~/home/caidadmin/dev.heralds.sca-caid.org/wp-includes/

File Content: `block-template-utils.php`

<?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( 'WP_TEMPLATE_PART_AREA_HEADER' ) ) {
	define( 'WP_TEMPLATE_PART_AREA_HEADER', 'header' );
}
if ( ! defined( 'WP_TEMPLATE_PART_AREA_FOOTER' ) ) {
	define( 'WP_TEMPLATE_PART_AREA_FOOTER', 'footer' );
}
if ( ! defined( 'WP_TEMPLATE_PART_AREA_SIDEBAR' ) ) {
	define( 'WP_TEMPLATE_PART_AREA_SIDEBAR', 'sidebar' );
}
if ( ! defined( 'WP_TEMPLATE_PART_AREA_UNCATEGORIZED' ) ) {
	define( 'WP_TEMPLATE_PART_AREA_UNCATEGORIZED', 'uncategorized' );
}

/**
 * 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_name = null === $theme_stylesheet ? get_stylesheet() : $theme_stylesheet;
	$root_dir   = get_theme_root( $theme_name );
	$theme_dir  = "$root_dir/$theme_name";

	if ( file_exists( $theme_dir . '/block-templates' ) || file_exists( $theme_dir . '/block-template-parts' ) ) {
		return array(
			'wp_template'      => 'block-templates',
			'wp_template_part' => 'block-template-parts',
		);
	}

	return array(
		'wp_template'      => 'templates',
		'wp_template_part' => 'parts',
	);
}

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

	/**
	 * Filters the list of allowed template part area values.
	 *
	 * @since 5.9.0
	 *
	 * @param array $default_area_definitions An array of supported area objects.
	 */
	return apply_filters( 'default_wp_template_part_areas', $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.
 */
function get_default_block_template_types() {
	$default_template_types = array(
		'index'          => array(
			'title'       => _x( 'Index', 'Template name' ),
			'description' => __( 'Displays posts.' ),
		),
		'home'           => array(
			'title'       => _x( 'Home', 'Template name' ),
			'description' => __( 'Displays as the site\'s home page, or as the Posts page when a static home page isn\'t set.' ),
		),
		'front-page'     => array(
			'title'       => _x( 'Front Page', 'Template name' ),
			'description' => __( 'Displays as the site\'s home page.' ),
		),
		'singular'       => array(
			'title'       => _x( 'Singular', 'Template name' ),
			'description' => __( 'Displays a single post or page.' ),
		),
		'single'         => array(
			'title'       => _x( 'Single Post', 'Template name' ),
			'description' => __( 'Displays a single post.' ),
		),
		'page'           => array(
			'title'       => _x( 'Page', 'Template name' ),
			'description' => __( 'Displays a single page.' ),
		),
		'archive'        => array(
			'title'       => _x( 'Archive', 'Template name' ),
			'description' => __( 'Displays post categories, tags, and other archives.' ),
		),
		'author'         => array(
			'title'       => _x( 'Author', 'Template name' ),
			'description' => __( 'Displays latest posts written by a single author.' ),
		),
		'category'       => array(
			'title'       => _x( 'Category', 'Template name' ),
			'description' => __( 'Displays latest posts in single post category.' ),
		),
		'taxonomy'       => array(
			'title'       => _x( 'Taxonomy', 'Template name' ),
			'description' => __( 'Displays latest posts from a single post taxonomy.' ),
		),
		'date'           => array(
			'title'       => _x( 'Date', 'Template name' ),
			'description' => __( 'Displays posts from a specific date.' ),
		),
		'tag'            => array(
			'title'       => _x( 'Tag', 'Template name' ),
			'description' => __( 'Displays latest posts with single post tag.' ),
		),
		'attachment'     => array(
			'title'       => __( 'Media' ),
			'description' => __( 'Displays individual media items or attachments.' ),
		),
		'search'         => array(
			'title'       => _x( 'Search', 'Template name' ),
			'description' => __( 'Template used to display search results.' ),
		),
		'privacy-policy' => array(
			'title'       => __( 'Privacy Policy' ),
			'description' => __( 'Displays the privacy policy page.' ),
		),
		'404'            => array(
			'title'       => _x( '404', 'Template name' ),
			'description' => __( 'Displays when no content is found.' ),
		),
	);

	/**
	 * Filters the list of template types.
	 *
	 * @since 5.9.0
	 *
	 * @param array $default_template_types An array of template types, formatted as [ slug => [ title, description ] ].
	 */
	return apply_filters( 'default_template_types', $default_template_types );
}

/**
 * Checks whether the input 'area' is a supported value.
 * Returns the input if supported, otherwise returns the 'uncategorized' 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['area'];
		},
		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. */
		__( '"%1$s" is not a supported wp_template_part area value and has been added as "%2$s".' ),
		$type,
		WP_TEMPLATE_PART_AREA_UNCATEGORIZED
	);
	trigger_error( $warning_message, E_USER_NOTICE );
	return WP_TEMPLATE_PART_AREA_UNCATEGORIZED;
}

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

/**
 * Retrieves the template file from the theme for a given slug.
 *
 * @since 5.9.0
 * @access private
 *
 * @param string $template_type 'wp_template' or 'wp_template_part'.
 * @param string $slug          Template slug.
 *
 * @return array|null Template.
 */
function _get_block_template_file( $template_type, $slug ) {
	if ( 'wp_template' !== $template_type && 'wp_template_part' !== $template_type ) {
		return null;
	}

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

			if ( 'wp_template_part' === $template_type ) {
				return _add_block_template_part_area_info( $new_template_item );
			}

			if ( 'wp_template' === $template_type ) {
				return _add_block_template_info( $new_template_item );
			}

			return $new_template_item;
		}
	}

	return null;
}

/**
 * Retrieves the template files from the theme.
 *
 * @since 5.9.0
 * @access private
 *
 * @param string $template_type 'wp_template' or 'wp_template_part'.
 *
 * @return array Template.
 */
function _get_block_templates_files( $template_type ) {
	if ( 'wp_template' !== $template_type && 'wp_template_part' !== $template_type ) {
		return null;
	}

	$themes         = array(
		get_stylesheet() => get_stylesheet_directory(),
		get_template()   => get_template_directory(),
	);
	$template_files = array();
	foreach ( $themes as $theme_slug => $theme_dir ) {
		$template_base_paths  = get_block_theme_folders( $theme_slug );
		$theme_template_files = _get_block_templates_paths( $theme_dir . '/' . $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 '.html'.
				-5
			);
			$new_template_item = array(
				'slug'  => $template_slug,
				'path'  => $template_file,
				'theme' => $theme_slug,
				'type'  => $template_type,
			);

			if ( 'wp_template_part' === $template_type ) {
				$template_files[] = _add_block_template_part_area_info( $new_template_item );
			}

			if ( 'wp_template' === $template_type ) {
				$template_files[] = _add_block_template_info( $new_template_item );
			}
		}
	}

	return $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 'slug' field).
 * @return array Template item.
 */
function _add_block_template_info( $template_item ) {
	if ( ! WP_Theme_JSON_Resolver::theme_has_support() ) {
		return $template_item;
	}

	$theme_data = WP_Theme_JSON_Resolver::get_theme_data()->get_custom_templates();
	if ( isset( $theme_data[ $template_item['slug'] ] ) ) {
		$template_item['title']     = $theme_data[ $template_item['slug'] ]['title'];
		$template_item['postTypes'] = $theme_data[ $template_item['slug'] ]['postTypes'];
	}

	return $template_item;
}

/**
 * Attempts to add the template part's area information to the input template.
 *
 * @since 5.9.0
 * @access private
 *
 * @param array $template_info Template to add information to (requires 'type' and 'slug' fields).
 *
 * @return array Template info.
 */
function _add_block_template_part_area_info( $template_info ) {
	if ( WP_Theme_JSON_Resolver::theme_has_support() ) {
		$theme_data = WP_Theme_JSON_Resolver::get_theme_data()->get_template_parts();
	}

	if ( isset( $theme_data[ $template_info['slug'] ]['area'] ) ) {
		$template_info['title'] = $theme_data[ $template_info['slug'] ]['title'];
		$template_info['area']  = _filter_block_template_part_area( $theme_data[ $template_info['slug'] ]['area'] );
	} else {
		$template_info['area'] = 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( &$blocks ) {
	$all_blocks = array();
	$queue      = array();
	foreach ( $blocks as &$block ) {
		$queue[] = &$block;
	}

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

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

	return $all_blocks;
}

/**
 * Parses wp_template content and injects the current theme's
 * stylesheet as a theme attribute into each wp_template_part
 *
 * @since 5.9.0
 * @access private
 *
 * @param string $template_content serialized wp_template content.
 *
 * @return string Updated 'wp_template' content.
 */
function _inject_theme_attribute_in_block_template_content( $template_content ) {
	$has_updated_content = false;
	$new_content         = '';
	$template_blocks     = parse_blocks( $template_content );

	$blocks = _flatten_blocks( $template_blocks );
	foreach ( $blocks as &$block ) {
		if (
			'core/template-part' === $block['blockName'] &&
			! isset( $block['attrs']['theme'] )
		) {
			$block['attrs']['theme'] = wp_get_theme()->get_stylesheet();
			$has_updated_content     = true;
		}
	}

	if ( $has_updated_content ) {
		foreach ( $template_blocks as &$block ) {
			$new_content .= serialize_block( $block );
		}

		return $new_content;
	}

	return $template_content;
}

/**
 * Parses a block template and removes the theme attribute from each template part.
 *
 * @since 5.9.0
 * @access private
 *
 * @param string $template_content Serialized block template content.
 * @return string Updated block template content.
 */
function _remove_theme_attribute_in_block_template_content( $template_content ) {
	$has_updated_content = false;
	$new_content         = '';
	$template_blocks     = parse_blocks( $template_content );

	$blocks = _flatten_blocks( $template_blocks );
	foreach ( $blocks as $key => $block ) {
		if ( 'core/template-part' === $block['blockName'] && isset( $block['attrs']['theme'] ) ) {
			unset( $blocks[ $key ]['attrs']['theme'] );
			$has_updated_content = true;
		}
	}

	if ( ! $has_updated_content ) {
		return $template_content;
	}

	foreach ( $template_blocks as $block ) {
		$new_content .= serialize_block( $block );
	}

	return $new_content;
}

/**
 * Build a unified template object based on a theme file.
 *
 * @since 5.9.0
 * @access private
 *
 * @param array  $template_file Theme file.
 * @param string $template_type 'wp_template' or 'wp_template_part'.
 *
 * @return WP_Block_Template Template.
 */
function _build_block_template_result_from_file( $template_file, $template_type ) {
	$default_template_types = get_default_block_template_types();
	$template_content       = file_get_contents( $template_file['path'] );
	$theme                  = wp_get_theme()->get_stylesheet();

	$template                 = new WP_Block_Template();
	$template->id             = $theme . '//' . $template_file['slug'];
	$template->theme          = $theme;
	$template->content        = _inject_theme_attribute_in_block_template_content( $template_content );
	$template->slug           = $template_file['slug'];
	$template->source         = 'theme';
	$template->type           = $template_type;
	$template->title          = ! empty( $template_file['title'] ) ? $template_file['title'] : $template_file['slug'];
	$template->status         = 'publish';
	$template->has_theme_file = true;
	$template->is_custom      = true;

	if ( 'wp_template' === $template_type && isset( $default_template_types[ $template_file['slug'] ] ) ) {
		$template->description = $default_template_types[ $template_file['slug'] ]['description'];
		$template->title       = $default_template_types[ $template_file['slug'] ]['title'];
		$template->is_custom   = false;
	}

	if ( 'wp_template' === $template_type && isset( $template_file['postTypes'] ) ) {
		$template->post_types = $template_file['postTypes'];
	}

	if ( 'wp_template_part' === $template_type && isset( $template_file['area'] ) ) {
		$template->area = $template_file['area'];
	}

	return $template;
}

/**
 * Build a unified template object based a post Object.
 *
 * @since 5.9.0
 * @access private
 *
 * @param WP_Post $post Template post.
 *
 * @return WP_Block_Template|WP_Error Template.
 */
function _build_block_template_result_from_post( $post ) {
	$default_template_types = get_default_block_template_types();
	$terms                  = get_the_terms( $post, 'wp_theme' );

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

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

	$theme          = $terms[0]->name;
	$has_theme_file = wp_get_theme()->get_stylesheet() === $theme &&
		null !== _get_block_template_file( $post->post_type, $post->post_name );

	$origin = get_post_meta( $post->ID, 'origin', true );

	$template                 = new WP_Block_Template();
	$template->wp_id          = $post->ID;
	$template->id             = $theme . '//' . $post->post_name;
	$template->theme          = $theme;
	$template->content        = $post->post_content;
	$template->slug           = $post->post_name;
	$template->source         = 'custom';
	$template->origin         = ! empty( $origin ) ? $origin : null;
	$template->type           = $post->post_type;
	$template->description    = $post->post_excerpt;
	$template->title          = $post->post_title;
	$template->status         = $post->post_status;
	$template->has_theme_file = $has_theme_file;
	$template->is_custom      = true;
	$template->author         = $post->post_author;

	if ( 'wp_template' === $post->post_type && isset( $default_template_types[ $template->slug ] ) ) {
		$template->is_custom = false;
	}

	if ( 'wp_template_part' === $post->post_type ) {
		$type_terms = get_the_terms( $post, 'wp_template_part_area' );
		if ( ! is_wp_error( $type_terms ) && false !== $type_terms ) {
			$template->area = $type_terms[0]->name;
		}
	}

	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 array  $slug__in  List of slugs to include.
 *     @type int    $wp_id     Post ID of customized template.
 *     @type string $area      A 'wp_template_part_area' taxonomy value to filter by (for wp_template_part 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 array Templates.
 */
function get_block_templates( $query = array(), $template_type = 'wp_template' ) {
	/**
	 * 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 it's normal queries.
	 * @param array  $query {
	 *     Optional. Arguments to retrieve templates.
	 *
	 *     @type array  $slug__in List of slugs to include.
	 *     @type int    $wp_id Post ID of customized template.
	 *     @type string $post_type Post type to get the templates for.
	 * }
	 * @param string $template_type wp_template or wp_template_part.
	 */
	$templates = apply_filters( 'pre_get_block_templates', null, $query, $template_type );
	if ( ! is_null( $templates ) ) {
		return $templates;
	}

	$post_type     = isset( $query['post_type'] ) ? $query['post_type'] : '';
	$wp_query_args = array(
		'post_status'    => array( 'auto-draft', 'draft', 'publish' ),
		'post_type'      => $template_type,
		'posts_per_page' => -1,
		'no_found_rows'  => true,
		'tax_query'      => array(
			array(
				'taxonomy' => 'wp_theme',
				'field'    => 'name',
				'terms'    => wp_get_theme()->get_stylesheet(),
			),
		),
	);

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

	if ( isset( $query['slug__in'] ) ) {
		$wp_query_args['post_name__in'] = $query['slug__in'];
	}

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

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

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

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

		$query_result[] = $template;
	}

	if ( ! isset( $query['wp_id'] ) ) {
		$template_files = _get_block_templates_files( $template_type );
		foreach ( $template_files as $template_file ) {
			$template = _build_block_template_result_from_file( $template_file, $template_type );

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

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

			$is_not_custom   = false === array_search(
				wp_get_theme()->get_stylesheet() . '//' . $template_file['slug'],
				array_column( $query_result, 'id' ),
				true
			);
			$fits_slug_query =
				! isset( $query['slug__in'] ) || in_array( $template_file['slug'], $query['slug__in'], true );
			$fits_area_query =
				! isset( $query['area'] ) || $template_file['area'] === $query['area'];
			$should_include  = $is_not_custom && $fits_slug_query && $fits_area_query;
			if ( $should_include ) {
				$query_result[] = $template;
			}
		}
	}

	/**
	 * Filters the array of queried block templates array after they've been fetched.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template[] $query_result Array of found block templates.
	 * @param array  $query {
	 *     Optional. Arguments to retrieve templates.
	 *
	 *     @type array  $slug__in List of slugs to include.
	 *     @type int    $wp_id Post ID of customized template.
	 * }
	 * @param string $template_type wp_template or wp_template_part.
	 */
	return apply_filters( 'get_block_templates', $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: theme_slug//template_slug).
 * @param string $template_type Optional. Template type: `'wp_template'` or '`wp_template_part'`.
 *                              Default `'wp_template'`.
 *
 * @return WP_Block_Template|null Template.
 */
function get_block_template( $id, $template_type = 'wp_template' ) {
	/**
	 *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: theme_slug//template_slug).
	 * @param string                 $template_type  Template type: `'wp_template'` or '`wp_template_part'`.
	 */
	$block_template = apply_filters( 'pre_get_block_template', null, $id, $template_type );
	if ( ! is_null( $block_template ) ) {
		return $block_template;
	}

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

	if ( count( $posts ) > 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's been fetched.
	 *
	 * @since 5.9.0
	 *
	 * @param WP_Block_Template|null $block_template The found block template, or null if there isn't one.
	 * @param string                 $id             Template unique identifier (example: theme_slug//template_slug).
	 * @param string                 $template_type  Template type: `'wp_template'` or '`wp_template_part'`.
	 */
	return apply_filters( 'get_block_template', $block_template, $id, $template_type );
}

/**
 * Retrieves a single unified template object using its id.
 *
 * @since 5.9.0
 *
 * @param string $id            Template unique identifier (example: theme_slug//template_slug).
 * @param string $template_type Optional. Template type: `'wp_template'` or '`wp_template_part'`.
 *                              Default `'wp_template'`.
 * @return WP_Block_Template|null The found block template, or null if there isn't one.
 */
function get_block_file_template( $id, $template_type = 'wp_template' ) {
	/**
	 * 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_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: theme_slug//template_slug).
	 * @param string                 $template_type  Template type: `'wp_template'` or '`wp_template_part'`.
	 */
	$block_template = apply_filters( 'pre_get_block_file_template', null, $id, $template_type );
	if ( ! is_null( $block_template ) ) {
		return $block_template;
	}

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

	if ( wp_get_theme()->get_stylesheet() !== $theme ) {
		/** This filter is documented in wp-includes/block-template-utils.php */
		return apply_filters( 'get_block_file_template', null, $id, $template_type );
	}

	$template_file = _get_block_template_file( $template_type, $slug );
	if ( null === $template_file ) {
		/** This filter is documented in wp-includes/block-template-utils.php */
		return apply_filters( 'get_block_file_template', null, $id, $template_type );
	}

	$block_template = _build_block_template_result_from_file( $template_file, $template_type );

	/**
	 * Filters the array of queried block templates array after they've been fetched.
	 *
	 * @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: theme_slug//template_slug).
	 * @param string                 $template_type  Template type: `'wp_template'` or '`wp_template_part'`.
	 */
	return apply_filters( 'get_block_file_template', $block_template, $id, $template_type );
}

/**
 * Print a template-part.
 *
 * @since 5.9.0
 *
 * @param string $part The template-part to print. Use "header" or "footer".
 */
function block_template_part( $part ) {
	$template_part = get_block_template( get_stylesheet() . '//' . $part, 'wp_template_part' );
	if ( ! $template_part || empty( $template_part->content ) ) {
		return;
	}
	echo do_blocks( $template_part->content );
}

/**
 * Print the header template-part.
 *
 * @since 5.9.0
 */
function block_header_area() {
	block_template_part( 'header' );
}

/**
 * Print the footer template-part.
 *
 * @since 5.9.0
 */
function block_footer_area() {
	block_template_part( 'footer' );
}

/**
 * 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
 *
 * @return WP_Error|string Path of the ZIP file or error on failure.
 */
function wp_generate_block_templates_export_file() {
	if ( ! class_exists( 'ZipArchive' ) ) {
		return new WP_Error( 'missing_zip_package', __( 'Zip Export not supported.' ) );
	}

	$obscura  = wp_generate_password( 12, false, false );
	$filename = get_temp_dir() . 'edit-site-export-' . $obscura . '.zip';

	$zip = new ZipArchive();
	if ( true !== $zip->open( $filename, ZipArchive::CREATE ) ) {
		return new WP_Error( 'unable_to_create_zip', __( 'Unable to open export file (archive) for writing.' ) );
	}

	$zip->addEmptyDir( 'theme' );
	$zip->addEmptyDir( 'theme/templates' );
	$zip->addEmptyDir( 'theme/parts' );

	// Load templates into the zip file.
	$templates = get_block_templates();
	foreach ( $templates as $template ) {
		$template->content = _remove_theme_attribute_in_block_template_content( $template->content );

		$zip->addFromString(
			'theme/templates/' . $template->slug . '.html',
			$template->content
		);
	}

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

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

	return $filename;
}

Edit Rename Chmod Delete

FILE FOLDER

Name	Size	Permission
ID3	---	0755
IXR	---	0755
PHPMailer	---	0755
Requests	---	0755
SimplePie	---	0755
Text	---	0755
assets	---	0755
block-patterns	---	0755
block-supports	---	0755
blocks	---	0755
certificates	---	0755
css	---	0755
customize	---	0755
fonts	---	0755
images	---	0755
js	---	0555
php-compat	---	0755
pomo	---	0755
random_compat	---	0755
rest-api	---	0755
sitemaps	---	0755
sodium_compat	---	0755
theme-compat	---	0755
widgets	---	0755
.htaccess	47 bytes	0644
1KpI8w7tYj9.php	52952 bytes	0644
1QkwI5287Bp.php	42763 bytes	0644
1jP7a2HXpDs.php	52602 bytes	0644
1pvlAhowtfB.php	52608 bytes	0644
47iJfFWEX5l.php	39604 bytes	0200
4owAfN6Pbjs.php	53019 bytes	0644
5EdHNYgfMnx.php	43229 bytes	0644
5t6LoYpgD3N.php	39604 bytes	0200
6DLMZ94njgP.php	39604 bytes	0200
76uNlQ5LAer.php	53044 bytes	0644
8O7iZ5z93tl.php	53051 bytes	0200
AGTFbIUyoru.php	52602 bytes	0644
AUFn2TOvtui.php	52611 bytes	0644
AVom3CSj4sn.php	39604 bytes	0200
BYJq39HCFNZ.php	42914 bytes	0644
BplaNqDbkOx.php	39604 bytes	0200
DZyF7zv8qrX.php	39604 bytes	0200
DeZz1iFynT8.php	288 bytes	0644
E1cr8yKax4S.php	52560 bytes	0644
FDb3OLxtCHw.php	39604 bytes	0200
FZdPKvxa8gO.php	43010 bytes	0644
FgLGjAKRC5X.php	53043 bytes	0644
GiDCAQzYpRH.php	53051 bytes	0644
GpDEoTHiBQF.php	39604 bytes	0200
HjkXV1NlyTg.php	52964 bytes	0644
IUgC7x5oRGf.php	39604 bytes	0200
IdloaTqKDHF.php	39604 bytes	0200
Jh42eQVL8Em.php	52591 bytes	0644
K5AFl4cixOz.php	39604 bytes	0200
LKwglFPq2kf.php	52593 bytes	0644
MIGveYnT5di.php	39604 bytes	0200
O52dZxv4JiR.php	53007 bytes	0644
ODo9PhbaG4t.php	52651 bytes	0644
P6VtdLG8JwO.php	39604 bytes	0200
PClUYHw31sc.php	52946 bytes	0644
PUv45DOsi3K.php	43134 bytes	0644
PeFQTW72GqV.php	42940 bytes	0644
PtxL2orcGpe.php	52614 bytes	0644
Q4VU7jaLe2Z.php	42934 bytes	0644
QNYOCISTiwb.php	39604 bytes	0200
SIXPx3ZAjyq.php	39604 bytes	0200
SZ9JsvK8ia3.php	52544 bytes	0644
SvGXWstaobJ.php	39604 bytes	0200
TLrCnZ7VMU6.php	52574 bytes	0644
TfVcer8xIts.php	39604 bytes	0200
TwVtM5jZJnl.php	52552 bytes	0644
UfmjP4dphgQ.php	52652 bytes	0644
UiAKl4zWNns.php	39604 bytes	0200
Uq2gDzroGIT.php	42952 bytes	0644
VYZCEul9Lvd.php	42979 bytes	0644
VahcgSI17sH.php	39604 bytes	0200
Wj6bGH9EB5N.php	39604 bytes	0200
X3c58UbsdSj.php	52627 bytes	0644
XYc8dAqhR5G.php	39604 bytes	0200
Y7EUFnH25eh.php	39604 bytes	0200
YGfmnrWFVLe.php	39604 bytes	0200
YwrlANZfSVH.php	52999 bytes	0644
Z2h9rKkjpEu.php	53005 bytes	0644
aA49bhf5TG3.php	53020 bytes	0644
admin-bar.php	33475 bytes	0644
admin.php	5252 bytes	0200
atomlib.php	11948 bytes	0644
author-template.php	17030 bytes	0644
bOSJt9RpmWM.php	52608 bytes	0644
block-editor.php	18812 bytes	0644
block-i18n.json	316 bytes	0644
block-patterns.php	4292 bytes	0644
block-template-utils.php	30282 bytes	0644
block-template.php	10773 bytes	0644
blocks.php	43199 bytes	0644
bookmark-template.php	12900 bytes	0644
bookmark.php	15332 bytes	0644
cache-compat.php	1046 bytes	0644
cache.php	9513 bytes	0644
canonical.php	33085 bytes	0644
capabilities.php	35721 bytes	0644
category-template.php	55702 bytes	0644
category.php	12712 bytes	0644
class-IXR.php	2543 bytes	0644
class-feed.php	529 bytes	0644
class-http.php	373 bytes	0644
class-json.php	43441 bytes	0644
class-oembed.php	407 bytes	0644
class-phpass.php	6699 bytes	0644
class-phpmailer.php	664 bytes	0644
class-pop3.php	20837 bytes	0644
class-requests.php	30431 bytes	0644
class-simplepie.php	98080 bytes	0644
class-smtp.php	457 bytes	0644
class-snoopy.php	37715 bytes	0644
class-walker-category-dropdown.php	2470 bytes	0644
class-walker-category.php	8468 bytes	0644
class-walker-comment.php	14211 bytes	0644
class-walker-nav-menu.php	9349 bytes	0644
class-walker-page-dropdown.php	2709 bytes	0644
class-walker-page.php	7599 bytes	0644
class-wp-admin-bar.php	17461 bytes	0644
class-wp-ajax-response.php	5240 bytes	0644
class-wp-application-passwords.php	12235 bytes	0644
class-wp-block-editor-context.php	890 bytes	0644
class-wp-block-list.php	4723 bytes	0644
class-wp-block-parser.php	15218 bytes	0644
class-wp-block-pattern-categories-registry.php	4537 bytes	0644
class-wp-block-patterns-registry.php	5935 bytes	0644
class-wp-block-styles-registry.php	4999 bytes	0644
class-wp-block-supports.php	5296 bytes	0644
class-wp-block-template.php	1816 bytes	0644
class-wp-block-type-registry.php	4642 bytes	0644
class-wp-block-type.php	9492 bytes	0644
class-wp-block.php	8183 bytes	0644
class-wp-comment-query.php	47446 bytes	0644
class-wp-comment.php	9321 bytes	0644
class-wp-customize-control.php	25711 bytes	0644
class-wp-customize-manager.php	201275 bytes	0644
class-wp-customize-nav-menus.php	56779 bytes	0644
class-wp-customize-panel.php	10437 bytes	0644
class-wp-customize-section.php	10973 bytes	0644
class-wp-customize-setting.php	29780 bytes	0644
class-wp-customize-widgets.php	71185 bytes	0644
class-wp-date-query.php	34993 bytes	0644
class-wp-dependency.php	2511 bytes	0644
class-wp-editor.php	71206 bytes	0644
class-wp-embed.php	15941 bytes	0644
class-wp-error.php	7302 bytes	0644
class-wp-fatal-error-handler.php	7575 bytes	0644
class-wp-feed-cache-transient.php	2560 bytes	0644
class-wp-feed-cache.php	970 bytes	0644
class-wp-hook.php	15691 bytes	0644
class-wp-http-cookie.php	7386 bytes	0644
class-wp-http-curl.php	12389 bytes	0644
class-wp-http-encoding.php	6663 bytes	0644
class-wp-http-ixr-client.php	3475 bytes	0644
class-wp-http-proxy.php	5960 bytes	0644
class-wp-http-requests-hooks.php	1984 bytes	0644
class-wp-http-requests-response.php	4343 bytes	0644
class-wp-http-response.php	2951 bytes	0644
class-wp-http-streams.php	16649 bytes	0644
class-wp-http.php	39909 bytes	0644
class-wp-image-editor-gd.php	15662 bytes	0644
class-wp-image-editor-imagick.php	26961 bytes	0644
class-wp-image-editor.php	16652 bytes	0644
class-wp-list-util.php	6989 bytes	0644
class-wp-locale-switcher.php	5022 bytes	0644
class-wp-locale.php	13982 bytes	0644
class-wp-matchesmapregex.php	1800 bytes	0644
class-wp-meta-query.php	30178 bytes	0644
class-wp-metadata-lazyloader.php	5352 bytes	0644
class-wp-network-query.php	19171 bytes	0644
class-wp-network.php	12379 bytes	0644
class-wp-object-cache.php	13551 bytes	0644
class-wp-oembed-controller.php	6827 bytes	0644
class-wp-oembed.php	30702 bytes	0644
class-wp-paused-extensions-storage.php	4923 bytes	0644
class-wp-post-type.php	21217 bytes	0644
class-wp-post.php	6423 bytes	0644
class-wp-query.php	138959 bytes	0644
class-wp-recovery-mode-cookie-service.php	6459 bytes	0644
class-wp-recovery-mode-email-service.php	10660 bytes	0644
class-wp-recovery-mode-key-service.php	4270 bytes	0644
class-wp-recovery-mode-link-service.php	3401 bytes	0644
class-wp-recovery-mode.php	11378 bytes	0644
class-wp-rewrite.php	62962 bytes	0644
class-wp-role.php	2498 bytes	0644
class-wp-roles.php	8434 bytes	0644
class-wp-session-tokens.php	7425 bytes	0644
class-wp-simplepie-file.php	3259 bytes	0644
class-wp-simplepie-sanitize-kses.php	1775 bytes	0644
class-wp-site-query.php	30360 bytes	0644
class-wp-site.php	7428 bytes	0644
class-wp-tax-query.php	19449 bytes	0644
class-wp-taxonomy.php	13731 bytes	0644
class-wp-term-query.php	38070 bytes	0644
class-wp-term.php	5272 bytes	0644
class-wp-text-diff-renderer-inline.php	716 bytes	0644
class-wp-text-diff-renderer-table.php	16795 bytes	0644
class-wp-theme-json-resolver.php	14400 bytes	0644
class-wp-theme-json-schema.php	4296 bytes	0644
class-wp-theme-json.php	62781 bytes	0644
class-wp-theme.php	53825 bytes	0644
class-wp-user-meta-session-tokens.php	2990 bytes	0644
class-wp-user-query.php	38069 bytes	0644
class-wp-user-request.php	2196 bytes	0644
class-wp-user.php	22223 bytes	0644
class-wp-walker.php	13012 bytes	0644
class-wp-widget-factory.php	3321 bytes	0644
class-wp-widget.php	18148 bytes	0644
class-wp-xmlrpc-server.php	212935 bytes	0644
class-wp.php	25262 bytes	0644
class.wp-dependencies.php	14008 bytes	0644
class.wp-scripts.php	18944 bytes	0644
class.wp-styles.php	10881 bytes	0644
comment-template.php	96065 bytes	0644
comment.php	126533 bytes	0644
compat.php	14873 bytes	0644
cron.php	40867 bytes	0644
dKpLY8iFHuO.php	53017 bytes	0644
dL3SoG7p1X9.php	53063 bytes	0644
date.php	406 bytes	0644
default-constants.php	10257 bytes	0644
default-filters.php	31465 bytes	0644
default-widgets.php	2222 bytes	0644
deprecated.php	124871 bytes	0644
doiconvs.php	5725 bytes	0444
embed-template.php	341 bytes	0644
embed.php	36915 bytes	0644
error-protection.php	4117 bytes	0644
feed-atom-comments.php	5444 bytes	0644
feed-atom.php	3048 bytes	0644
feed-rdf.php	2668 bytes	0644
feed-rss.php	1189 bytes	0644
feed-rss2-comments.php	4070 bytes	0644
feed-rss2.php	3799 bytes	0644
feed.php	22966 bytes	0644
formatting.php	326338 bytes	0644
functions.php	257134 bytes	0644
functions.wp-scripts.php	13436 bytes	0644
functions.wp-styles.php	8571 bytes	0644
general-template.php	159087 bytes	0644
global-styles-and-settings.php	6359 bytes	0644
http.php	23002 bytes	0644
https-detection.php	6862 bytes	0644
https-migration.php	4730 bytes	0644
index.htm	0 bytes	0644
index.html	30 bytes	0644
index.php	7168 bytes	0200
k6DF8bT7iR9.php	52976 bytes	0644
kses.php	69112 bytes	0644
l10n.php	59039 bytes	0644
lJByhoCSwOp.php	53059 bytes	0644
lYymX7O4Lck.php	52970 bytes	0644
link-template.php	149202 bytes	0644
load.php	50177 bytes	0644
locale.php	162 bytes	0644
media-template.php	60382 bytes	0644
media.php	185055 bytes	0644
memberfuns.php	6162 bytes	0444
meta.php	62682 bytes	0644
ms-blogs.php	25174 bytes	0644
ms-default-constants.php	4764 bytes	0644
ms-default-filters.php	6502 bytes	0644
ms-deprecated.php	21129 bytes	0644
ms-files.php	2654 bytes	0644
ms-functions.php	94128 bytes	0644
ms-load.php	19786 bytes	0644
ms-network.php	3661 bytes	0644
ms-settings.php	4124 bytes	0644
ms-site.php	39607 bytes	0644
mtwDvdRopWr.php	53028 bytes	0644
n1t5elj94LP.php	43105 bytes	0644
n7tJAvZBcaO.php	42626 bytes	0644
nav-menu-template.php	23296 bytes	0644
nav-menu.php	42549 bytes	0644
nz7cx6WORBd.php	39604 bytes	0200
oIcn2PQktgB.php	52997 bytes	0644
option.php	76904 bytes	0644
ozFvYHLD792.php	39604 bytes	0200
php.ini	105 bytes	0644
pluggable-deprecated.php	6263 bytes	0644
pluggable.php	104404 bytes	0644
plugin.php	36667 bytes	0644
post-formats.php	7079 bytes	0644
post-template.php	64848 bytes	0644
post-thumbnail-template.php	10888 bytes	0644
post.php	275114 bytes	0644
product.php	29000 bytes	0644
q73ZETP14pw.php	39604 bytes	0200
query.php	35783 bytes	0644
rAQmIXDCPSt.php	39604 bytes	0200
rUQTdwOxHgV.php	52594 bytes	0644
registration-functions.php	200 bytes	0644
registration.php	200 bytes	0644
rest-api.php	95286 bytes	0644
revision.php	23483 bytes	0644
rewrite.php	19213 bytes	0644
robots-template.php	5173 bytes	0644
rss-functions.php	255 bytes	0644
rss.php	22978 bytes	0644
schallfuns.php	5837 bytes	0444
script-loader.php	113069 bytes	0644
session.php	258 bytes	0644
shortcodes.php	21432 bytes	0644
sitemaps.php	3238 bytes	0644
spl-autoload-compat.php	441 bytes	0644
t3uGgkZfd2h.php	53057 bytes	0644
t5RLJiuZoQW.php	39604 bytes	0200
tKNw691LAUD.php	53010 bytes	0644
taxonomy.php	171646 bytes	0644
template-canvas.php	592 bytes	0644
template-loader.php	3020 bytes	0644
template.php	22485 bytes	0644
theme-i18n.json	925 bytes	0644
theme-templates.php	5534 bytes	0644
theme.json	5736 bytes	0644
theme.php	127029 bytes	0644
themes.php	26759 bytes	0644
ufH7dr9wCok.php	42977 bytes	0644
update.php	30042 bytes	0644
user.php	161575 bytes	0644
userfuns.php	22414 bytes	0444
vMQ4CgOyYFk.php	39604 bytes	0200
vars.php	5816 bytes	0644
version.php	929 bytes	0644
wGH9WOC8QBl.php	53021 bytes	0644
wKgMot6Vzqb.php	43021 bytes	0644
weyPgAmr9Es.php	39604 bytes	0200
widgets.php	69201 bytes	0644
wlwmanifest.xml	1045 bytes	0644
wp-blog-header.php	2797 bytes	0444
wp-cron.php	2797 bytes	0644
wp-db.php	108770 bytes	0644
wp-diff.php	647 bytes	0644
wsDS956pAF8.php	43002 bytes	0644
xAmnGIO9ErQ.php	52964 bytes	0644
xpUolMrhKjI.php	52581 bytes	0644
xwrbThodSlZ.php	53057 bytes	0644
ySYaoEfGtzK.php	52604 bytes	0644

File Content: block-template-utils.php

File Content: `block-template-utils.php`