README

关于此扩展

TYPO3内置的配置选项非常出色，可以改变编辑器与内容交互的方式，几乎涵盖了我们在日常工作中遇到的所有用例。例如，更改全局TCA设置以轻松更改内容元素类型的后端表单，或为特定内容元素类型更改后端表单。仅通过覆盖全局TCA设置，就可以轻松更改某些元素，如字段标签，在TYPO3实例的特定部分（无论是您的页面树的一部分还是更大的页面树的一部分）中隐藏特定内容元素类型中的特定字段。

然而，有时您可能需要比TYPO3核心提供的更多选项。至少我们有时是这样的。为了处理高级用例，我们创建了（并使用）此扩展。

此扩展允许使用Page TsConfig为特殊用例启用高级配置选项。

此扩展的使用案例

更改字段的配置

有时您可能需要调整TYPO3页面树一部分的字段配置，例如在处理多站配置时。您可以使用以下方式更改header字段的配置

TCEFORM.tt_content.header.config.type = text
TCEFORM.tt_content.header.config.rows = 2

此操作仅适用于某些类型

TCEFORM.tt_content.header.types.my_example_type.config.type = text
TCEFORM.tt_content.header.types.my_example_type.config.rows = 3
TCEFORM.tt_content.header.types.my_example_type.config.cols = 25

更改内联字段的配置

根据您的前端设计，“元素组件1”可能包含一个图像和一些用于元数据的字段，如alt文本、标题文本、链接等。但是，对于页面树的一部分，该元素使用不同的前端模板，并且忽略了一些这些字段。编辑器可能会对不执行的“链接”字段感到困惑。以下是如何更改内联字段的showitem配置

TCEFORM.tt_content {
  image.types.component-1.config.overrideChildTca.types.2.showitem = --palette--;;basicImageoverlayPalette, --palette--;;filePalette
}

使用PageTS更改裁剪变体

我们维护使用公共模板和内容元素类型的多个TYPO3实例。我们通常为所有图像资源设置固定的裁剪变体，如果设计需要特定宽高比，则通常超过一个，具体取决于设计。

有时，我们有一个这样的模板包中的预告元素集，该元素图像的默认比例为4:3，但出于某种原因，两个基于该模板包构建的70个网站使用了略有不同的设计，并希望为该特定元素使用16:9的图像比例。

此扩展允许使用Page TsConfig更改可用的裁剪变体设置。

TCEFORM.tt_content.image.types.my_example_teaser.config.overrideChildTca.columns.crop.config.cropVariants {
  default {
    allowedAspectRatios.default.title = 16:9
    allowedAspectRatios.default.value = 1.77
    selectedRatio = default
  }
}

根据我们的用例，我们可以更改现有命名字段裁剪变体的设置，或添加一个新的裁剪变体——有时一开始并没有全局设置裁剪变体（我们使用PageTS设置所有内容），有时需要在部分上进行更改。

这同样适用于内联记录、它们的值以及相应的设置（tx_listelements_list是一个使用EXT:listelements创建的内联元素）

TCEFORM.tt_content {
  tx_listelements_list.types.timeline.config.overrideChildTca.columns.images.config.overrideChildTca.columns.crop.config.cropVariants {
    default.title = My new title
    allowedAspectRatios.1:1.title = 1:1
    allowedAspectRatios.1:1.value = 1
    selectedRatio = 1:1
  }
}

更改调色板配置

有时在页面树中的调色板内重新排列后端字段是有意义的，例如，因为这有助于编辑器更好地识别后端表单与前端设计之间的联系。可以使用页面TsConfig来更改调色板的设置。

# move the "media" field from example-palette-2 to example-palette-1
TCEFORM.tt_content {
  palettes.types.startpage-header.startpage-header-media.label = Custom palette title
  palettes.types.startpage-header.startpage-header-media.showitem = image, --linebreak--, media
  # an empty palette will not be shown at all
  palettes.types.startpage-header.startpage-header-media-desktop.showitem =
}

重要提示：虽然您可以通过这种方式调整字段顺序，但您不能完全添加字段。TCA showitem 配置确定哪些字段可用于您的后端表单；您可能需要根据您的用例全局添加字段、全局删除字段并启用特定页面树。

何时不使用此扩展

如果您想全局更改某些后端表单的设置，请始终将您的配置放在 TCA/Overrides 中！

致谢

此扩展由Benni Mack于2013年创建，并于2022年由David Steeb为斯图加特的b13 GmbH重新利用。

b13 / pagetsconfig

维护者

详细信息