TYPO3 cms-forms 如何从生成邮件中移除指定输入字段

TYPO3官方cms-forms（即系统自带form扩展）没有提供Powermail那种仅通过Typoscript配置即可排除邮件字段的开箱即用选项，在TYPO3 11.5.12 + PHP 8.1.2环境下，可根据实际场景选择以下方案实现同等效果：

该方法适合需要排除的字段固定、数量不多的场景：

• 不要直接修改form扩展核心文件，先把核心自带的邮件模板复制到你自己的主题/站点扩展对应目录下，需要复制的两个文件分别是HTML版邮件模板EXT:form/Resources/Private/Frontend/Templates/Finishers/Email/Html.html、纯文本版邮件模板EXT:form/Resources/Private/Frontend/Templates/Finishers/Email/Plain.html
• 在你自己的扩展中配置form的模板根路径，指向你复制后的模板目录
• 打开复制后的模板，找到遍历所有提交字段渲染的<f:for>代码块，在内部加条件判断，跳过你不需要出现在邮件里的字段，示例代码如下：

<f:for each="{form.formState.formValueElements}" as="formElement">
    <!-- 多个要排除的字段标识符用&&拼接即可 -->
    <f:if condition="{formElement.identifier} != 'datenschutzbestimmungen' && {formElement.identifier} != 'agb'">
        <!-- 保留模板原有的字段渲染逻辑，不要修改 -->
        <tr>
            <td style="padding: 5px; vertical-align: top;">{formElement.label}</td>
            <td style="padding: 5px; vertical-align: top;">
                <formvh:renderFormValue renderable="{formElement}" as="formValue">
                    <f:for each="{formValue.processedValue}" as="value">{value}<br></f:for>
                </formvh:renderFormValue>
            </td>
        </tr>
    </f:if>
</f:for>

• 纯文本版Plain.html做相同的条件判断修改即可，修改完成后清除TYPO3系统缓存立即生效。

如果有多个表单需要排除同类字段，不想在模板里硬编码字段标识符，可以用字段自定义属性的方式实现：

• 在表单配置YAML中，给所有不需要出现在邮件里的字段添加自定义属性，示例：

-
  type: Checkbox
  identifier: datenschutzbestimmungen
  label: 我已阅读并同意隐私政策
  properties:
    # 加这个自定义标记即可
    excludeFromEmail: true
-
  type: Checkbox
  identifier: agb
  label: 我已阅读并同意服务条款
  properties:
    excludeFromEmail: true

• 把模板里的硬编码判断改成读取自定义属性的逻辑，后续新建表单只要给对应字段加excludeFromEmail: true标记就会自动从邮件中排除，无需反复修改模板：

<f:for each="{form.formState.formValueElements}" as="formElement">
    <f:if condition="!{formElement.properties.excludeFromEmail}">
        <!-- 原有字段渲染逻辑保持不变 -->
    </f:if>
</f:for>

如果需要根据提交内容、用户权限等动态判断是否排除字段，可以编写自定义邮件Finisher：

• 继承核心的TYPO3\CMS\Form\Domain\Finishers\EmailFinisher类
• 重写组装邮件变量的相关方法，在遍历字段时按照自定义规则过滤掉不需要的字段，再将过滤后的字段列表传入模板
• 在表单YAML配置中用你自定义的Finisher替换默认的EmailFinisher即可
  该方案灵活性最高，但需要编写少量PHP代码，适合规则复杂的项目使用。

注意：所有自定义模板、代码都必须放在你自己的站点扩展/主题扩展中，不要直接修改form扩展的核心文件，否则后续核心版本升级会直接覆盖你的自定义修改。

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