跳转到内容
订阅表单 API

WordPress 集成指南

将 WordPress 网站连接到 smartest.email,发布需要邮件确认的订阅表单。

插件版本 0.2.0

安装与连接

在 WordPress 中通过“插件 → 安装插件 → 上传插件”上传 ZIP 文件并启用插件。打开“设置 → smartest.email”连接账户。WordPress 网站必须使用 HTTPS。

该插件支持独立的 WordPress 安装,目前尚不支持多站点。

授权前请核对网站地址,并选择表单所属的工作区。此连接可以读取符合条件的表单并提交订阅请求,不能创建营销活动或读取联系人列表。

准备表单

在 smartest.email 发布表单,包含必填的邮箱字段、必选的同意复选框及隐私声明。开启“已连接应用的双重确认”,并选择确认邮件的语言。

创建表单

发布订阅表单

在页面中添加 smartest.email 订阅表单区块并选择表单。也可以从插件设置中复制短代码,粘贴到短代码区块。发布前请预览页面。

WordPress shortcode
[smartest_email_form id="YOUR_FORM_ID"]

表单使用 smartest.email 中最新的字段标签、同意文本和隐私链接。请先修改原表单,再刷新插件中的表单列表。

预览并设置表单样式

在区块设置中搜索表单并查看实时预览。在 smartest.email 中修改表单后,请刷新表单列表。编辑器和设置中的预览无法提交订阅。

可选择纵向或两列字段布局、标准或全宽、自定义按钮文字以及全宽按钮。在小屏幕上,两列会变为上下排列。您的主题还可能提供区块颜色、字体和间距设置。

外观更改仅适用于当前区块或短代码。字段标签、必填字段、同意声明、隐私链接及邮件确认仍在 smartest.email 中管理。

WordPress shortcode
[smartest_email_form id="YOUR_FORM_ID" layout="two-column" width="full" button_width="full"]

短代码还支持 button_label,可设置最多 80 个字符的自定义按钮文字。未设置外观选项时,现有区块和短代码会保留原来的默认值。

在“设置 → smartest.email”中,您可以搜索可用表单、打开只读预览或复制短代码。如果无法访问剪贴板,请选择短代码并手动复制。

断开网站连接

在插件设置中断开连接,或在 smartest.email 的“设置 → 已连接应用”中撤销连接。接受新提交前需要重新连接。若改连其他工作区,请重新选择其表单。

管理已连接的应用

排查连接和表单问题

没有显示表单?请检查连接的工作区是否正确,以及表单是否已发布并开启双重确认。连接断开或过期时需要重新连接。更改网站地址或恢复备份后,请从正确的网站重新连接。

暂时失败后可以重试同一次提交。请勿删除同意步骤或改用无需双重确认的公共接口来绕过错误。请检查插件状态和服务器的出站 HTTPS 连接。