在WordPress中引入自定义模板引擎太麻烦？brain/hierarchy助你轻松驾驭模板加载！

<code class="bash">composer require brain/hierarchy</code>

<pre class="brush:php;toolbar:false;">// 假设我们正在访问一个分类页面，例如 example.com/category/foo/
global $wp_query;

$hierarchy = new Brain\Hierarchy\Hierarchy();

// 获取WordPress将要查找的模板文件名列表，按顺序排列
$templatesToSearch = $hierarchy->templates($wp_query);

/*
输出示例 (假设分类slug为'foo', ID为123):
array(
  'category-foo',
  'category-123',
  'category',
  'archive',
  'paged', // 如果是分页
  'index',
);
*/
var_export($templatesToSearch);

<pre class="brush:php;toolbar:false;">// 默认行为：查找并加载主题目录下的PHP模板
add_action('template_redirect', function(): void {
    global $wp_query;

    $queryTemplate = new \Brain\Hierarchy\QueryTemplate();
    // loadTemplate() 方法会返回模板内容，所以需要 echo 打印
    echo $queryTemplate->loadTemplate($wp_query);

    exit(); // 阻止WordPress继续执行默认的模板加载
});

<pre class="brush:php;toolbar:false;">use Brain\Hierarchy\Finder;

// 在主题的 'templates' 子目录中查找，并优先查找 '.mustache' 文件，其次是 '.php'
$finder = new Finder\BySubfolder('templates', 'mustache', 'php');

$queryTemplate = new \Brain\Hierarchy\QueryTemplate($finder);
// ... 之后调用 $queryTemplate->loadTemplate() 即可

<pre class="brush:php;toolbar:false;"><?php
// functions.php 或你的插件文件中

namespace My\Theme;

use Brain\Hierarchy\{Finder, Loader, QueryTemplate};

// 1. 创建一个自定义的 Mustache 模板加载器
class MustacheTemplateLoader implements Loader\Loader
{
   private \Mustache_Engine $engine;

   public function __construct(\Mustache_Engine $engine)
   {
      $this->engine = $engine;
   }

   public function load(string $templatePath): string
   {
        // 从模板文件读取内容
        $templateContent = file_get_contents($templatePath);

        // 我们可以通过过滤器为模板提供数据上下文
        // 例如，将 $wp_query 对象传递给模板
        $data = apply_filters('my_theme_mustache_data', [
            'query' => $GLOBALS['wp_query'],
            'template_path' => $templatePath,
            // 更多你希望传递给模板的数据...
        ]);

        // 使用 Mustache 引擎渲染模板并返回结果
        return $this->engine->render($templateContent, $data);
   }
}

// 2. 在 template_redirect 钩子中接管模板加载
add_action('template_redirect', function() {
    // 确保只处理主查询的模板加载，避免影响后台或其他特殊请求
    if (!QueryTemplate::mainQueryTemplateAllowed()) {
        return;
    }

    // 初始化 Mustache 引擎 (你需要先通过 Composer 安装 mustache/mustache)
    $mustacheEngine = new \Mustache_Engine([
        'loader' => new \Mustache_Loader_FilesystemLoader(get_stylesheet_directory() . '/templates'),
        // 其他 Mustache 配置
    ]);

    $queryTemplate = new QueryTemplate(
        // 查找器：在主题的 'templates' 子文件夹中查找 '.mustache' 文件
        new Finder\BySubfolder('templates', 'mustache'),
        // 加载器：使用我们自定义的 MustacheTemplateLoader
        new MustacheTemplateLoader($mustacheEngine)
    );

    $found = false; // 用于判断是否找到模板
    // 加载模板，第二个参数 false 表示不应用 WordPress 核心的 template_include 过滤器
    // 第三个参数 $found 会在找到模板时被设置为 true
    $content = $queryTemplate->loadTemplate(null, false, $found);

    // 如果找到了模板，就输出内容并终止WordPress的默认执行流程
    if ($found) {
        die($content);
    }
});

// 示例：为 Mustache 模板提供数据
add_filter('my_theme_mustache_data', function(array $data) {
    // 假设你想在模板中使用当前文章的标题
    if (is_single()) {
        $data['post_title'] = get_the_title();
    }
    return $data;
});