用插件和短代码把表单放到 WordPress 上

FormFlow v1.32.0 于 2026-10-04 发布，为获取代码增加了 WordPress 标签页。这是从表单到 WordPress 页面最短的路径：插件上传一次，每页粘贴一个短代码，表单保持当前字段，不用谁再去粘贴标记。

这个版本记录在更新日志中。本教程涵盖三个步骤、真正重要的属性，以及连不上 FormFlow 时的行为。

这个插件是什么，不是什么

下载的是一个 PHP 文件，打包在 formflow-wordpress.zip 里，只有一个条目 formflow/formflow.php。它注册一个短代码，向 FormFlow 发出一个请求，把答案缓存五分钟，并输出收到的标记。它在所有方案上免费。

插件就这些。它不重新实现表单，也不做任何决定：准入、垃圾判定、Strict 模式、Turnstile 和投递都留在 FormFlow 的服务器上。装在客户站点上的插件日后无法修改，所以把每个决定留在我们这一侧是刻意的。

上传一次

1. 打开表单，按获取代码，选择 WordPress 标签页。

2. 按下载 WordPress 插件。你的站点会收到 formflow-wordpress.zip。

3. 在 WordPress 中进入插件 → 安装插件 → 上传插件，选择该文件并安装。

4. 启用它。插件需要 WordPress 5.8 或更高版本，以及 PHP 7.4 或更高版本。

短代码就在同一个标签页里。从「复制到剪贴板」下方的字段复制它：标签页会按获取代码里当前选定的风格和实时渲染选项输出，所以你粘贴的内容与你刚看过的预览一致。

放置短代码

在页面或文章里添加一个 Shortcode 区块，把这一行粘进去。

[formflow form="FORMFLOW_TOKEN" style="minimal" live="1"]

三个属性承载这次放置。

• form 是表单的令牌。它是插件发往 FormFlow 的唯一内容，并在发出请求之前被检查。

• style 是你在获取代码里选择的风格，例如 minimal 或 bootstrap。把它记录下来，意味着日后默认值改变时，不会给用旧默认放置的页面重新套样式。

• live 用值 1 打开实时渲染。省略它，短代码就输出普通的生成组件，当你不想让访客的浏览器再发一次请求时，这是更好的选择。

连不上 FormFlow 时会发生什么

插件就是一次请求加一次缓存，所以它的失败行为值得在依赖它之前弄明白。

• 好的响应会缓存五分钟，所以访问量大的页面不会每次浏览都调用 FormFlow。

• 最后一份好的副本也会保存在站点自己的选项里。如果请求超时、被限流或返回服务器错误，页面就输出那份副本。

• 如果一份副本都没有，访客什么也看不到，已登录的编辑会看到一条短提示，写明令牌和 HTTP 状态码。

• 如果表单已不存在或已关闭，插件对访客什么都不输出，并向编辑说明原因。存下的副本会被保留而不是清掉，所以一个错误回答抹不掉它。

它在哪里停下

• 没有 Gutenberg 区块。Shortcode 区块是受支持的路径，它在区块编辑器里可用。

• 没有 WordPress 设置页，没有插件自动更新，也没有 wordpress.org 上的条目。文件由你自己上传和更新。

• WordPress 从不向 FormFlow 写入。放置表单不会把站点加进表单的允许列表，插件也无法创建或编辑表单。

• 插件不是 AI 集成。FormFlow 没有连接到 WordPress 7.0 的 AI Connectors 界面。

接下来读什么

如果你还没有在任何地方放置过表单，先读那篇用生成组件嵌入表单的文章：短代码输出的是同一份标记，两条路殊途同归。如果页面不是英文，v1.7 那篇文章说明表单的语言如何从托管页面一路跟随到嵌入的副本。至于请求背后的契约，请看API 参考。