TYPO3 10.4创建自定义内容元素前端模板路径错误如何解决?
TYPO3 10.4 自定义内容元素前端模板报错解决方案
报错核心是Fluid视图无法找到对应内容元素的模板文件,按照以下步骤逐一排查即可解决:
- 排查1:TypoScript文件拼写错误
你用于注册内容元素渲染规则的TypoScript文件名为oneColumnFlupbox.typoscript,和你定义的CTypeoneColumnFlipbox拼写不一致(Flup是错误拼写,正确应为Flip),会导致该配置文件没有被@import 'EXT:my_sitepackage_for_flipbox/Configuration/TypoScript/ContentElements/'规则加载。先修正文件名为oneColumnFlipbox.typoscript。 - 排查2:模板路径与命名规则不符合要求
TYPO3 Fluid默认要求模板文件名为首字母大写的驼峰格式,且自定义内容元素模板默认需要放在模板根路径下的ContentElements子目录中:
你配置的模板根路径为EXT:my_sitepackage_for_flipbox/Resources/Private/Templates/,因此需要确认存在文件:
EXT:my_sitepackage_for_flipbox/Resources/Private/Templates/ContentElements/OneColumnFlipbox.html
如果你的模板直接放在Templates根目录,可修改注册配置指定模板路径:
tt_content.oneColumnFlipbox =< lib.contentElement tt_content.oneColumnFlipbox { templateName = oneColumnFlipbox # 强制指定模板查找路径 templateRootPaths { 100 = EXT:my_sitepackage_for_flipbox/Resources/Private/Templates/ } }
- 排查3:确认站点模板已加载站点包配置
进入TYPO3后台「模板」模块,选择站点根页面,点击「信息/修改」-「设置」,检查当前生效的TypoScript是否存在tt_content.oneColumnFlipbox的配置;如果不存在,需要在根模板的「包含」选项中,引入你开发的站点包的静态模板。 - 排查4:模板文件权限问题
确认模板文件的读权限正常,Web服务运行用户可读取OneColumnFlipbox.html文件。
内容的提问来源于stack exchange,提问作者Miz15
相关产品推荐
相关产品推荐

