README

我们的插件可以通过德国邮政的“打印邮寄自动化”（又称“打印邮寄”）产品个性化打印邮寄，并将其直接集成到您的Mautic活动中，并在最合适的时间自动发送。

这个插件是用来做什么的？

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

安装和基本配置

除了Mautic账户外，还需要德国邮政打印邮寄管理网站的客户账户才能安装此插件——更多信息可以在网站德国邮政AG打印邮寄上找到。

从Rel. 4.x更新到Rel. 5.x

4.x和5.x之间的命名发生了变化：请删除MauticTriggerdialogBundle，并下载并安装现在称为LeuchtfeuerPrintmailingBundle的新版本。

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

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

需求

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

• 服务器命令行访问权限

安装

• 从Github下载插件“mautic-deutschepost”（ZIP存档）到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后端的“设置”->“插件”，点击“安装/更新插件”

• “Dt. Post”现在在插件列表中，并且已经激活

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

• MAS ID（技术名称为"partnerSystemIdExt"）- 标识远程系统（即德国邮政）

• "客户ID" - 标识您的系统。重要：您需要向德国邮政提交此ID，否则您将无法访问！

• "Prod JWT Secret" - 允许从 Mautic 单点登录到 Deutsche Post

• 用户名 和密码 ("Authentication Secret") - 从您的系统到 Deutsche Post 传输数据所需

配置完成，并将 "Mandanten-ID" (见上文) 报告给 Deutsche Post 吗？

现在开始激动人心：在 "渠道" -> "打印邮寄""，点击右上角的蓝色按钮 "打印邮寄-MANAGER" 切换到 Deutsche Post 界面，从而验证您的配置。

如果您到达那里 - 在 "黄色表面" - 并且看到右上角有您的名字，那就成功了！

使用方法

在 Mautic 中创建映射模板

其他一切都几乎与电子邮件相同：在您可以将第一个打印邮寄动作集成到您的活动之前，您必须创建一个模板。

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

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

对于每个映射模板，您将在下一步中通过 Deutsche Post 的打印邮寄经理分配设计等。

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

所以按下蓝色按钮 - 如上图所示 - 然后您可以在 Deutsche Post 的打印邮寄经理中继续，在那里您将看到您创建的映射模板，并为每个模板设置设计、产品属性等。

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

Mautic 营销活动中的集成

插件附带了一个新的活动操作：“通过打印邮寄发送”。

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

Mautic 然后使用插件将数据发送到 Deutsche Post 进行打印和递送 - 然后，您的联系人在他的邮箱中收到个性化的明信片。

贡献

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

作者

Leuchtfeuer Digital Marketing GmbH

mautic@Leuchtfeuer.com