README

本模块正在运行，但处于非常初级的alpha版本。使用风险自负！ 欢迎您对其进行开发

前提条件

由于该软件包基于多个前提条件，您需要按照以下步骤进行

安装 Pingponglabs 短代码软件包
安装 Formbuilder
添加中间件

请按照以下安装说明逐步进行。

安装

1. 安装 Pingponglabs 短代码软件包

为了在前端显示表单，需要 Pingpong Sky Labs 的 Shortcode 模块
http://sky.pingpong-labs.com/docs/2.0/shortcode
由于 Pingponglabs 在最新版本中更改了解析逻辑，某些情况下可能会出现不兼容性。这就是为什么我们将版本固定为 2.1 的原因。

请将以下内容添加到您的 composer.json 文件中

    "pingpong/shortcode": "2.1",

然后，打开终端并运行。

    composer update

在 composer 更新后，在 config/app.php 中添加新的服务提供者。

  'Pingpong\Shortcode\ShortcodeServiceProvider'

添加新的 Facade 别名。

'Shortcode'       => 'Pingpong\Shortcode\ShortcodeFacade',

完成。

2. 安装 Formbuilder

现在您可以安装 Formbuilder。请将以下内容添加到您的 composer.json 文件中

    "stonelab/formbuilder": "~1.0"

并再次运行 composer update。

就这么简单。

3. 添加中间件

为了使其工作，您需要向页面模块添加一个中间件。
如果您还没有，请创建一个位于 confid 文件夹下的 asgard.page.config.middleware.php 文件。

内容应如下所示

<?php

return [
    'Modules\Formbuilder\Http\Middleware\FormbuilderMiddleware'
];

注意：此功能是最近添加到页面模块的。请确保您拥有最新版本

5. 权限

不要忘记为新添加的 Formbuilder 模块设置权限。

使用

您可以在后端 Formbuilder 部分管理您的表单。在创建表单时，请确保您已填写所有必要的数据（尤其是邮件部分），否则您在尝试保存时可能会丢失创建的表单，您需要再次进行此操作。这将在未来的版本中得到解决。对于您创建的每个表单，您将获得一个表单 ID，您可以使用它通过短代码进行操作。

短代码看起来像这样

    [form id=1]

您可以将此短代码放在任何页面内容中。

所有提交的表单都会自动存储，您可以在后端查看。

注意

目前，输出是 Bootstrapped 字段和包装器。这将在未来进行更改。

故障排除

错误：找不到短代码
您首先需要设置短代码软件包。当出现此错误时，意味着您尚未在 config/app.php 中添加别名。

表单无法发送
请检查 config/mail.php 中的邮件驱动程序
当设置正确时，然后检查您是否已设置有效的表单邮件设置。

TODO

修复未填写所有必要数据时丢失数据的问题。使布局更加灵活

sagsoz06 / formbuilder-module

维护者

详细信息