README

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

先决条件

由于该软件包基于多个先决条件，您需要按照以下步骤操作

安装Pingponglabs Shortcode软件包
安装Formbuilder
添加中间件

请按照以下安装说明逐步操作。

安装

1. 安装Pingponglabs Shortcode软件包

要在前端显示表单，需要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中添加新的服务提供商。

  'Micvital\Shortcode\ShortcodeServiceProvider'

添加新的Facade别名。

'Shortcode'       => 'Micvital\Shortcode\ShortcodeFacade',

完成。

2. 安装Formbuilder

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

    "stonelab/formbuilder": "~1.0"

并再次运行composer update。

将模块资产发布到公共文件夹。这是非常重要的。不这样做将导致大量js错误，并且无法创建表单。

    php artisan asgard:module:publish Formbuilder

这就完成了。

3. 添加中间件

为了使其正常工作，您需要向Page模块添加一个中间件。
如果您还没有，请在config文件夹下创建一个名为asgard.page.config.middleware.php的文件。

内容应如下所示

<?php

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

注意：此功能是新添加到Page模块的。请确保您已经获得最新版本

5. 权限

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

使用方法

您可以在后端Formbuilder部分管理您的表单。当您创建表单时，请确保填写所有必要的部分和语言（特别是邮件部分）的数据，否则在尝试保存时您将丢失创建的表单，您需要重新操作。这将在未来的版本中解决。对于您创建的每个表单，您将获得一个表单ID，您可以使用它通过短代码进行访问。

短代码如下所示

    [form id=1]

您可以在任何您想要的位置放置此短代码在文章内容中。

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

注意事项

目前，输出为Bootstrapped字段和包装器。这将在未来改变。

故障排除

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

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

待办事项

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

micvital / formbuilder

维护者

详细信息