TYPO3 11.5.23自定义CType未在下拉菜单正常显示求助

你遇到的问题核心是：仅将CType添加到下拉选项列表，但未在TCA的types数组中注册该CType的配置，TYPO3无法识别未注册的CType，因此抛出无效值错误。

解决步骤 #

1. 补充CType的TCA注册配置
   在你的Configuration/TCA/Overrides/tt_content.php文件中，除了现有的addTcaSelectItem代码外，还需要添加该CType的字段配置，告诉TYPO3如何渲染这个内容元素：

// Add the content element to the "Type" dropdown
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addTcaSelectItem(
    'tt_content',
    'CType',
    [
        'Titel',
        'personal_titel',
        'content-text',
    ],
    'textmedia',
    'after'
);

// 注册personal_titel对应的TCA配置
$GLOBALS['TCA']['tt_content']['types']['personal_titel'] = [
    'showitem' => '
        --div--;LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:general,
            --palette--;;general,
            header;LLL:EXT:frontend/Resources/Private/Language/locallang_ttc.xlf:header.ALT.html_formlabel,
        --div--;LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:appearance,
            --palette--;;frames,
            --palette--;;appearanceLinks,
        --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:access,
            --palette--;;hidden,
            --palette--;;access,
        --div--;LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:categories,
            categories,
        --div--;LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:notes,
            rowDescription,
        --div--;LLL:EXT:core/Resources/Private/Language/Form/locallang_tabs.xlf:extended,
    ',
    // 可选：覆盖特定字段的配置
    'columnsOverrides' => [
        'header' => [
            'label' => '自定义标题',
            // 推荐使用语言文件：'label' => 'LLL:EXT:personal/Resources/Private/Language/locallang_db.xlf:tt_content.header.personal_titel',
        ],
    ],
];

2. 清理TYPO3缓存
   修改TCA配置后，必须清理TYPO3的配置缓存和页面缓存：

• 进入TYPO3后台的「系统」模块
• 点击「清除全部缓存」按钮

3. （可选）配置多语言标签
   为了让CType名称支持多语言，建议将硬编码的'Titel'替换为语言文件引用：

// 替换下拉选项中的名称
[
    'LLL:EXT:personal/Resources/Private/Language/locallang_db.xlf:tt_content.CType.personal_titel',
    'personal_titel',
    'content-text',
],

然后在你的扩展Resources/Private/Language/locallang_db.xlf中添加对应标签：

<trans-unit id="tt_content.CType.personal_titel">
    <source>Titel</source>
</trans-unit>

核心原理 #

TYPO3需要知道每个CType对应的字段集合（showitem）才能正确渲染内容元素，仅添加下拉选项不会自动注册该CType的有效配置，因此会触发无效值错误。

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