TYPO3升级至10.4.32后News插件模板/布局无法加载求助
TYPO3 10.4升级后News插件布局失效排查方案
检查News扩展版本兼容性
TYPO3 10.4要求News扩展版本至少为8.x,先确认当前安装的News版本是否适配。可通过扩展管理器查看版本信息,或检查composer.lock文件中的版本记录。若版本过低,升级到兼容的分支(如8.7.x及以上适配10.4的版本)。验证TypoScript配置加载状态
- 进入后端「模板」模块,选择根模板,点击「信息」→「整个模板的TypoScript」,搜索
plugin.tx_news.view相关节点。 - 若未找到对应配置,需确认:
- 根模板的「包含静态模板」中是否勾选了
News (news)静态模板; - 可直接在根模板的Setup中导入
EXT:news/Configuration/TypoScript/setup.typoscript,替代依赖已标记为废弃的setup.txt文件。
- 根模板的「包含静态模板」中是否勾选了
- 进入后端「模板」模块,选择根模板,点击「信息」→「整个模板的TypoScript」,搜索
检查模板路径变量赋值
你的配置中使用了{$plugin.tx_news.view.templateRootPath}这类变量,需确认常量中是否赋值:- 进入模板模块「常量」编辑器,搜索
plugin.tx_news.view; - 若未设置自定义路径,可直接将配置中的1号路径替换为具体路径,或删除该条配置(仅保留默认的0号路径)。
- 进入模板模块「常量」编辑器,搜索
清除全部缓存
升级后缓存残留可能导致配置未生效,进入「系统」→「清除缓存」,选择「全部缓存」(含页面缓存、配置缓存等),刷新前端页面验证。核对模板文件的位置与命名
确认自定义模板/布局文件是否在指定路径下,文件名是否符合News的命名规范(如List.html、Detail.html);TYPO3 10.x对路径大小写敏感,需确保文件名和路径大小写完全匹配。检查插件的局部模板设置
编辑页面中的News插件,查看「外观」标签页是否手动设置了「模板路径」或「布局」——局部设置会覆盖全局TypoScript配置,若无需自定义,保持默认即可。
内容的提问来源于stack exchange,提问作者Cem Flav
相关产品推荐
相关产品推荐

