README

FormBuilder 示例

功能

生成表单、调查、民意测验、问卷（类 FormBuilder）

拖放 - 排序、编辑和删除项目
AJAX CRUD 操作
内置 RBAC 组件

表单渲染小部件（类 Form）

验证表单（动态模型）

将表单提交的数据存储在数据库中

表单列表（GridView）
创建表单后创建数据库表
删除表单后删除数据库表
向表单添加字段后添加表列
更改字段名称后重命名表列
从表单中删除字段后删除表列

安装 Form Builder

composer require pceuropa/yii2-forms

配置 Form Builder

确保您已正确配置 config 文件中的 db 应用组件，并运行以下命令

$ php yii migrate/up --migrationPath=@vendor/pceuropa/yii2-forms/migrations

在您的配置文件中添加以下代码

'modules' => [
    'forms' => [
          'class' => 'pceuropa\forms\Module',
     ],
]

使用方法

翻译工具的 URL

/forms/module/index                    // List of all forms                     
/forms/module/user                     // List user's forms
/forms/module/view                     // Preview form
/forms/module/create                   // Create form - FormBuilder 
/forms/module/update                   // Update form 
/forms/module/delete                   // Delete form

完整的 Form Builder 配置示例

'modules' => [
      'forms' => [
          'class' => 'pceuropa\forms\Module',
          'db' => 'db',
          'formsTable' => '{{%forms}}',
          'formDataTable' => 'form_',
          'sendEmail' => true, 
	  'testMode' => false, 
          'easyMode' => true,
          'emailSender' => 'info@email.net',
          'rules' => [
                [
                    'actions' => [ 'update', 'delete', 'clone'],
                    'allow' => true,
                    'roles' => ['updateOwnForm'],   // rule only owner can edit form
                ],
                [
                    'actions' => ['user'],
                    'allow' => true,
                    'roles' => ['user'],     // role only authenticated user can see user's forms
                ],
                [
                    'actions' => ['create'],
                    'allow' => true,
                    'roles' => ['@'],        // role only logged user can create form
                ]
            ]
      ]
],

'components' => [
	  'authManager' => ['class' => 'yii\rbac\DbManager',],
]

表单渲染小部件

use pceuropa\forms\Form;
echo Form::widget([
     'body' => '[[{"field": "input", "type": "text", "width": "col-md-5", "name": "email", "placeholder": "email"},{"field": "input", "name": "pass", "type": "text", "placeholder": "pass", "width": "col-md-5"},{"field": "submit", "width": "col-md-2", "backgroundcolor": "btn-info", "label": "Submit"}]]',
     'typeRender' => 'php'
     ]);

或

  echo Form::widget([
     'formId' => 1, // equivalennt 'form' => FormModel::findOne(1)->body
  ]);

配置 RBAC 组件

要使用生成器控制台，请将以下代码添加到控制台配置（console.php）

'controllerMap' => [
  'formsrbac' => [
      'class' => 'pceuropa\forms\migrations\RbacController',
  ],
],

要使用 RBAC，请勿忘记将以下代码添加到应用配置（web.php 或 main.php）

'components' => [
	  'authManager' => ['class' => 'yii\rbac\DbManager',],
]

在数据库中创建 rbac 表 yii migrate --migrationPath=@yii/rbac/migrations

创建 RBAC 规则和角色。将角色用户分配给所有用户。您可以在 SignupController 中添加分配角色的操作 php yii formsrbac/generate

测试

运行 PHP 测试

vendor/bin/codecept run -c vendor/pceuropa/yii2-forms

或

cd vendor/pceuropa/yii2-forms
../../bin/codecept run

在安装依赖项开始时运行 JavaScript 测试

cd vendor/pceuropa/yii2-forms
npm install

运行测试

cd vendor/pceuropa/yii2-forms
karma start
//or if you use karma localy
npm run test

例如：菜单

[
'label' => 'forms',
    'items' => [
        ['label' => 'List of all forms', 'url' => ['/forms/module/index']],
        ['label' => 'User\'s forms', 
            'url' => ['/forms/module/user'],
            'visible' => !Yii::$app->user->isGuest
        ],
        ['label' => 'Create form', 'url' => ['/forms/module/create']],
    ],
],

pceuropa / yii2-forms

维护者

详细信息