README

Version 2.X 的主要工作由 Sebastian Zoglowek 完成，感谢！

此扩展为 Contao-Leads 扩展提供了双 Opt-In 功能。

设置

目前只能通过 composer 或 contao 管理器进行设置。只需要求或搜索 cboelter/contao-lead-optin 并安装它。

配置

通知

该扩展知道两种不同类型的通知。一种是用户提交表单时发送给用户的通知，其中包含 Opt-In 链接和附加信息。它被称为“保存询问：OptIn”。另一种是在用户成功点击 Opt-In 链接时发送的通知。它被称为“保存询问：OptIn 确认”。

1. 保存询问：OptIn

此通知可以使用以下简单令牌向用户发送通知

lead_*, formconfig_*, admin_email, raw_data, optin_token, optin_url

令牌 lead_* 可以使用类似这样的任何表单：lead_email。令牌 formconfig_* 可以使用类似这样的任何表单配置：formconfig_id。

1. 保存询问：OptIn 确认

此通知可以使用以下简单令牌向用户发送通知

lead_*, formconfig_*, admin_email

令牌 lead_* 可以使用类似这样的任何表单字段：lead_email。令牌 formconfig_* 可以使用类似这样的任何表单配置：formconfig_id。

它不是强制的，例如，可以用来通知管理员新的注册。

一般说明：已知的简单令牌 ##form_*## 在此扩展中不会工作，您需要使用 ##lead_*##。

表单配置

要使用此模块，必须有一个 contao 表单。在 contao 表单管理器中创建表单和表单字段。此扩展是 leads 扩展的附加组件。因此，您需要在要使用扩展的表单中启用它。

您必须在表单配置中启用“保存询问”复选框。启用复选框后，您将看到 leads 的基本配置以及另一个复选框“保存询问 OptIn”。您必须设置基本配置，然后才能启用 Opt-In。只需选择在第一步中创建的通知，选择是否启用 IP 追踪，并最终选择 OptIn-Link 的重定向页面。

一般说明：如果您没有启用邮件字段由 leads 存储，则该扩展将无法工作。

OptIn-页面/处理模块

要使扩展工作，您必须创建一个新的前端模块，类型为“OptIn 处理”。

在此模块中，您可以定义成功 Opt-In 的备注和错误 Opt-In 的备注。模块将自动决定向用户显示哪个文本。作为第三种配置，您可以选择成功通知（请参阅通知部分）。

在表单配置中选定的页面包含此模块，作为“OptIn 目标页面”。现在 Opt-In 将工作。

导出

此扩展提供了一个自定义导出器用于 Opt-In。在导出配置中，您可以看到一个新的导出类型，称为“OptIn 导出 CSV (.csv)”。它提供了一个自定义的数据收集器和导出器，用于导出 Opt-In 所需的所有数据。您只需选择此导出器并给它命名。

线索列表后端中的人形图标显示了您的选择加入状态 -> 绿色表示已选择加入 -> 灰色表示目前未选择加入。

就是这样 ... 您现在可以使用扩展了。如果您认为发现了错误，请随意在github上提交一个issue或pull request :-) 感谢！

这份文档由Stefan Senn赞助（感谢您！）。