JimForm 技术文档

革命性的WordPress表单处理插件
无需预设计表单结构，任何HTML表单都能直接使用！支持跨域调用，不局限于本站使用。

新增：免费云服务表单
现在提供免费云服务表单服务，注册即可获得200次API调用额度，无需自建服务器，直接使用我们的云服务和网关。

免费云服务表单使用（推荐）

为什么选择云服务表单？
无需安装WordPress插件、无需自建服务器、无需维护服务器，泣册后立即可用！

注册账号

访问注册页面

在主页上找到“免费云服务器注册”区域，填写注册表单。

填写注册信息

提供您的邮箱地址、姓名或公司名称，以及使用场景。

获取API密钥

注册成功后，系统将立即发送API密钥和使用文档到您的邮箱。

开始使用

使用获得的API密钥，直接调用云端API接口处理表单。

云API调用方法

云服务表单API地址

POST https://api.jimform.com/send/YOUR_API_KEY

云API表单示例

<form action="https://api.jimform.com/send/YOUR_API_KEY" method="POST">
    <input type="text" name="姓名" required>
    <input type="email" name="email" required>
    <input type="tel" name="电话">
    <textarea name="留言内容" required></textarea>
    
    <!-- 可选：指定接收邮箱 -->
    <input type="hidden" name="_to_email" value="contact@yourcompany.com">
    <!-- 可选：提交成功后重定向 -->
    <input type="hidden" name="_redirect_url" value="https://example.com/thank-you">
    
    <button type="submit">提交</button>
</form>

云服务表单特殊字段

字段名	功能	示例
`_to_email`	指定接收邮箱地址	`contact@yourcompany.com`
`_redirect_url`	提交成功后重定向的URL地址	`https://example.com/thank-you`
`_subject`	自定义邮件主题	`新的联系表单提交`

核心优势与功能特性

零配置表单

无需预设字段，任何HTML表单直接可用

跨域支持

外部网站、静态页面、任何域名都可调用

智能邮件

自动将所有表单字段整理成邮件发送

即插即用

安装后立即可用，无需复杂配置

完整功能列表

功能	说明	状态
REST API接口	`/wp-json/my-forms/v1/send/{form_key}`	✅ 支持
智能表单解析	自动处理任意表单字段	✅ 支持
跨域CORS支持	支持外部网站调用	✅ 支持
自动邮件发送	将表单内容整理成邮件	✅ 支持
回复邮箱检测	自动识别用户邮箱用于回复	✅ 支持
重定向支持	提交后可跳转到指定页面	✅ 支持
免费云服务表单	注册即可获得200次免费API调用	✅ 支持
即开即用	无需安装配置，注册后立即可用	✅ 支持

WordPress插件安装与配置

推荐优先使用云服务表单：如果您不想自建和维护WordPress服务器，建议使用上方的免费云服务表单，注册即用，无需安装任何插件。

重要提示：如果选择自建服务器使用插件，需要配合SMTP插件使用才能正常发送邮件。推荐安装 WP Mail SMTP、Easy WP SMTP 或 Post SMTP Mailer 等插件。

安装插件

上传插件文件

将 universal-form-handler.php 文件上传到您的WordPress网站的 /wp-content/plugins/ 目录下。

激活插件

在WordPress后台 → 插件 → 已安装的插件中找到"通用表单处理器"，点击"启用"。

配置插件

进入 WordPress后台 → 设置 → 表单处理器，配置接收邮箱、邮件模板等选项。

刷新固定链接

进入 WordPress后台 → 设置 → 固定链接，点击"保存更改"以激活API路由。

配置SMTP（必需）

推荐安装以下SMTP插件之一：

WP Mail SMTP - 最受欢迎的SMTP插件
Easy WP SMTP - 简单易用的SMTP配置
Post SMTP Mailer/Email Log - 功能全面的邮件插件

使用方法

API接口地址

API端点

POST https://your-domain.com/wp-json/my-forms/v1/send/{form_key}

核心理念：无需预设计表单！只需要设计任意HTML表单，将表单action指向API地址，所有表单字段自动通过邮件发送。

HTML表单示例

任何表单都可以直接使用，无需修改字段结构：

基础联系表单

<form action="https://your-domain.com/wp-json/my-forms/v1/send/contact-form" method="POST">
    <input type="text" name="姓名" required>
    <input type="email" name="email" required>
    <input type="tel" name="电话">
    <select name="咨询类型">
        <option value="产品咨询">产品咨询</option>
        <option value="技术支持">技术支持</option>
    </select>
    <textarea name="留言内容" required></textarea>
    
    <!-- 可选：提交成功后重定向 -->
    <input type="hidden" name="_redirect_url" value="https://example.com/thank-you">
    
    <button type="submit">提交</button>
</form>

复杂表单示例

<form action="https://your-domain.com/wp-json/my-forms/v1/send/registration" method="POST">
    <input type="text" name="公司名称">
    <input type="text" name="联系人">
    <input type="email" name="email">
    <input type="text" name="职位">
    <input type="text" name="行业">
    <textarea name="需求描述"></textarea>
    <input type="checkbox" name="同意条款" value="是">
    
    <button type="submit">注册</button>
</form>

重点：所有字段都会自动发送到邮箱，无需预先配置！

JavaScript异步提交

JavaScript 异步提交示例

const form = document.getElementById('contact-form');
form.addEventListener('submit', function(event) {
    event.preventDefault();
    
    const formData = new FormData(form);
    const actionURL = form.getAttribute('action');

    fetch(actionURL, {
        method: 'POST',
        body: formData,
    })
    .then(response => response.json())
    .then(data => {
        alert(data.message);
        form.reset();
    })
    .catch(error => {
        alert('提交失败，请稍后重试');
    });
});

高级配置

智能邮箱检测

插件会自动检测以下字段作为回复邮箱（无需配置）：

email
your-email
user_email
contact_email
reply_email

特殊字段说明

字段名	功能	示例
`_redirect_url`	提交成功后重定向的URL地址	`https://example.com/thank-you`
`_*`	以下划线开头的字段不会显示在邮件内容中	`_internal_id`

跨域配置（CORS）

默认允许所有域名调用，如需限制可在插件设置中配置允许的域名：

允许的域名配置

https://www.example.com
http://localhost:8080
https://static-site.netlify.app

防火墙白名单

如使用宝塔面板等防火墙，请添加URL白名单规则：

防火墙规则

^/wp-json/my-forms/v1/send/.*

故障排除

常见问题解决

404错误

确保已刷新固定链接
检查API地址是否正确
确认插件已正确激活

邮件发送失败

必须安装SMTP插件（如 WP Mail SMTP）
检查SMTP插件配置
确认接收邮箱地址正确
使用插件内置的测试邮件功能

CORS跨域问题

在插件设置中配置允许的域名
检查防火墙设置
确认浏览器控制台无错误信息

表单数据为空

确保使用POST方法提交
检查表单字段的name属性
确认表单action地址正确

快速检查清单

✅ WordPress插件已激活
✅ 已安装并配置SMTP插件
✅ 已刷新固定链接
✅ API地址格式正确
✅ 表单使用POST方法

最佳实践

表单字段命名建议

使用中文字段名更直观：姓名、电话、公司名称
邮箱字段建议命名为 email 以便自动识别
避免使用下划线开头的字段名（会被隐藏）

服务选择建议

优先选择：云服务表单

适合大多数用户，无需维护，注册即用，200次免费额度足够测试和小型项目使用

自建服务器插件

适合需要完全控制或大量使用的用户，需要自己维护WordPress和SMTP配置

适用场景

静态网站表单处理

完美支持 Netlify、Vercel、GitHub Pages 等静态网站

外部网站联系表单

任何外部网站都可以调用API处理表单

第三方页面表单提交

集成到任何第三方系统或页面中

任何表单处理需求

灵活适应各种业务场景和表单结构

更新日志

v1.0.0 - 2025年发布

🎯 革命性的零配置表单处理
🌐 完整的跨域CORS支持
📧 智能邮件模板系统
🔧 简洁的后台管理界面
🚀 支持任意HTML表单结构

需要帮助？
注册云服务表单或下载插件或联系我们获取技术支持