TYPO3 10.4如何通过TypoScript提取页面资源视频(类头图实现,IMG_RESOURCE失效)
TYPO3 10.4 页面资源视频提取实现方案
原方案失效原因
IMG_RESOURCE 是TYPO3专门为图片资源设计的内容对象,底层会强制走图片处理流程(尺寸缩放、裁剪、缩略图路径生成),遇到视频类非图片文件时会直接输出空值,即使复用了原头图的资源引用参数也无法正常解析。
可行实现逻辑
改用通用文件提取内容对象FILES,它支持所有文件类型的提取,完全兼容原头图的页面资源读取、父级页面资源继承逻辑,不需要改动原有头图的TypoScript配置即可并行实现视频提取。
核心配置代码
# 原有头图逻辑保留,无需修改 lib.HEADERIMG = IMG_RESOURCE lib.HEADERIMG { file { import = uploads/media/ import.data = levelmedia:-1, slide treatIdAsReference = 1 import.listNum = 0 } } # 新增视频资源提取逻辑 lib.HEADERVIDEO = FILES lib.HEADERVIDEO { # 对齐原头图的资源读取规则:从当前页资源读取,向上遍历继承父级页面资源 references { data = levelmedia:-1, slide treatIdAsReference = 1 } # 提取第一个匹配的资源 listNum = 0 # 白名单过滤,只提取视频类文件,避免混转头图等其他资源 mimeTypeWhitelist = video/mp4, video/webm, video/quicktime # 直接输出视频文件的可访问公开路径 renderObj = TEXT renderObj.data = file:current:publicUrl }
关键配置说明
- 资源引用参数从原
file.import节点迁移到references节点:这是FILES对象解析页面pages.media字段FileReference的标准位置,完全保留原逻辑的继承、引用解析能力 - 类型过滤配置:可根据实际使用的视频格式调整白名单内容;如果不需要过滤资源类型,直接删除
mimeTypeWhitelist行,即可提取资源列表中的第一个文件(无论格式) - 输出值的使用:渲染输出的
publicUrl是可直接嵌入<video>标签src属性的完整路径,不需要手动拼接站点域名或存储路径前缀
常见问题排查
- 如果输出内容为空,可临时移除
mimeTypeWhitelist配置测试,确认是类型不匹配还是资源引用逻辑读取失败 - 不要在
FILES配置中加入图片专属的处理参数(如尺寸、裁剪、压缩配置),视频资源不需要这类处理逻辑
内容的提问来源于stack exchange,提问作者webundso
相关产品推荐
相关产品推荐

