README

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

1. 在面板中轻松、定制表单创建

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

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

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

3. 内置表单处理

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

要求 & 安装

FormBuilder需要Kirby Builder插件（TimOetting/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

文档

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

贡献

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

我们已尽力使插件中的代码合理简单、有组织且注释良好。请随意fork此项目，并通过合并请求发送增强和错误修复。请注意，我们旨在保持插件简单和易于维护。

待办事项

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

许可证

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

鸣谢

Cre8iv FormBuilder由Cre8iv Click开发，但如果没有其他人的工作，则无法创建。

• FormBuilder的面板界面需要Tim Ötting的出色Kirby Builder插件
• 令人惊叹的Sonja Broda通过她在Kirby论坛中提供的专业和友好建议，帮助调试ajax表单提交和处理
• 我们的面板提交日志基于来自非常熟练的Pedro Borges的一些代码示例