README

这是一个只读仓库，从 github.com/cuatromedios/kusikusi-monorepo 的单仓库拆分而来。

有关 Laravel 入门套件，请访问 github.com/cuatromedios/kusikusi

安装

此软件包补充了 kusikusi/models 和 kusikusi/website 软件包，应首先要求这些软件包。

composer require kusikusi/forms

用法

发布资源

发布所有资源 ...

php artisan vendor:publish --provider="Kusikusi\FormServiceProvider"

或发布单个资源

配置

php artisan vendor:publish --provider="Kusikusi\FormServiceProvider" --tag="config"

迁移

php artisan migrate

接收表单

您想要通过 Kusikusi Forms 处理的任何表单，将操作设置为 /form，方法设置为 post
包含 Laravel CSRF 令牌

包含一个名为 entity_id 的隐藏字段，其值为当前页面的实体 ID

<form action="/form" method="post">
    <input name="name" />
    <input name="email" type="email" />
    <input type="hidden" name="_token" value="{{ csrf_token() }}" />
    <input type="hidden" name="entity_id" value="{{ $entity->id }}" />
    <button type="submit">Enviar</button>
</form>

引用的实体应在 properties 字段中有一个名为 form 的属性，具有特定的参数
- fields 是一个对象，其键为字段名称，值为该字段的验证字符串，如果字段未在此处描述，则将被忽略。
- mail_to 是一个电子邮件地址，如果您想将条目发送到电子邮件地址，您应该在 Laravel 项目中配置邮件值。
```
{
  "form": {
    "mail_to": "contact@example.com",
    "fields": {
      "name": {
        "validation": "required|max:50"
      },
      "email": {
        "validation": "required|email"
      }
    }
  }
}
```

路由

此 Kusikusi Forms 包具有专门用于表单条目管理的路由。

接收表单条目

POST /form

用于管理条目的 API 端点。

GET /formentries/
GET /formentries/{formentry_id}
PATCH GET /formentries/{formentry_id}
DELETE GET /formentries/{formentry_id}

测试

使用以下命令运行测试：

vendor/bin/phpunit

更改日志

请参阅 CHANGELOG 以获取有关最近更改的更多信息。

贡献

请参阅 CONTRIBUTING 以获取详细信息。

致谢

安全

如果您发现任何与安全相关的问题，请通过 dev@cuatromedios 发送电子邮件，而不是使用问题跟踪器。

许可

MIT 许可证 (MIT)。有关更多信息，请参阅许可文件。

kusikusi / forms

维护者

详细信息