README

我们的插件可以使用德意志邮政的“打印邮件自动化”（又称“打印邮件”）产品进行个性化打印邮件，并将其直接集成到您的Mautic活动中，并在最合适的时候自动发送。

插件是做什么用的？

Leuchtfeuer 与德意志邮政 AG 合作开发了 Print Mailing 插件，以便能够直接从营销自动化工具发送明信片，个性化并选择最合适的时间。Mautic 用户可以将打印邮件的发送作为一项新操作直接集成到他们的 Mautic 活动中——基于常规逻辑模块（例如，“邮件是否未打开？”或“预订是否取消？”）。当然，可以针对每个收件人完全设计和个性化相应的明信片，以便直接与之联系或提供特殊折扣代码。您可以在此处了解更多有关 Print Mailing 插件的好处和可能的应用。

安装和基本配置

除了 Mautic 账户外，还需要德意志邮政打印邮件管理网站的客户账户来安装插件——更多信息可以在网站上找到 Deutsche Post AG 的打印邮件。

从 Rel. 4.x 升级到 Rel. 5.x

4.x 和 5.x 之间名称有所更改：请删除 MauticTriggerdialogBundle，然后下载并安装现在称为 LeuchtfeuerPrintmailingBundle 的新版本。

此更改还破坏了配置。要修复它，您需要编辑 local.php 文件（如果您不熟悉该文件，可能需要寻求帮助）。

• 删除文件末尾的 printmailing_ 条目
• 将所有 triggerdialog_ 条目重命名为 printmailing_

要求

• Mautic 版本 3.x // 4.x

• 对服务器的命令行访问权限

安装

• 从 Github（ZIP存档）下载插件 "mautic-deutschepost" 到 Mautic 服务器

• 解压缩文件，重命名目录并将其移动到 Mautic 安装的插件目录 mv mautic-deutschepost-master <path-to-mautic>/plugins/LeuchtfeuerPrintmailingBundle

• 清除缓存，通常： sudo -u www-data php <path-to-mautic>/bin/console cache:clear

• 如有必要，调整文件权限： chown -R www-data:www-data <path-to-mautic>/plugins/LeuchtfeuerPrintmailingBundle

• 转到 Mautic 后端中的“设置” -> “插件”，点击“安装/更新插件”

• "德意志邮政"现在在插件列表中，并且已经激活

以下配置很简单：您可以在“设置” -> “配置” -> “打印邮件设置”下进行所有必要的设置。

• MAS ID（技术名称为 "partnerSystemIdExt"）——识别远程系统（即德意志邮政）

• "客户ID"——识别您的系统。重要提示：您需要将此 ID 提交给德意志邮政，否则您将无法访问！

• "生产 JWT 密钥"——允许 Mautic 从德意志邮政进行单点登录

• 用户 和密码 ("认证密钥") - 用于从您的系统到德意志邮政的数据传输

配置已完成，并已向德意志邮政报告了 "客户 ID" (见上方) 吗？

现在变得有趣了：在 "通道" -> "打印邮寄"" 中，点击右上角的蓝色按钮 "打印邮寄-MANAGER"，以切换到德意志邮政界面，并验证您的配置。

如果您到达那里 - 在 "黄色表面" 中 - 并在右上角看到您的名字，一切就绪了！

使用方法

在 Mautic 中创建映射模板

现在几乎和电子邮件一样：在您可以将第一个打印邮寄动作集成到您的活动之前，您必须创建一个模板。

在 "通道" -> "打印邮寄" 中，点击 "新建" 以在 Mautic 中创建一个新的打印邮寄映射模板。

在 "数据映射" 标签页中，可以在启动明信片时选择要传输的所需数据。类型为 "邮政编码" 的字段是必需的；当然，完整的地址数据也是成功邮政投递的必需品。因此，每个新模板中已预先分配了一套基本数据（当然，可以更改）。

对于每个映射模板，您将能够通过德意志邮政的打印邮寄管理器在下一步分配设计等。

Mautic 中的准备工作到此结束。明信片的视觉设计（例如使用 InDesign 或现代在线编辑器）和其他配置将不在 Mautic 中进行，而是在打印邮寄管理器中直接进行。

因此，请按蓝色按钮 - 见上方 - 然后在德意志邮政的打印邮寄管理器中继续，您将看到您创建的映射模板，并可以为每个模板设置设计、产品属性等。

如果您使用的是在线编辑器，您还可以在您的浏览器中直接创建或编辑设计。

Mautic 活动中的集成

插件带有一个新的活动操作："通过打印邮寄发送"。

再次，就像电子邮件一样，您现在可以从您现有的模板中选择 - 即您在 Mautic 中创建的打印邮寄映射模板。

Mautic 然后使用插件将数据发送到德意志邮政进行打印和投递 - 然后不久您的联系人将在他们的邮箱中收到个性化的明信片。

贡献

您可以通过向此存储库的 master 分支提交 拉取请求 来做出贡献。或者，只给我们一些 啤酒...

作者

Leuchtfeuer 数字营销有限公司

mautic@Leuchtfeuer.com