README

这是一个从 cboelter/contao-lead-option 分支出来的版本。此分支支持 notification_center 2.x 和 leads 3.x。

2.X 版本的多数工作由 Sebastian Zoglowek 完成，感谢他！

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

设置

目前只能通过 composer 或 contao 管理器进行设置。只需要求或搜索 cgoit/contao-leads-optin-bundle 并安装即可。

配置

通知

扩展知道两种不同类型的通知。一种是在用户提交表单时发送给用户的通知，其中包含 Opt-In 链接和附加信息。它被称为 "Anfragen speichern: OptIn"。第二种是在用户成功点击 Opt-In 链接时发送的通知。它被称为 "Anfragen speichern: OptIn Bestätigung"。

1. Anfragen speichern: OptIn

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

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

令牌 lead_* 可以使用任何表单，例如 lead_email。令牌 formconfig_* 可以使用任何表单配置，例如 formconfig_id。

1. Anfragen speichern: OptIn Bestätigung

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

lead_*, formconfig_*, admin_email

令牌 lead_* 可以使用任何表单字段，例如 lead_email。令牌 formconfig_* 可以使用任何表单配置，例如 formconfig_id。

这是可选的，可以用于例如通知管理员有新的注册。

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

表单配置

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

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

一般说明：如果您不启用电子邮件字段由 leads 存储，则扩展将无法工作

OptIn-页面 / 处理模块

要使扩展正常工作，您必须创建一个类型为 "OptIn Verarbeitung" 的新前端模块。

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

在您在表单配置中选择的页面上包含此模块作为 "OptIn Zielseite"。现在 Opt-In 将正常工作。

导出

本扩展提供了一个针对“同意加入”的定制导出器。在导出配置中，您可以看到一个名为“OptIn-Export CSV (.csv)”的新导出类型。它提供了一个定制的数据收集器和导出器，用于导出所有必要的“同意加入”数据。您只需选择此导出器并给它起一个名字。

在后台的潜在客户列表中，人物图标显示您同意加入的状态——绿色表示同意加入已完成——灰色表示当前未完成。

就是这样...现在您可以使用此扩展了。如果您认为您发现了一个错误，请随时在github上创建一个问题或拉取请求（:-）谢谢！

本文档由Stefan Senn赞助（谢谢！）。