passionweb / form-email-contentblocks
允许在电子邮件模板的开始处(介绍性文本)和/或结束处(电子邮件签名)添加内容元素。此外,还可以编辑流体电子邮件模板的背景颜色和标志。
Requires
- typo3/cms-core: ^12.4
- typo3/cms-form: ^12.4
Replaces
- typo3-ter/form-email-contentblocks: 2.1.4
README
允许在电子邮件模板的开始处(介绍性文本)和/或结束处(签名)添加内容元素。此外,还可以编辑流体电子邮件模板的背景颜色和标志。
功能
- 在接收者模板的电子邮件开始处添加内容元素
- 在发送者模板的电子邮件开始处添加内容元素
- 在接收者模板的电子邮件结束处添加内容元素
- 在发送者模板的电子邮件结束处添加内容元素
- 编辑发送者和接收者流体电子邮件模板的背景颜色和标志
安装
通过composer添加
composer require "passionweb/form-email-contentblocks"
- 通过composer安装扩展
- 刷新TYPO3和PHP缓存
此扩展做什么?
此扩展为TYPO3系统扩展“表单”(EXT:form)提供额外的完成器。为了使此扩展按预期工作,必须正确安装和配置该扩展。
从版本1.1.0开始,可以在内容元素中使用表单变量。
以下完成器可用
-
IntroductoryReceiverFinisher
(在接收者模板的电子邮件开始处添加内容元素) -
IntroductorySenderFinisher
(在发送者模板的电子邮件开始处添加内容元素) -
SignatureReceiverFinisher
(在接收者模板的电子邮件结束处添加内容元素) -
SignatureSenderFinisher
(在发送者模板的电子邮件结束处添加内容元素) -
ExtendFluidEmailFinisher
(编辑发送者和接收者流体电子邮件模板的背景颜色和标志(支持相对文件admin路径和扩展路径))
所有之前的完成器必须放在相关电子邮件完成器(EmailToSender
或EmailToReceiver
)之前。否则,相应的内容块将被忽略。同样也适用于ExtendFluidEmailFinisher变量。
对于每个完成器,相应的说明也将显示在各自完成器的标题中。
扩展配置(TypoScript)
所有必要的配置都通过ext_typoscript_setup.typoscript文件读取。
plugin.tx_form.settings.yamlConfigurations {
1673535916 = EXT:form_email_contentblocks/Configuration/Yaml/BaseSetup.yaml
}
module.tx_form.settings.yamlConfigurations {
1673535916 = EXT:form_email_contentblocks/Configuration/Yaml/BaseSetup.yaml
1673535917 = EXT:form_email_contentblocks/Configuration/Yaml/FormEditorSetup.yaml
}
编辑器如何/应该使用此扩展
- 创建新表单或编辑现有表单
- 添加您想要使用的完成器(并按正确顺序放置)
- 保存表单
将表单变量添加到内容元素中
从版本1.1.0开始,可以在内容元素或纯文本文本字段中使用表单变量。您可以使用它与完成器配置相同的方式使用它。
故障排除和日志记录
如果某事没有按预期工作,请首先查看日志文件。每个问题都会记录到TYPO3日志中(通常位于var/log/typo3_*.log
)。
如果在检查日志后仍发现某些功能无法按预期工作,请随时联系我。
重要提示
此扩展不会覆盖任何默认的EXT:form完成器类,因为它使用FinisherVariableProvider
对象在完成器之间共享变量。
但是,默认的电子邮件模板被覆盖了。如果您使用多个扩展覆盖EXT:form的默认电子邮件模板,可能会出现冲突。
共同实现更多或反馈,反馈,反馈
我对任何反馈都表示感谢!无论是改进建议、扩展请求,还是对扩展的好坏(建设性的)反馈。
请随时将您的反馈发送至service@passionweb.de或在Slack上联系我