WordPress子主题自定义文章模板缺失页眉页脚问题咨询

绝对不要把自定义模板放到父主题目录。Hello Elementor更新时会全量覆盖父主题下的所有文件，你写的自定义代码会直接丢失，在子主题下存放自定义模板是WordPress官方认可的标准实现方式，完全可以做到正常加载页眉页脚、长期兼容更新。

子主题下的自定义CPT模板丢失页眉页脚，根本不是父主题有什么特殊的拦截注入逻辑——是你写的single-{entity name}.php本身没引入WordPress全局的页眉、页脚渲染函数，也没对齐父主题的基础页面结构。你把相同文件复制到父主题就能正常显示，只是因为父主题目录下的原生模板文件默认自带了这些基础调用，你复制过去的文件如果是基于父主题原生模板改的，自然带了相关代码。

• 先把父主题目录下你之前放进去的single-{entity name}.php彻底删掉，所有自定义模板逻辑全部挪回子主题对应目录
• 打开父主题原生的single.php文件，把里面除了文章内容循环输出部分的外层代码完整复制到你子主题的single-{entity name}.php里，核心要保留三个部分：
  • 页面最顶部的get_header()函数调用，这是WordPress加载页眉的核心入口
  • 外层的页面容器结构、Elementor相关的模板判断逻辑
  • 页面最底部的get_footer()函数调用，这是WordPress加载页脚的核心入口
• 把你自己写的CPT内容渲染逻辑，放到主内容容器的对应位置，替换掉父主题single.php里默认的文章循环代码即可。标准的基础模板结构参考如下：

<?php
get_header();

if ( ! function_exists( 'elementor_theme_do_location' ) || ! elementor_theme_do_location( 'single' ) ) {
?>
<main id="primary" class="site-main">
    <?php
    // 以下区域替换为你自定义CPT的渲染逻辑
    // 比如自定义字段输出、实体信息展示、业务相关的结构代码都写在这里
    ?>
</main>
<?php
}

get_footer();
?>

• 保存文件后刷新CPT详情页，页眉页脚就会正常加载，和站点其他页面的渲染逻辑完全统一。

• 所有自定义代码、模板文件全部存放在子主题目录下，后续WordPress核心、Hello Elementor父主题更新时，子主题内容不会被覆盖，不会出现自定义逻辑丢失、页面异常的问题
• 如果后续需要用Elementor可视化编辑这个CPT的模板，只需要在注册自定义文章类型时，开启show_in_rest参数，同时在supports配置里加上editor支持，就可以直接用Elementor主题构建器可视化配置模板，不需要手写PHP代码
• 不要直接修改父主题的任何文件，包括functions.php、模板文件、样式文件等，所有调整全部通过子主题实现。

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