# TYPO3 Powermail 开发 > **兼容性：** TYPO3 v13.x 和 v14.x 与 Powermail 13.x 所有代码示例都针对 PHP 8.2+ 和 TYPO3 v13/v14。 > **TYPO3 API First：** 在创建自定义实现之前，始终使用 TYPO3 的内置 API、核心功能和既定约定。不要重新发明 TYPO3 已经提供的内容。请务必通过检查官方 TYPO3 文档来验证您使用的 API 和方法是否存在，并且在您的目标 TYPO3 版本（v13 或 v14）中未弃用。 > **补充：** > > * [SKILL-CONDITIONS.md]() \- 条件字段/页面可见性 (powermail_cond) > * [SKILL-PHP84.md]() \- PHP 8.4 模式（属性挂钩、不对称可见性、新数组函数） > * [SKILL-EXAMPLES.md]() \- 具有奥地利法律类型的多步骤商店表单，DDEV SQL + DataHandler CLI > ## 1\.架构概述 ### 领域模型层次结构表单（tx_powermail_domain_model_form） └── 页面 (tx_powermail_domain_model_page) └── 字段（tx_powermail_domain_model_field）邮件（tx_powermail_domain_model_mail） └── 答案 (tx_powermail_domain_model_answer) └── 参考文献领域 ### 插件注册 * **Pi1**（缓存/未缓存）：`form`、`create`、`confirmation`、`optinConfirm`、`免责声明` * **Pi5**（未缓存）：“营销”（AJAX 跟踪） ### 作曲家作曲家需要 in2code/powermail 需要：PHP ^8.2、TYPO3 ^13.4、ext-json、ext-gd、ext-fileinfo、ext-curl ## 2\.字段类型类型 |关键|值类型 |注释 ---|---|---|--- 文字| `输入` |文本 (0) |标准输入文本区域 | `文本区域` |文本 (0) |多线选择 | `选择` |文本/数组 (0/1) |可以进行多选复选框 | `检查` |阵列 (1) |多个值广播 | `收音机` |文本 (0) |单选提交 | `提交` | — |表单提交按钮验证码 | `验证码` |文本 (0) |内置验证码重置 | `重置` | — |表单重置按钮静态文本| `文本` | — |仅显示内容元素| `内容` | — | CE参考 HTML | `html` |文本 (0) |原始 HTML 密码 | `密码` |密码 (4) |哈希存储文件上传 | `文件` |上传 (3) |文件附件隐藏 | `隐藏` |文本 (0) |隐藏输入日期 | `日期` |日期 (2) |日期选择器国家 | `国家` |文本 (0) |国家/地区选择器地点 | `位置` |文本 (0) |地理定位打字稿 | `打字稿` |文本 (0) | TS 生成的内容 ### 答案值类型答案::VALUE_TYPE_TEXT = 0; // 字符串值答案::VALUE_TYPE_ARRAY = 1; // JSON 编码的数组（复选框、多选）答案::VALUE_TYPE_DATE = 2; // 时间戳答案::VALUE_TYPE_UPLOAD = 3; // 文件引用答案::VALUE_TYPE_PASSWORD = 4; // 哈希密码 ## 3\. TypoScript 配置 ### 基本设置插件.tx_powermail { 设置{ 设置{ # 表单设置主要{ pid = {$plugin.tx_powermail.settings.main.pid} 表单 = {$plugin.tx_powermail.settings.main.form} 确认=0 选择=0 更多步= 0 } # 接收邮件接收器{ 启用 = 1 主题 = 来自 {firstname} {lastname} 的邮件 body = 来自您网站的新邮件发件人姓名字段 = 名字发件人电子邮件字段 = 电子邮件 # 覆盖接收者：receiver.overwrite.email = admin@example.com # 附加上传内容：receiver.attachment = 1 # 添加抄送：receiver.overwrite.cc = copy@example.com } # 发件人确认邮件发件人{ 启用 = 1 主题=感谢您的留言 body = 我们收到您提交的内容发件人姓名 = 网站发件人电子邮件=noreply@example.com } # 双重选择加入选择{ 主题 = 请确认您的提交发件人姓名 = 网站发件人电子邮件=noreply@example.com } # 感谢页面谢谢{ redirect = # 提交后重定向的页面UID } # 垃圾邮件防护垃圾邮件屏蔽{ _启用= 1 指标{ 蜜荚 = 5 链接=3 姓名 = 3 会话 = 1 唯一= 2 黑名单字符串 = 7 黑名单IP = 7 速率限制 = 10 } # 因子阈值（0-100）：如果 >= 则拒绝系数 = 75 } # 验证杂项{ htmlForLabels = 1 仅显示填充值 = 1 ajax提交 = 0 文件{ 文件夹=上传/tx_powermail/ 大小 = 25000000 扩展名 = jpg、jpeg、gif、png、tif、txt、doc、docx、xls、xlsx、ppt、pptx、pdf、zip、csv、svg } } } } } ### 通过 TypoScript 预填充字段插件.tx_powermail.settings.setup.prefill { # 通过字段标记电子邮件=文本 email.data = TSFE:fe_user|用户|电子邮件名字 = 文本名字.data = TSFE:fe_user|用户|名字 # 从 GET/POST 预填充主题=文本主题.数据 = GP:主题 } ### 营销信息插件.tx_powermail.settings.setup.marketing { 启用 = 1 # 跟踪：refererDomain、referer、国家、mobileDevice、frontendLanguage、browserLanguage、pageFunnel } ## 4\.定制整理器成功提交表单后运行整理程序，按 TypoScript 键排序。 ### 注册插件.tx_powermail.settings.setup.finishers { # 较小的数字 = 首先运行 0.class = In2code\Powermail\Finisher\RateLimitFinisher 10.class = In2code\Powermail\Finisher\SaveToAnyTableFinisher 20.class = In2code\Powermail\Finisher\SendParametersFinisher 100.class = In2code\Powermail\Finisher\RedirectFinisher # 自定义整理器 50.class = 供应商\MyExt\Finisher\CrmFinisher 50.配置{ apiUrl = https://crm.example.com/api apiKey = 秘密123 } } ### 创建自定义整理器 getMail(); $settings = $this->getSettings(); $configuration = $this->getConfiguration(); // TS 配置。* // 访问表单答案 foreach ($mail->getAnswers() as $answer) { $fieldMarker = $answer->getField()->getMarker(); $value = $answer->getValue(); // 处理... } // 通过标记访问 $answers = $mail->getAnswersByFieldMarker(); $email = $answers['email'] ??无效的; // 检查表单是否实际提交（不仅仅是显示） if (!$this->isFormSubscribed()) { 返回； } } } ### 内置整理器班级 |关键|目的 ---|---|--- `RateLimitFinisher` | 0 |消耗速率限制器令牌 `SaveToAnyTableFinisher` | 10 | 10将答案保存到自定义数据库表 `SendParametersFinisher` | 20 | POST 表单数据到外部 URL `重定向完成器` | 100 | 100提交后重定向 ### SaveToAnyTable 配置插件.tx_powermail.settings.setup.dbEntry { 1 { _启用=文本 _enable.value = 1 _表 = fe_users _ifUnique.email = 更新 # 更新|跳过|无用户名.值 = {电子邮件} 电子邮件.值 = {电子邮件} 名字.值 = {名字} 姓氏.值 = {姓氏} pid.值 = 123 } } ## 5\.自定义验证器 ### 创建自定义验证器（PSR-14 事件） getMail(); $field = $event->getField(); // 通过标记验证特定字段 if ($field->getMarker() === 'company_vat') { $答案=空； foreach ($mail->getAnswers() as $a) { if ($a->getField()?->getUid() === $field->getUid()) { $答案=$a；休息; } } if ($answer !== null && !$this->isValidVat((string)$answer->getValue())) { $event->setIsValid(false); $event->setValidationMessage('无效的增值税号'); } } } 私有函数 isValidVat(string $vat): bool { return (bool)preg_match('/^[A-Z]{2}\d{8,12}$/', $vat); } } ### 内置验证器验证者|目的 ---|--- `输入验证器` |电子邮件、URL、电话、号码、字母、最小/最大长度、正则表达式 `上传验证器` |文件大小、扩展名白名单 `密码验证器` |密码匹配和强度 `验证码验证器` |内置验证码 `SpamShieldValidator` |多方法垃圾邮件检测 `唯一验证器` |唯一字段值 `ForeignValidator` |根据外部表进行验证 `自定义验证器` |基于 TypoScript 的自定义规则 ### 垃圾邮件屏蔽方法方法|重量 |描述 ---|---|--- `HoneyPod 方法` | 5 |隐藏的蜜罐场 `链接方法` | 3 |过多链接检测 `名称方法` | 3 |可疑的名字模式 `会话方法` | 1 |会话令牌验证 `独特的方法` | 2 |重复提交检查 `值黑名单方法` | 7 |列入黑名单的内容 `IpBlacklistMethod` | 7 |列入黑名单的 IP 地址 `RateLimitMethod` | 10 | 10请求速率限制 ## 6\. PSR-14 事件 ### 表单生命周期事件 // 表单渲染之前表单控制器表单操作事件 // 确认页面之前表单控制器确认操作事件 // 邮件保存到数据库后 FormControllerCreateActionAfterMailDbSavedEvent // 提交视图构建后 FormControllerCreateActionAfterSubmitViewEvent // 在渲染最终视图之前 FormControllerCreateActionBeforeRenderViewEvent // 控制器初始化表单控制器初始化对象事件 ### 邮件活动 // 修改收件人邮箱地址 ReceiverMailReceiverPropertiesServiceSetReceiverEmailsEvent // 修改接收者名称 ReceiverMailReceiverPropertiesServiceGetReceiverNameEvent // 修改发件人邮箱（收件人邮件） ReceiverMailSenderPropertiesGetSenderEmailEvent // 修改发件人姓名（收件人邮件） ReceiverMailSenderPropertiesGetSenderNameEvent // 修改发件人邮箱（确认邮件） SenderMailPropertiesGetSenderEmailEvent // 修改发件人姓名（确认邮件） SenderMailPropertiesGetSenderNameEvent // 发送前修改邮件正文 SendMailServiceCreateEmailBodyEvent // 发送电子邮件之前（最后一次修改机会） SendMailService准备和发送事件 ### 其他活动 // 控制邮件是否保存到数据库检查邮件是否允许保存事件 // 自定义验证逻辑自定义验证器事件 // 预填充字段值 PrefillFieldViewHelperEvent 预填充MultiFieldViewHelperEvent // 文件上传处理上传服务预检事件上传服务获取文件事件获取新路径和文件名事件 // 密码被哈希之前 MailFactoryBeforePasswordIsHashedEvent 事件 // 修改邮件变量/标记 MailRepositoryGetVariablesWithMarkersFromMailEvent // 验证数据属性 ValidationDataAttributeViewHelperEvent // 双重选择加入确认 FormControllerOptinConfirmActionAfterPersistEvent FormControllerOptinConfirmActionBeforeRenderViewEvent // 免责声明/取消订阅 FormControllerDisclaimerActionBeforeRenderViewEvent ### 示例：修改收件人电子邮件 getMail(); $answers = $mail->getAnswersByFieldMarker(); // 根据表单字段路由到部门 $部门 = $answers['部门'] ??无效的; if ($department !== null) { $value = (string)$department->getValue(); $emails = 匹配 ($value) { '销售' => ['sales@example.com'], '支持' => ['support@example.com'], 默认 => $event->getReceiverEmails(), }; $event->setReceiverEmails($emails); } } } ### 示例：阻止数据库保存 getMail()->getForm(); if ($form !== null && $form->getTitle() === '联系人（无存储）') { $event->setSavingOfMailAllowed(false); } } } ## 7\.电子邮件模板 ### 模板路径 (TypoScript) 插件.tx_powermail { 查看{ 模板根路径{ 0 = EXT:powermail/资源/私人/模板/ 10 = EXT:my_ext/资源/私人/模板/Powermail/ } 部分根路径{ 0 = EXT:powermail/资源/私人/部分/ 10 = EXT:my_ext/资源/私人/部分/Powermail/ } 布局根路径{ 0 = EXT:powermail/资源/私人/布局/ 10 = EXT:my_ext/资源/私人/布局/Powermail/ } } } ### 关键模板模板|目的 ---|--- `表单/Form.html` |主窗体渲染 `表格/确认.html` |确认页面 `表单/Create.html` |感谢页面 `邮件/ReceiverMail.html` |管理员通知电子邮件 `Mail/SenderMail.html` |用户确认电子邮件 `邮件/OptinMail.html` |双重选择加入电子邮件 `Form/PowermailAll.html` |全领域总结 ### 字段部分通过复制部分内容来覆盖各个字段类型：部分/表单/字段/Input.html 部分/表单/字段/Textarea.html 部分/表单/字段/Select.html 部分/表单/字段/Check.html 部分/表单/字段/Radio.html 部分/表单/字段/File.html 部分/表单/字段/Date.html 部分/表单/字段/Captcha.html 部分/表单/字段/Hidden.html 部分/表单/字段/Password.html Partials/Form/Field/Country.html 部分/表单/字段/Location.html 部分/表单/字段/Html.html 部分/表单/字段/Content.html 部分/表单/字段/Typoscript.html 部分/表单/字段/Submit.html 部分/表单/字段/Reset.html ### 邮件模板中的可用变量 {mail} {mail.senderName} {mail.senderMail} {mail.form.title} {mail.answers} {answer.field.title}：{answer.value} {powermail_all} ## 8\.关键视图助手 ### 验证 ### 表单字段 ### 预填充 ### 条件有价值是数组文件可用 ### 后端编辑 ## 9\. AJAX 表单提交插件.tx_powermail.settings.setup.misc.ajaxSubmit = 1 启用后，表单提交通过 AJAX 处理，无需重新加载页面。响应将表单容器替换为感谢内容。 ## 10\.双重选择加入插件.tx_powermail.settings.setup.main.optin = 1 插件.tx_powermail.settings.setup.optin { 主题 = 请确认您的提交发件人姓名 = 我的网站发件人电子邮件=noreply@example.com } 流程： 1. 用户提交表单 2. 邮件以“hidden=1”保存 3. 发送带有确认链接的选择加入电子邮件（受 HMAC 保护） 4. 用户点击链接 -> `optinConfirmAction` 取消隐藏邮件 5. 确认后发送收件人邮件 ## 11\.后端模块 Powermail在**Web > Powermail**下提供了一个后端模块： * **列表** : 浏览/过滤/搜索提交的邮件 * **导出** : CSV 和 Excel (PhpSpreadsheet) 导出 * **报告**：形成分析和营销图表 * **系统检查**：验证配置（仅限管理员） ### 实时搜索直接从 TYPO3 搜索栏搜索邮件和表格： * `#mail:searchterm` \- 在邮件中搜索 * `#form:searchterm` \- 在表单中搜索 ## 12\.扩展最佳实践 ### 注册服务 (Services.yaml) 服务：供应商\MyExt\EventListener\CrmSyncListener：标签： - 名称：事件监听器标识符：'vendor-myext/crm-sync' 或者使用“#[AsEventListener]”属性（在 TYPO3 v13+ 中首选）。 ### 高效访问邮件答复 // 按字段标记（最常见） $answers = $mail->getAnswersByFieldMarker(); $email = $answers['email']?->getValue(); // 通过字段 UID $answers = $mail->getAnswersByFieldUid(); // 按值类型过滤 $uploads = $mail->getAnswersByValueType(Answer::VALUE_TYPE_UPLOAD); ### 邮件对象的自定义数据 // 添加自定义数据（在所有完赛者/事件中可用） $mail->addAdditionalData('crm_id', $crmResponse['id']); // 在另一个终结者/事件中检索 $crmId = $mail->getAdditionalData()['crm_id'] ??无效的; ### 速率限制 Powermail 使用 Symfony RateLimiter。在“ext_conf_template.txt”或扩展设置中配置。 ### 垃圾收集 Powermail 自动注册邮件和答案的垃圾收集（默认值：30 天）。通过调度程序任务“TableGarbageCollectionTask”进行配置。 ## 13\.常见食谱 ### SEO 友好 URL 的路由增强器路线增强器： Powermail 选择加入：类型：插件路由路径：'/optin/{mail}/{hash}' 命名空间：'tx_powermail_pi1' 要求：邮件：'\d+' 哈希：'[a-zA-Z0-9]+' ### 基于表单字段的条件接收器使用“ReceiverMailReceiverPropertiesServiceSetReceiverEmailsEvent”（请参阅第 6 节）。 ### 自定义垃圾邮件屏蔽方法 getMail(); // 如果检测到垃圾邮件则返回 true 返回 $this->callExternalApi($mail); } } 在 TypoScript 中注册： plugin.tx_powermail.settings.setup.spamshield.methods { 100 { 类 = Vendor\MyExt\SpamShield\ApiCheckMethod _启用= 1 配置{ apiUrl = https://spam-api.example.com } } } ### 使用 TypoScript 生成的字段扩展表单 plugin.tx_powermail.settings.setup.manipulateVariablesInPowermailAllMarker { 时间戳 = 文本时间戳.数据 = 日期:U 时间戳.strftime = %Y-%m-%d %H:%M:%S } ## 14\.数据库结构 > **条件表：** 请参阅 [SKILL-CONDITIONS.md]() 第 12 节了解“tx_powermailcond_*”表。 ### TYPO3 标准列所有 powermail 表都包含这些 TYPO3 管理的列（下表未列出）：专栏 |类型 |目的 ---|---|--- `uid` | int 自动增量 |主键 `pid` |整数 |存储页面UID `tstamp` |整数 |最后修改时间戳 `crdate` |整数 |创建时间戳 `已删除` |微小的 |软删除标志 `隐藏` |微小的 |可见性标志 `sys_language_uid` |整数 |语言 UID（0 = 默认，-1 = 全部） `l10n_parent` |整数 |默认语言记录的UID `l10n_diffsource` |中等斑点 |翻译的差异源 `开始时间` |整数 |发布开始（Unix 时间戳） `结束时间` |整数 |发布结束（Unix时间戳） ### tx_powermail_domain_model_form 专栏 |类型 |描述 ---|---|--- `标题` | varchar(255) | varchar(255) |表格标题 `注意` |微小的 |后端注释渲染器（内部） `CSS` | varchar(255) | varchar(255) |表单包装器的 CSS 类 `页面` | varchar(255) | varchar(255) | IRRE 子项计数或元素浏览器列表 `autocomplete_token` | varchar(3) | varchar(3) |自动完成开/关/空 `is_dummy_record` |微小的 |测试记录标志 **索引：** `语言 (l10n_parent, sys_language_uid)` ### tx_powermail_domain_model_page 专栏 |类型 |描述 ---|---|--- `表格` |整数 |父表单 UID `标题` | varchar(255) | varchar(255) |页面/步骤标题 `CSS` | varchar(255) | varchar(255) |字段集的 CSS 类 `字段` |整数 | IRRE 儿童计数 `排序` |整数 |表单内的排序顺序 **索引：**`parent_form（表单）`、`语言（l10n_parent、sys_language_uid）` ### tx_powermail_domain_model_field 专栏 |类型 |描述 ---|---|--- `页面` |整数 |父页面UID `标题` | varchar(255) | varchar(255) |字段标签 `类型` | varchar(255) | varchar(255) |字段类型键（输入、选择、检查...） `设置` |文字|选择/单选/检查选项（每行一个） `路径` | varchar(255) | varchar(255) |文件路径参考 `内容元素` |整数 |类型 = 内容的 CE 参考 `文本` |文字| type=text 的静态文本 `预填充值` |文字|默认/预填充值 `占位符` |文字|占位符文本 `占位符_重复` |文字|重复字段的占位符（密码） `从打字脚本创建` |文字| Type=typoscript 的 TypoScript `验证` |整数 |验证类型（0=无，1=电子邮件，...） `验证配置` | varchar(255) | varchar(255) |用于验证的正则表达式或配置 `CSS` | varchar(255) | varchar(255) |字段包装器的 CSS 类 `描述` | varchar(255) | varchar(255) |帮助文本/描述 `多选` |微小的 |允许多选 `datepicker_settings` | varchar(255) | varchar(255) |日期选择器格式 `feuser_value` | varchar(255) | varchar(255) |从 fe_user 属性预填充 `发件人电子邮件` |微小的 |该字段是发件人电子邮件 `发件人名称` |微小的 |该字段是发件人姓名 `强制` |微小的 |必填字段 `own_marker_select` |微小的 |启用自定义标记 `标记` | varchar(255) | varchar(255) |字段标记（变量名） `强制文本` | varchar(255) | varchar(255) |自定义强制错误文本 `autocomplete_token` | varchar(20) | varchar(20)自动完成属性 `自动完成部分` | varchar(100) | varchar(100) |自动完成部分 `自动完成类型` | varchar(8) | varchar(8) |自动完成类型 `自动完成_目的` | varchar(8) | varchar(8) |自动完成目的 `排序` |整数 |页面内排序顺序 **索引：**`parent_page（页面）`，`语言（l10n_parent，sys_language_uid）` ### tx_powermail_domain_model_mail 专栏 |类型 |描述 ---|---|--- `发件人名称` | varchar(255) | varchar(255) |提交者姓名 `发件人邮件` | varchar(255) | varchar(255) |提交者电子邮件 `主题` | varchar(255) | varchar(255) |邮件主题 `receiver_mail` | varchar(1024) | varchar(1024)收件人电子邮件 `身体` |文字|邮件正文 (RTE) ` 火炉` |整数 |前端用户 UID（如果已登录） `sender_ip` |微小文本 |提交者IP地址 `用户代理` |文字|浏览器用户代理 `时间` |整数 |提交时间戳 `表格` |整数 |源表单 UID `答案` |整数 | IRRE 儿童计数 `垃圾邮件因素` | varchar(255) | varchar(255) |垃圾邮件分数 `marketing_referer_domain` |文字| HTTP 引用域 `marketing_referer` |文字|完整的 HTTP 引用地址 `营销国家` |文字|参观者国家 `营销移动设备` |微小的 |移动设备标志 `营销前端语言` |整数 |前端语言UID `营销浏览器语言` |文字|浏览器接受语言 `营销页面漏斗` |文字|提交前访问过的页面 **索引：** `form（形式）`、`feuser（熔炉）` ### tx_powermail_domain_model_answer 专栏 |类型 |描述 ---|---|--- `邮件` |整数 |父邮件 UID `价值` |文字|答案值（数组的 JSON） `值类型` |整数 | 0=文本、1=数组、2=日期、3=上传、4=密码 `场` |整数 |源字段 UID **索引：** `mail(邮件)`、`deleted(已删除)`、`hidden(隐藏)`、`language(l10n_parent, sys_language_uid)` ### ER 图（关系） tx_powermail_domain_model_form │ 1 ├──── * tx_powermail_domain_model_page（通过表单进行IRRE） │ │ 1 │ └──── * tx_powermail_domain_model_field（通过页面IRRE） │ │ │ │ 引用者 │ ▼ │ tx_powermail_domain_model_answer.field │ └──── * tx_powermail_domain_model_mail（通过表单） │ 1 └──── * tx_powermail_domain_model_answer（通过邮件IRRE） ## 15\.工作空间支持 Powermail 记录（表单、页面、字段）完全支持 TYPO3 工作区。安装 EXT:workspaces 后，编辑人员可以在工作区中起草表单更改并在审核后发布。 **要点：** * 所有 powermail 表都获得 `t3ver_wsid`、`t3ver_oid`、`t3ver_state`、`t3ver_stage` 列 * `t3ver_wsid > 0` 的记录是草稿（在实时前端中不可见） * 使用 **DataHandler** 进行工作区操作 - 它自动处理版本控制 * 原始 SQL 需要在每个 INSERT 上手动设置所有 `t3ver_*` 列 * 条件 (powermail_cond) 必须与表单位于 **同一工作区** **工作区生命周期：** 1. **在工作区中创建**记录 → `t3ver_wsid = `, `t3ver_state = 1` 2. **审核阶段** → `t3ver_stage = 1` 3. **通过后端模块或 CLI 发布** → 记录生效 (`t3ver_wsid = 0`) > **详细的 SQL 和 DataHandler 示例：** 请参阅 [SKILL-EXAMPLES.md]() 了解完整的工作区感知查询、发布工作流程和 CLI 选项。 ## 16\.翻译（本地化） Powermail 支持完整的 TYPO3 本地化。可以翻译表单结构（表单、页面、字段），以便编辑者看到本地化的标签、设置和选项。提交的邮件继承前端语言。 ### 翻译是如何运作的水平|翻译了什么 |关键栏目 ---|---|--- 表格 |标题 | `sys_language_uid`、`l10n_parent` 页 |标题（步骤标题）| `sys_language_uid`、`l10n_parent` 领域|标题、设置、占位符、强制文本、说明 | `sys_language_uid`、`l10n_parent` 邮件 |从前端自动存储为“sys_language_uid” | `sys_language_uid` 回答 |与提交语言一起存储 | `sys_language_uid` ### 翻译规则 * `sys_language_uid = 0` 是**默认语言**（例如英语） * `sys_language_uid = 1`（或更高）是翻译（例如德语） * `l10n_parent` 指向默认语言记录UID * `marker` 字段**未翻译** \-- 标记在不同语言中保持相同 * 字段 `type` **未翻译** \-- 结构是共享的 * 字段“设置”（选择/单选选项）**已翻译** \-- 选项标签随语言而变化 ### 示例：用英语创建表单，翻译为德语 #### 默认语言（英语，sys_language_uid=0） -- 表格插入 tx_powermail_domain_model_form（pid、标题、sys_language_uid、l10n_parent） VALUES (1, '联系表格', 0, 0); -- 假设 UID = 10 -- 页面插入 tx_powermail_domain_model_page（pid、表单、标题、排序、sys_language_uid、l10n_parent） VALUES (1, 10, '您的详细信息', 1, 0, 0); -- 假设 UID = 20 -- 字段插入 tx_powermail_domain_model_field （pid、页面、标题、类型、标记、强制、发件人名称、排序、sys_language_uid、l10n_parent）价值观 (1, 20, '名字', '输入', '名字', 1, 1, 1, 0, 0), -- UID 30 (1, 20, '姓氏', '输入', '姓氏', 1, 0, 2, 0, 0), -- UID 31 (1, 20, '电子邮件', '输入', '电子邮件', 1, 0, 3, 0, 0), -- UID 32 (1, 20, '消息', '文本区域', '消息', 0, 0, 4, 0, 0), -- UID 33 (1, 20, '主题', '选择', '主题', 1, 0, 5, 0, 0), -- UID 34 (1, 20, '发送', '提交', '提交', 0, 0, 6, 0, 0); -- UID 35 -- 选择主题选项（英语）更新 tx_powermail_domain_model_field SET 设置 = '一般查询\n支持请求\n合作\n其他' 其中 uid = 34； -- 将电子邮件字段标记为sender_email 更新 tx_powermail_domain_model_field SET sender_email = 1 WHERE uid = 32; #### 德语翻译 (sys_language_uid=1) -- 表格翻译（l10n_parent = 10，英文表格）插入 tx_powermail_domain_model_form（pid、标题、sys_language_uid、l10n_parent） VALUES (1, '联系公式', 1, 10); -- 页面翻译 (l10n_parent = 20) 插入 tx_powermail_domain_model_page （pid、表单、标题、排序、sys_language_uid、l10n_parent） VALUES (1, 10, 'Ihre Daten', 1, 1, 20); -- 字段翻译（l10n_parent 指向英文字段 UID）插入 tx_powermail_domain_model_field （pid、页面、标题、类型、标记、强制、发件人名称、排序、sys_language_uid、l10n_parent）价值观 (1, 20, '姓名', '输入', '名字', 1, 1, 1, 1, 30), (1, 20, '名字', '输入', '姓氏', 1, 0, 2, 1, 31), (1, 20, '电子邮件地址', '输入', '电子邮件', 1, 0, 3, 1, 32), (1, 20, '新闻', '文本区域', '消息', 0, 0, 4, 1, 33), (1, 20, '贝特雷夫', '选择', '主题', 1, 0, 5, 1, 34), (1, 20, '缺席', '提交', '提交', 0, 0, 6, 1, 35); -- 德语选择主题选项更新 tx_powermail_domain_model_field SET 设置 = 'Allgemeine Anfrage\nSupportanfrage\nPartnerschaft\nSonstiges' 其中 sys_language_uid = 1 且 l10n_parent = 34； -- 将电子邮件字段标记为sender_email（也必须在翻译时设置）更新 tx_powermail_domain_model_field 设置发件人电子邮件 = 1 其中 sys_language_uid = 1 且 l10n_parent = 32； ### 通过 DataHandler 进行翻译 start([], []); // 将表单 (UID 10) 本地化为德语 (sys_language_uid=1) $cmdMap = [ 'tx_powermail_domain_model_form' => [ 10 => [ 'localize' => 1, // 目标语言 UID ], ], ]; $dataHandler->start([], $cmdMap); $dataHandler->process_cmdmap(); // DataHandler 自动创建所有 IRRE 子项（页面 + 字段）的翻译 // 然后更新翻译后的标题： $translatedFormUid = $dataHandler->copyMappingArray_merged['tx_powermail_domain_model_form'][10] ??无效的; 如果（$translatedFormUid）{ $数据 = [ 'tx_powermail_domain_model_form' => [ $translatedFormUid => [ 'title' => '联系公式', ], ], ]; $dataHandler->start($data, []); $dataHandler->process_datamap(); } ### 重要翻译注释 * **标记与语言无关。** 标记“email”在所有语言中都保持为“email”。 * **IRRE 本地化：** 当您通过 DataHandler（`localize` 命令）本地化表单时，TYPO3 会自动为所有子页面和字段创建翻译。 * **选择选项：** `设置` 字段（选择/单选/检查选项） **必须** 单独翻译 - 选项值应该匹配（用于条件评估），但标签可以不同。 * **提交的邮件：** 邮件从前端上下文存储“sys_language_uid”。无论提交语言如何，答案都会引用默认语言字段 UID。 * **后端模块：** 邮件列表显示所有语言的邮件。如果需要，按语言过滤。 ## 17\.完整示例：带条件的多步骤商店表单 > 有关奥地利法律类型 (Gesellschaftsformen)、每个法律类型的条件字段、GDPR 合规性和两种实施方法（DDEV SQL + DataHandler CLI 命令）的综合多步骤小型商店示例，请参阅[技能示例.md]()。

Typo3 Powermail

包含技能