联系表单

此版本需要 Halo 2.26.0 及以上；免费与授权功能需要应用市场 1.19.0 及以上。

旧版表单可通过「旧版表单升级」创建新版副本并迁移历史提交，检查后确认切换，也支持回退。历史提交会复制到新版收件箱，旧版原始数据仍保留；回退不会将新版提交反向迁移。

新特性

• 全新可视化设计器，支持响应式多列布局、条件逻辑、级联数据、可复用模板和自定义主题。
• 支持表单预填、答案引用、邮箱验证、跨设备续填和数据保留策略。
• 支持独立表单页、页面嵌入、悬浮按钮和弹窗投放。
• 新增提交收件箱和联系人管理，支持搜索筛选、分派、标签、内部备注及批量导出。
• 支持按回答条件执行站内通知和 Webhook，并提供失败重试与重放。
• 每站点可免费创建并使用一个表单；创建更多表单、新增或复制级联选择及文件上传字段、新增或修改字段条件逻辑，以及新增或扩展条件自动化与 Webhook 需授权。
• 授权失效后已有表单和已发布自动化继续运行，已有付费字段可继续使用和编辑，未修改的条件逻辑继续生效。
• 支持通过 MCP 查询表单、提交和分析数据，以及分派、标记提交和添加内部备注。

功能优化

• 重新设计数据分析页，完善转化趋势、字段流失、来源、设备、活动参数和答案分布展示，突出同期变化与流失阶段。
• 重新设计投放与分享页，整合渠道配置和实时预览，改善窄屏布局及未保存改动提示。
• 重新设计表单版本页，提供版本时间线，优化对比基线选择和差异展示。
• 支持在设计器中自定义提交按钮文本，文件上传支持自定义按钮文本。
• 优化模板创建、设计器和提交列表操作，统一提示与校验体验，改善深色模式帮助文本的可读性。

问题修复

• 修复表单需要点击两次才能提交的问题。
• 修复删除字段后遗留的联系人身份字段引用导致表单无法发布的问题。
• 修复弹窗及悬浮面板关闭图标未居中、提交按钮阴影显示异常的问题。
• 修复旧版表单条目中长数字显示不准确的问题。
• 修复重复字段导致导出失败的问题，并支持按勾选条目导出。
• 修复异常历史表单配置可能导致主题页面无法加载的问题。

开发者相关

• 新增新版表单公开接口及与当前发布版本一致的字段契约，提供自定义页面接入示例。
• 提供字段类型和自动化动作扩展点。

此版本需要 Halo 2.26.0 及以上；免费与授权功能需要应用市场 1.19.0 及以上。

旧版表单可通过「旧版表单升级」创建新版副本，检查并发布后再切换，也支持回退。历史提交仍在旧版入口查看，切换后的新提交进入新版收件箱。

新特性

• 全新可视化设计器，支持响应式多列布局、条件逻辑、级联数据、可复用模板和自定义主题。
• 支持表单预填、答案引用、邮箱验证、跨设备续填和数据保留策略。
• 支持独立表单页、页面嵌入、悬浮按钮和弹窗投放，并提供自定义页面接口接入示例。
• 新增提交收件箱和联系人管理，支持搜索筛选、分派、标签、内部备注及批量导出。
• 支持按回答条件执行站内通知和 Webhook，并提供失败重试与重放。
• 提供免费表单功能；许可证解锁更多表单及新增、扩展的条件自动化与 Webhook，授权失效后已有表单和已发布自动化继续运行。
• 支持通过 MCP 查询表单、提交和分析数据，以及分派、标记提交和添加内部备注。

功能优化

• 完善转化趋势、字段流失、访问来源、设备、活动参数和答案分布分析。
• 优化模板创建、设计器和提交列表操作，统一提示与校验体验。
• 文件上传支持自定义按钮文本，改善深色模式帮助文本的可读性。

问题修复

• 修复旧版表单条目中长数字显示不准确的问题。
• 修复重复字段导致导出失败的问题，并支持按勾选条目导出。
• 修复异常历史表单配置可能导致主题页面无法加载的问题。

开发者相关

• 新增新版表单公开接口及与当前发布版本一致的字段契约和接入示例。
• 提供字段类型和自动化动作扩展点。

问题修复

• 解决联系表单无法加载的问题

问题修复

• 修复联系表单文件上传失败时无法展示服务端具体错误原因的问题。

问题修复

• 修复表单切换显示形式保存后还原的问题。
• 修复联系表单文件上传失败时错误提示被二次解析异常覆盖的问题。

功能优化

• 延迟加载联系表单资源，减少无表单页面的资源开销。

功能优化

• 将时间趋势中的柱状图替换为数据表格。

问题修复

• 解决数据分析数据在新标签页中不存在的问题。

新增特性

• 为联系表单增加广告营销与数据来源分析功能。

功能优化

• 优化文件上传逻辑

问题修复

• 修复无法正常搜索表单条目的问题

问题修复

• 解决匿名提交时接口无权限的问题。
• 解决 style.css 文件 404 的问题。

依赖升级

升级 Halo 最低依赖至 2.22.2

新增功能

• 为各类选项组件的选项设置增加了模板及批量编辑的功能。
• 为小部件增加国际化功能。
• 在表单配置中增加提交表单后的操作，目前支持跳转至网页。

功能优化

• 优化现有接口地址，使用更符合规范的接口路径。/v1alpha1/plugins/PluginContactForm/entries -> v1alpha1/entries。
• 优化表单配置，现在保存表单时会明确提示错误内容。
• 优化选项组件的选项设置项样式。

问题修复

• 解决页面路由包含空的路由会出现字段验证错误的问题。

新增功能

• 在表单渲染时支持根据用户浏览器设置多语言

功能优化

• 适配 Halo 2.22

功能优化

• 显示关联用户时目前会直接显示用户名而非显示名。
• 显示多选结果时，会使用 ; 号分割，不再显示中括号与引号等。

新特性

• 新增了支持文件上传的表单组件。
• 如果用户非匿名提交，则在表单中展示对应用户的信息。

功能优化

• 现在设置 必填字段 时，禁止空白字符的提交。

⚠️ 更新后，必填字段需要在模板中重新勾选。

问题修复

• 解决查看条目信息时无法复制表单内容的问题。
• 解决无法提交及删除表单的问题。
• 解决提交时会导致表单字段重复提交的问题。

---

问题修复

• 修复与 Halo 本身的样式冲突的问题。

---

功能优化

• 降低 bundle.js 的大小，提升 Console 访问速度。

---

问题修复

• 修复无法在 Halo 2.21.0 中正常查询表单的问题

---

功能优化

• 适配 Halo 2.21.0 的数据列表样式。

---

功能优化

• 完善插件定义文件。
• 为表单提交按钮增加防抖，防止数据重复提交。
• 移除对已过时的 PluginWrapper 的引用。
• 使用 Halo 2.17 新提供的全局 axios 实例和 apiClient 重构请求逻辑。
• 支持使用用户选择组件配置收件人。
• 条目支持显示提交时间。
• 为选择器组件增加必填的设置项。

---

Generated from v1.1.0

新特性

• 支持为表单项设置帮助（help）属性。
• 为表单条目通知类型添加 UI 权限控制。

问题修复

• 修复禁用表单后，匿名提交的提示错误问题。
• 在渲染条目列表时，保持用户输入的格式进行展示。
• 修复导出的 CVS 文件有乱码的问题。
• 解决联系表单邮件通知报错的问题。
• 修复多行文本组件的可视行数修改无效的问题。

⚠️ 此版本适配了应用市场的许可证校验，在升级到此版本前，请确保已经安装了 应用市场 插件的最新版本，并绑定了 Halo 官网的账号。并且升级之后需要手动激活许可证，具体文档可参考：https://app-docs.halo.run/docs/plugin-contact-form/usage/installation

问题修复

• 修复插件可能无法删除的问题

⚠️ 此版本适配了应用市场的许可证校验，在升级到此版本前，请确保已经安装了 应用市场 插件的最新版本，并绑定了 Halo 官网的账号。并且升级之后需要手动激活许可证，具体文档可参考：https://app-docs.halo.run/docs/plugin-contact-form/usage/installation

新特性

• 支持将条目数据导出为 CSV 文件。
• 重构整体的 UI。
• 支持为表单自定义样式，参考文档
• 默认提供暗黑模式配色，参考文档

功能优化

• 更新 Logo 和部分插件信息。
• 提供异常提示组件，不再使用浏览器的 alert。

问题修复

• 修复保存后的数据无法回显的问题

新特性

• 支持通过弹窗方式展示联系表单。 by @LIlGG in https://github.com/f2ccloud/plugin-contact-form/pull/15

问题修复

• 解决匿名用户访问模板的权限问题。
• 解决当通知为空时产生的空指针问题。

新特性

• 适配通知功能，当表单有新的条目提交时通知收件人。

功能优化

• 将插入表单的按钮移动到 Toolbox。
• 优化 Console 端部分页面的样式。

问题修复

• 修复由于权限配置问题导致具有模板查看权限的用户无法查看模板的问题。

首个版本发布 🎉