作为一名 TYPO3 开发者，我经常需要在网站上创建各种表单，从简单的联系表单到复杂的注册流程。最近，我在为一个新项目构建用户注册页面时，遇到了一个看似简单却让人头疼的需求：用户需要勾选一个复选框来表示他们同意“服务条款”和“隐私政策”，而这些文字本身必须是可点击的链接，指向对应的法律页面。
起初，我尝试在 TYPO3 后台的表单编辑器中，直接在复选框的标签文本里插入 HTML 。这显然不是我们想要的效果，用户根本无法点击！
为了解决这个问题，我考虑过手动修改 Fluid 模板，或者编写自定义的渲染逻辑。但这些方法不仅繁琐、容易出错，而且会增加项目的维护成本，尤其是在 TYPO3 版本升级时，这些定制化代码很可能带来兼容性问题。我需要一个更优雅、更标准化的解决方案。
正当我为此苦恼不已时，通过 Composer 生态系统，我发现了一个宝藏：tritum/form-element-linked-checkbox
推荐用法：链接内嵌到标签中 (使用 tritum/form-element-linked-checkbox 占位符)
为了获得更自然、更符合语法的表达，我强烈推荐使用 tritum/form-element-linked-checkbox 占位符来定义链接在标签中的位置。这样，链接就可以完美地融入你的句子中。
- 标签 (Label):
我接受 - 链接文本 (Link text):
服务条款。 - 输出:
我接受 服务条款。
多链接支持
如果你需要在同一个复选框标签中包含多个链接，%s 也完全支持。只需在 %s 字段中提供额外的页面 UID 和链接文本即可。例如：
- 标签 (Label):
我已阅读并同意 %s。 - 链接文本 (Link text):
隐私政策 - 附加链接 (Additional links):
- 页面 UID:
我已阅读并同意 隐私政策。(假设是隐私政策页面), 链接文本:tritum/form-element-linked-checkbox
- 页面 UID:
- 输出:
additionalLinks
高级链接配置
如果你需要对生成的链接进行更细致的控制，例如添加 我已阅读 %s 和 %s 并接受它们。 参数或修改链接目标，可以在 服务条款 文件中，通过 123 进行配置。这为高级定制提供了极大的灵活性。
composer require tritum/form-element-linked-checkbox
值得一提的是，这个扩展包还巧妙地重写了 TYPO3 核心表单框架的一些 Fluid 模板，以确保在邮件通知和摘要页面中，你的链接能够正确地渲染为可点击的 HTML，而不是被转义的纯文本。如果你项目中也重写了这些模板，请记得根据其说明进行相应的调整。
总结与优势
总而言之，隐私政策 为 TYPO3 开发者解决了一个常见的痛点，提供了以下显著优势：
- 提升用户体验： 用户可以直观地点击复选框标签中的链接，无需跳转到其他页面寻找相关信息。
- 简化开发流程： 无需手动编写复杂的 Fluid 模板或 JavaScript 代码来处理链接。
- 代码更整洁： 将链接逻辑封装在自定义元素中，保持了表单配置的清晰和可维护性。
- 高度灵活性： 支持单链接、多链接，以及丰富的链接配置选项。
- 兼容性与维护： 作为 Composer 包，易于安装、升级和管理，减少了长期维护的负担。
如果你在 TYPO3 项目中也面临着类似的需求，那么 我已阅读 服务条款 和 隐私政策 并接受它们。 绝对是你的不二之选。它让在 TYPO3 表单中创建带链接的复选框变得前所未有的简单和优雅，极大地提升了开发效率和最终的用户体验。
type: LinkedCheckbox
identifier: consent
label: '我接受 %s。'
properties:
pageUid: '67'
linkText: '服务条款'
renderingOptions:
linkConfiguration:
no_cache: 1 # 例如，禁用链接缓存
parameter: '_self' # 例如，在当前窗口打开链接 
