概述

_get_block_template_file() 函数用于根据给定的模板类型和 slug 从主题中检索模板文件。它返回包含模板元数据的数组或 null，适用于块主题中的 'wp_template' 或 'wp_template_part' 类型。

关键要点

• 参数：$template_type（必需，字符串，只能是 'wp_template' 或 'wp_template_part'）和 $slug（必需，字符串，模板 slug）。
• 返回值：数组（包含 slug、path、theme、type 等元数据）或 null（如果 $template_type 无效或文件不存在）。
• 功能：遍历活动主题和父主题目录，查找匹配的 .html 文件，并调用辅助函数添加额外信息。
• 依赖函数：如 get_block_theme_folders()、_add_block_template_part_area_info() 和 _add_block_template_info()。

代码示例

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 it's not a `wp_template_part`, it must be a `wp_template`.
            return _add_block_template_info( $new_template_item );
        }
    }

    return null;
}