Timber WordPress自定义页面添加失败及插件激活报错求助

页面模板未显示的修复操作 #

WordPress（包括Timber集成场景）要求自定义页面模板必须在PHP文件顶部添加模板声明注释，否则系统无法识别。在contact.php最顶部添加以下代码：

<?php
/*
Template Name: 联系页面
*/

use Timber\Timber;

$context = Timber::context();
$context['post'] = Timber::get_post();

Timber::render('contact.twig', $context);

其中Template Name的值会直接显示在页面属性的模板下拉框中，可根据需求修改名称。同时确保contact.php放在主题根目录（和page.php同级），避免放在子目录导致识别失败。

Timber插件安装报错的原因及解决 #

你已通过Composer安装了Timber库，此时安装Timber插件会触发重复加载冲突——两者属于同一命名空间的代码，重复引入会直接抛出致命错误。解决方式：

• 无需安装Timber插件，Composer安装的Timber 2.x-dev已能满足需求，upstatement/timber-starter-theme主题已集成Composer的自动加载逻辑，直接使用即可。

额外验证步骤 #

• 清除WordPress缓存（含插件缓存），避免模板识别延迟；
• 确认contact.twig放在主题的views目录下，符合starter主题的模板路径规则。

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