WordPress自定义PageRenderer模板白屏及区块编辑器适配咨询

架构说明 #

你提到的Frank\PageRenderer不是通用开源框架，是你们公司自研的主题自定义渲染层，设计逻辑为分层渲染：

• PageRenderer为调度层，负责根据页面类型、模板名匹配对应的实际渲染类
• TemplateRenderer为实际渲染层，旧逻辑绑定了经典编辑器底部挂载窗口录入的自定义字段输出，所以默认不支持区块编辑器内容输出

白屏问题原因 #

你编写的测试模板白屏是因为PageRenderer的自动匹配逻辑：
getTemplateRendererClass方法会根据你设置的模板名Template test，拼接查找TemplateRenderer_{当前文章类型}_template_test类，项目中不存在对应类时会抛出异常，生产环境下WP关闭错误显示就会返回白屏。

解除经典编辑器依赖方案 #

方案1：极简原生模板（最快满足需求，完全脱离旧架构绑定） #

直接写不依赖PageRenderer的原生WP模板，仅调用头尾、输出区块编辑器内容：

<?php
/*
Template Name: 区块编辑器兼容模板
*/
// 调用主题头部
get_header();

// WP主循环拉取页面内容
if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
        // 自动解析输出古腾堡区块内容
        the_content();
    }
}

// 调用主题尾部
get_footer();
?>

方案2：适配现有PageRenderer架构 #

如果你需要沿用现有架构的能力，可以新增适配区块输出的渲染类，同时在模板中指定渲染器，跳过自动匹配逻辑：

1. 新增区块渲染类TemplateRenderer_block_default.php，实现TemplateRendererInterface接口，render方法直接返回get_the_content($this->post)即可
2. 修改你的测试模板代码，手动指定渲染器：

<?php
/*
Template Name: Template test
*/
use Frank\PageRenderer\PageRenderer;
use Frank\TemplateRenderer\TemplateRenderer_block_default;

get_header();

$renderer = new PageRenderer();
$renderer->setSingular((is_single() || is_page()));
// 手动指定区块渲染器，跳过自动匹配
$renderer->setTemplateRenderer(new TemplateRenderer_block_default($post));

if (have_posts()) {
    while (have_posts()) {
        the_post();
        $renderer->addPost($post);
    }
}
$renderer->render(); 
get_footer();
?>

注意事项 #

• 禁用经典编辑器前请先备份全量页面数据，避免旧架构挂载的自定义字段内容丢失
• 如果需要兼容旧页面的历史内容，可以在渲染逻辑中增加判断，存在区块内容时输出区块，不存在时读取旧自定义字段输出

内容的提问来源于stack exchange，提问作者ClintN