用途:在 TYPO3 中构建和调试 Powermail 13+ 的联系与询盘表单,涵盖表单搭建、校验、条件字段(当另一答案满足条件时才显示)以及邮件投递排查。
主要能力:处理条件字段/页面、Jev 语义规则与收件人决策、邮件投递与模板、自定义校验、外部集成(finisher)、记录创建与本地化,以及整站升级时的发现汇总。Powermail 以 Form → Page → Field 和 Mail → Answer 记录存储数据,Powermail 页面是字段集,不一定是向导步骤。
版本与依赖:资料为 2026-09-26 快照。上游 Powermail 13.3.0 要求 PHP ^8.2、Core ^13.4;上游 powermail_cond 13.1.2 要求 PHP ^8.2、Core ^13.4、Powermail ^13.0 || @dev;dirnbauer Powermail 分支 tag 14.0.3.4 要求 PHP >=8.3 <8.6、Core ^14.3.6;dirnbauer powermail_cond 分支 typo3-v14 at fc5324f9 要求 PHP ^8.4、Core ^14.3、Powermail ^14.0。修改 Composer 前先核对版本证据与安装,优先使用更新的兼容 tag 并提交已审阅的 lockfile。
使用方式:先获取已安装的 Core/PHP 版本、两个包来源与 lock 引用、表单 UID、字段标记、语言、邮件传输和预期可见性规则,再选择示例。先引入随扩展提供的 TypoScript/站点集(v14 分支为 in2code/powermail-main 与 in2code/powermail-cond),再添加覆盖配置。示例覆盖:plugin.tx_powermail.settings.setup { receiver.overwrite.email = TEXT ... },注意许多值是 cObject,裸写 overwrite.email = address 与 TEXT 加 .value 不等价。
限制:不要将 Core EXT:form 的 YAML finisher 或其已移除 API 用于 In2code\Powermail\Finisher\AbstractFinisher。UI 可见性只是展示,不能替代服务端业务校验。不要用原始 SQL 播种记录。不要仅凭 HTTP 200 判断投递成功。未提供可运行项目夹具时应明确说明缺口,未执行的示例不能称为生产可用。测试需使用授权的本地邮件接收器,不得发送真实客户数据。