README

实现表单通常很痛苦。不幸的是，大多数网站都需要它们，因此我们 Cre8iv Click 团队决定尝试创建一个使开发者更容易处理表单的 Kirby 插件。FormBuilder 插件通过以下三个方面来帮助：

1. 在面板中轻松创建自定义表单

此插件提供了一种预制的界面，允许最终用户在面板中直接创建和配置他们的自定义表单。这允许以可视化的方式创建许多不同类型的表单，从标准的“联系我们”，到长问卷。

2. 在模板中自动创建表单 HTML

根据您的面板配置，FormBuilder 可以自动为您生成表单的 HTML 代码，并用一行代码将其注入到您的模板或代码片段中。

3. 内置表单处理

处理表单的头痛之处很大一部分在于处理提交的响应。FormBuilder 提供了现成的函数，可以通过电子邮件提交响应，并在 Kirby 面板中显示接收到的响应——无需编写代码！

需求 & 安装

FormBuilder 需要使用 Kirby Builder 插件 以其面板界面 - 在安装 FormBuilder 之前，请确保安装它。

手动下载

您可以简单地将此存储库下载并复制到 /site/plugins/formbuilder。

Git 子模块

您可以使用以下命令将 FormBuilder 添加到项目中作为 git 子模块：

git submodule add https://gitlab.com/cre8ivclick/formbuilder.git site/plugins/formbuilder

Composer

如果您使用 composer，则可以快速将 FormBuilder 添加到项目中，如下所示：

composer require cre8ivclick/formbuilder

文档

有关如何安装、配置和使用 FormBuilder 在您的 Kirby 网站中的完整说明，请参阅此项目的 维基区域。

贡献

请使用此项目的“问题”页面报告您找到的任何错误，并发布想法和功能请求。

我们已尝试使插件中的代码尽可能简单、有组织和有注释。请随意分叉此项目，并通过合并请求发送增强功能和错误修复。请注意，我们旨在保持插件 简单 和 易于维护。

待办事项

• [ ] 更好的提交日志界面
• [ ] 将提交导出为 CSV 文件
• [ ] 将提交存储到后端数据库

许可证

FormBuilder 在 MIT 许可证下发布 - 请参阅此存储库中包含的 'LICENSE.md' 文件以获取完整的许可证文本。

鸣谢

Cre8iv FormBuilder 由 Cre8iv Click 开发，但没有他人的工作是不可能创建的。

• FormBuilder 的面板界面需要 Tim Ötting 的优秀 Kirby Builder 插件
• 惊人的 Sonja Broda 通过她在 Kirby 论坛 中的专业和友好的建议，帮助解决了 AJAX 表单提交和处理的问题。
• 我们的面板提交日志基于来自非常熟练的 Pedro Borges 的一些代码示例。