README

项目网站

项目仓库

注意 - 我已经更新了大量代码，如果您已经使用此插件，则需要先卸载它，然后重新安装。抱歉，由于有很多更改，创建数据库迁移不是一个选项。

安装

克隆此仓库 https://github.com/roundhouse/FormBuilder-Craft-CMS
将文件夹重命名为 FormBuilder 并将其放置到您的 Craft CMS 插件目录中。
转到您的插件页面 /settings/plugins 并点击安装

使用方法

查看 sampleForm.html 以获取代码示例。

创建字段

转到 /settings/fields 并点击 + 新字段
填写字段信息。请确保仅使用 | FormBuilder | 字段。

可用字段

| FormBuilder | 复选框
| FormBuilder | 下拉菜单
| FormBuilder | 电子邮件地址
| FormBuilder | 文件上传
| FormBuilder | 多选
| FormBuilder | 纯文本
| FormBuilder | 单选按钮
| FormBuilder | 隐藏字段

创建表单

返回到 FormBuilder 表单页面并点击 + 新表单。查看截图
- 表单设置
  表单名称 - 输入表单名称
  处理 - 将自动生成
  电子邮件主题 - 这将是电子邮件通知的主题行
  使用 AJAX？ - 如果您想要通过 AJAX 提交表单，请勾选此选项，这将使用 JavaScript 验证 required 字段
  使用 reCaptcha？ - 如果您想要使用 Google reCaptcha，请勾选此选项。需要安装以下插件： Craft reCaptcha
  重定向到成功页面 - 如果您想要重定向到成功页面（例如："/thank-you"），请勾选此选项
  重定向 URL - 输入成功页面的 URL
- 消息
  成功消息 - 输入表单提交的成功消息
  错误消息 - 输入表单提交的错误消息
- 通知
  发送通知？ - 如果您想要通知表单所有者表单提交，请勾选此选项
  发件人电子邮件 - 输入提交通知将发送到的电子邮件地址
  电子邮件模板路径 - 电子邮件模板所在的路径
  通知注册者？ - 如果您想要通知表单提交者他们的成功提交，请勾选此选项。 您需要首先保存表单才能显示此选项。
  通知字段 - 邮件模板所在路径。 您必须首先在字段部分添加一些字段并保存表单，才能显示此字段。此外，此字段需要使用 | FormBuilder | 电子邮件地址 字段类型。
- 字段
  字段集 - 您可以通过点击 + 添加字段集 创建多个字段集
  创建新字段 - 这将带您转到 /settings/fields，在那里您可以创建一个新字段

必填字段

如果您想设置必填字段，可以点击“齿轮”图标在字段部分。这将向输入字段添加HTML5 "required" 属性。如果您的表单使用Ajax提交，javascript将验证这些字段（使用Parsleyjs）。查看截图

reCaptcha

前往 https://github.com/aberkie/craft-recaptcha/ 并遵循安装说明。
在表单的前端任何位置添加此 {{craft.recaptcha.render()}}。
在表单设置部分检查 使用 reCaptcha?

文件上传

注意： 目前此功能仅适用于常规POST请求。如果您的表单使用AJAX，文件上传将无法正常工作。如果您正在更新插件，请将此添加到您的 <form> 标签中 {% if form.hasFileUploads %} enctype="multipart/form-data" {% endif %}，例如检查 sampleForm.html。

首先您需要创建一个资产源。转到 settings//assets 并点击 + 新建源
为您的源命名，对于 类型，请选择 本地文件夹。本地文件夹是目前唯一支持的项目。
对于 文件系统路径，请输入 formbuilder。
对于 URL，输入 http://yourwebsite.com/craft/storage/
保存！

现在去创建一个新的字段 settings/fields。对于 字段类型，请确保选择 | FormBuilder | 文件上传。

现在转到您的表单，并在表单设置部分检查 有文件上传。将出现一个下拉菜单，请选择您之前创建的资产源查看截图。现在转到字段部分，并将您创建的字段拖到您的表单中查看Gif。

保存表单。

待办事项

创建更多字段类型（日期、开关等）
为条目添加导出/导入功能

roundhouse / formbuilder

维护者

详细信息