本文详细介绍了在TYPO3中创建自定义内容元素（CCE）的全过程，包括数据库字段定义、TCA配置、CType注册、后端表单配置、内容元素向导设置以及前端渲染。文章着重分析了Fluid模板解析机制，并针对开发过程中常见的“模板文件未找到”错误提供了具体解决方案，强调了Fluid模板命名约定在解决此类问题中的关键作用。
TYPO3自定义内容元素开发指南
在typo3中创建自定义内容元素（custom content element, cce）是扩展其功能和满足特定业务需求的关键方式。这允许开发者定义具有独特数据结构和渲染逻辑的页面内容块。本教程将引导您完成一个自定义内容元素的创建过程，并重点解决开发过程中常见的模板解析错误。
1. 自定义内容元素的核心组件
一个完整的TYPO3自定义内容元素通常涉及以下几个方面：
数据库字段（Database Fields）: 存储内容元素特有数据。TCA (Table Configuration Array) 配置: 定义后端表单中字段的显示和行为。CType 注册: 将自定义内容元素注册为TYPO3可识别的内容类型。后端编辑表单（Backend Edit Form）: 定义内容元素在TYPO3后台的编辑界面。新内容元素向导（New Content Element Wizard）: 使内容元素可在页面模块中轻松添加。数据处理器（DataProcessor）: （可选）在渲染前对数据进行预处理。前端渲染（Frontend Rendering）: 定义内容元素在网站上的显示方式，通常通过Fluid模板实现。
2. 创建自定义内容元素的详细步骤
以下是创建名为oneColumnFlipbox的自定义内容元素的具体步骤，该元素包含一个用于代码语言选择的下拉字段。
2.1 数据库字段定义
首先，在您的扩展（例如my_sitepackage_for_flipbox）的ext_localconf.php文件中，添加新的数据库字段到tt_content表。
[ 'exclude' => true, 'label' => 'LLL:EXT:my_sitepackage_for_flipbox/Resources/Private/Language/locallang_db.xlf:tt_content.code_language', 'config' => [ 'type' => 'select', 'renderType' => 'selectSingle', 'itemsProcFunc' => 'B13MySitepackageForFlipboxDataProviderCodeLanguages->getAll', // 自定义数据提供者 'default' => '', ], ], ]);
注意：完成此步骤后，请务必更新TYPO3安装工具中的数据库结构。
2.2 TCA配置
在您的扩展的Configuration/TCA/Overrides/tt_content.php文件中，配置新字段code_language的TCA，并将其添加到tt_content表的某个CType中。
[ 'label' => 'LLL:EXT:my_sitepackage_for_flipbox/Resources/Private/Language/locallang_db.xlf:tt_content.code_language', 'config' => [ 'type' => 'select', 'default' => '', 'itemsProcFunc' => 'B13MySitepackageForFlipboxDataProviderCodeLanguages->getAll', 'renderType' => 'selectSingle', ], ],];TYPO3CMSCoreUtilityExtensionManagementUtility::addTCAcolumns('tt_content', $additionalColumns);// 将字段添加到自定义内容类型 'oneColumnFlipbox' 的显示项中TYPO3CMSCoreUtilityExtensionManagementUtility::addToAllTCAtypes( 'tt_content', 'code_language', 'oneColumnFlipbox', // 确保这里是您的CType名称 'before:bodytext');
2.3 注册CType
在您的扩展的Configuration/TCA/Overrides/tt_content.php文件中，注册新的内容类型oneColumnFlipbox。
<?php// ... 其他TCA配置// 将内容元素添加到"CType"下拉列表TYPO3CMSCoreUtilityExtensionManagementUtility::addPlugin( [ '1 Column Flipbox', // 后台显示名称 'oneColumnFlipbox', // CType标识符 'EXT:my_sitepackage_for_flipbox/Resources/Public/Icons/T3Icons/content/content-carousel-image.svg' // 图标路径 ], 'CType', 'my_sitepackage_for_flipbox');
2.4 配置后端编辑表单
继续在Configuration/TCA/Overrides/tt_content.php文件中，配置oneColumnFlipbox内容类型在TYPO3后台的编辑字段。
' --palette--;' . $frontendLanguageFilePrefix . 'palette.general;general, --palette--;;headers, bodytext;' . $frontendLanguageFilePrefix . 'bodytext_formlabel, code_language, --linebreak--, --div--;' . $frontendLanguageFilePrefix . 'tabs.appearance, --palette--;' . $frontendLanguageFilePrefix . 'palette.frames;frames, --palette--;;appearanceLinks, --div--;' . $frontendLanguageFilePrefix . 'tabs.access, --palette--;' . $frontendLanguageFilePrefix . 'palette.visibility;visibility, --div--;LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:language, --palette--;;language, --div--;LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:categories, categories, --div--;' . $frontendLanguageFilePrefix . 'tabs.extended, --palette--;;hidden, --palette--;;access, ', 'columnsOverrides' => [ 'bodytext' => [ 'config' => [ 'enableRichtext' => true, 'richtextConfiguration' => 'default', ], ], ],];
请注意，这里我们将code_language字段也添加到了showitem中。
2.5 配置新内容元素向导 (PageTSConfig)
在ext_localconf.php中引入PageTSConfig文件，然后在这些文件中定义新内容元素的向导配置。
ext_localconf.php：
<?php// ... 其他配置// 引入PageTSConfigTYPO3CMSCoreUtilityExtensionManagementUtility::addPageTSConfig('');
Configuration/TsConfig/Page/All.tsconfig：
@import 'EXT:my_sitepackage_for_flipbox/Configuration/TsConfig/Page/ContentElements/*.tsconfig'
Configuration/TsConfig/Page/ContentElements/oneColumnFlipbox.tsconfig：
mod.wizards.newContentElement.wizardItems { common { elements { oneColumnFlipbox { iconIdentifier = content-dashboard title = 1 column flipbox description = one flipbox tt_content_defValues { CType = oneColumnFlipbox } } } show := addToList(oneColumnFlipbox) }}
2.6 数据处理器 (DataProcessor)
数据处理器允许您在将数据传递给Fluid模板之前对其进行操作。例如，下面的HeighleightProcessing.php用于代码高亮。
Classes/DataProcessing/HeighleightProcessing.php：
stdWrapValue('as', $processorConfiguration, 'bodytext_formatted'); $highlight = GeneralUtility::makeInstance(Highlighter::class); // 根据配置决定是否自动检测语言 if (!$processedData['data']['code_language']) { $languages = $highlight->listLanguages(); $highlight->setAutodetectLanguages($languages); $highlighted = $highlight->highlightAuto($processedData['data'][$fieldName]); } else { $highlighted = $highlight->highlight($processedData['data']['code_language'], $processedData['data'][$fieldName]); } $processedData[$targetVariableName]['code'] = $highlighted->value; $processedData[$targetVariableName]['language'] = $highlighted->language; $processedData[$targetVariableName]['lines'] = preg_split('/||/', $highlighted->value); return $processedData; }}
3. 前端渲染配置与常见陷阱
前端渲染是自定义内容元素最终在网站上显示的关键。这主要通过TypoScript配置和Fluid模板来实现。
3.1 TypoScript设置
在您的扩展的Configuration/TypoScript/setup.typoscript文件中，定义模板、局部模板和布局文件的路径，并注册您的内容元素。
Configuration/TypoScript/setup.typoscript：
############################################ Path ############################################# 引入内容元素和辅助TypoScript@import 'EXT:my_sitepackage_for_flipbox/Configuration/TypoScript/ContentElements/'@import 'EXT:my_sitepackage_for_flipbox/Configuration/TypoScript/Helper/'# 模板、局部模板、布局文件的路径lib.contentElement { templateRootPaths { 100 = EXT:my_sitepackage_for_flipbox/Resources/Private/Templates/ // 确保这里包含所有可能需要的模板路径 } partialRootPaths { 100 = EXT:my_sitepackage_for_flipbox/Resources/Private/Partials/ } layoutRootPaths { 100 = EXT:my_sitepackage_for_flipbox/Resources/Private/Layouts/ }}
在Configuration/TypoScript/ContentElements/oneColumnFlipbox.typoscript中，注册您的内容元素并指定其模板名称。
# 注册内容元素 oneColumnFlipboxtt_content { oneColumnFlipbox =< lib.contentElement oneColumnFlipbox { templateName = OneColumnFlipbox // 关键点：模板名称首字母大写 dataProcessing { 10 = B13MySitepackageForFlipboxDataProcessingHeighleightProcessing 10 { field = bodytext as = bodytext_formatted } } }}
3.2 问题诊断：模板文件未找到错误
当您在前端尝试显示自定义内容元素时，可能会遇到类似以下错误：
TYPO3FluidFluidViewExceptionInvalidTemplateResourceExceptionTried resolving a template file for controller action “Standard->oneColumnFlipbox” in format “.html”, but none of the paths contained the expected template file (Standard/OneColumnFlipbox.html). The following paths were checked: …
这个错误明确指出Fluid视图未能找到预期的模板文件。在TYPO3的fluid_styled_content上下文中，当您使用lib.contentElement来定义自定义内容元素时，Fluid会尝试根据templateName的值，结合默认的模板解析规则，来查找模板文件。
3.3 解决方案：Fluid模板命名约定
问题的根源在于Fluid的模板命名约定。当templateName被设置为oneColumnFlipbox（小写开头）时，Fluid默认会尝试寻找Standard/oneColumnFlipbox.html。然而，在许多TYPO3和Fluid的惯例中，尤其是当使用templateName属性时，期望的模板文件通常是PascalCase（首字母大写）的，并且直接位于templateRootPaths下，或者在ControllerName/ActionName.html的结构中。
正确的做法是：
将TypoScript中的templateName首字母大写。
# 注册内容元素 oneColumnFlipboxtt_content { oneColumnFlipbox =< lib.contentElement oneColumnFlipbox { templateName = OneColumnFlipbox // 修改为首字母大写 dataProcessing { 10 = B13MySitepackageForFlipboxDataProcessingHeighleightProcessing 10 { field = bodytext as = bodytext_formatted } } }}
确保您的模板文件也以首字母大写命名。在EXT:my_sitepackage_for_flipbox/Resources/Private/Templates/目录下，创建名为OneColumnFlipbox.html的模板文件。
示例模板文件 (Resources/Private/Templates/OneColumnFlipbox.html)：
{data.header}
{bodytext_formatted.code -> f:format.raw()}{data.bodytext}
Selected language: {data.code_language}
以上就是TYPO3自定义内容元素开发：模板解析错误与解决方案的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1322221.html
微信扫一扫
支付宝扫一扫
