如何为TYPO3 12.4.6的Image元素新增Subtitle字段至sys_file_reference

问题描述 #

使用TYPO3 12.4.6版本，希望在现有Image元素的Title旁新增一个Subtitle输入字段，并将该字段数据存储到sys_file_reference表中。此前尝试使用ExtensionManagementUtility::addTCAcolumns和ExtensionManagementUtility::addToAllTCAtypes方法未成功，原有代码如下：

<?php

defined('TYPO3') or die();

$fields = [
    'subtitle' => [
        'label' => 'Subtitle',
        'config' => [
            'type' => 'input',
            'eval' => 'trim'
        ]
    ]
];


\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addTCAcolumns('sys_file_reference', $fields);

\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addToAllTCAtypes(
    'sys_file_reference',
    'subtitle',
    '',
    'before:crop'
);

解决方案 #

TYPO3 12+中，Image元素的属性界面依赖sys_file_reference的特定调色板（imageoverlayPalette），直接使用addToAllTCAtypes无法将字段添加到Image元素的属性区域，需通过以下步骤实现：

1. 添加数据库字段 #

首先在扩展的ext_tables.sql文件中添加对应的数据库字段：

CREATE TABLE sys_file_reference (
    subtitle varchar(255) DEFAULT '' NOT NULL
);

2. 修改TCA配置 #

在扩展的Configuration/TCA/Overrides/sys_file_reference.php文件中，将字段添加到Image元素使用的调色板中：

<?php
defined('TYPO3') or die();

// 为sys_file_reference添加Subtitle字段的TCA配置
$fields = [
    'subtitle' => [
        'label' => 'Subtitle', // 可替换为语言标签，如LLL:EXT:your_extension/Resources/Private/Language/locallang_db.xlf:sys_file_reference.subtitle
        'config' => [
            'type' => 'input',
            'eval' => 'trim',
            'max' => 255,
        ]
    ]
];
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addTCAcolumns('sys_file_reference', $fields);

// 将Subtitle字段添加到Image元素的属性调色板，放在Title字段之后
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addFieldsToPalette(
    'sys_file_reference',
    'imageoverlayPalette',
    'subtitle',
    'after:title'
);

说明 #

• imageoverlayPalette是TYPO3默认Image元素属性界面使用的调色板，将字段添加到这个调色板后，会自动显示在Image元素的Title字段旁边。
• 替换代码中的your_extension为你的扩展键，若使用语言标签需确保对应语言文件存在。

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