oveleon / contao-advanced-form
Contao开源CMS的高级表单扩展
Requires
- php: ^7.4 || ^8.0
- codefog/contao-haste: ~4.25
- contao/core-bundle: ^4.9
- symfony/expression-language: >=4.4
Requires (Dev)
- contao/manager-plugin: ^2.0
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
- terminal42/contao-mp_forms: *
README
contao高级表单包为表单添加了新的表单字段（表单页面），可用于具有条件的多页表单
兼容Contao 4.9及更高版本（PHP ^7.4和PHP 8），不能与Terminal24的MP_Forms一起安装
功能
- 可配置的带有条件的表单页面/页面切换表单字段，用于提交的值
- 访客模式，仅对访客显示特定表单页面
- 条件不满足时不会显示表单页面
- 将特定表单页面收集的所有数据发送出去
- 与所有Contao表单字段兼容
如何安装包
使用以下命令安装包
composer require oveleon/contao-advanced-form
安装contao-advanced-form-bundle后，应运行contao安装以添加新字段。
此扩展不能与Terminal24的MP_Forms同时使用或安装
Contao高级表单如何工作
安装完成后，您将在Contao表单中可以使用一个名为“表单页面”的新字段类型，它充当创建的表单字段的分隔符（例如：单选按钮菜单、文本区域等）。
“表单页面”表单字段充当页面切换器，如果满足先前提交的值中的条件，您将被重定向到它。
初始设置
-
像往常一样设置表单并创建表单字段
-
在应分页的表单字段之间创建“表单页面”字段
-
在表单页面中添加“提交按钮标签”
-
如果想要一个按钮回到上一页，也可以添加“返回按钮标签”
条件的高级设置
-
按照上述初始设置进行操作
-
在应满足条件的表单页面之上创建可提交的值（例如：单选按钮菜单）
-
激活“添加条件”复选框并将条件写入其中
重要信息
创建表单页面
-
第一个表单页面将始终由第一个表单字段和第一个“表单页面”字段分隔。
-
后续表单页面通过将其包裹在“表单页面”字段中创建。
-
您表单中的最后一个字段必须是“表单页面”字段，否则将显示所有表单字段（这对于通过表单进行调试非常有用）。
条件
页面切换器（表单页面）内的条件始终适用于以下
FOLLOWING
表单字段，直到下一个页面切换器（表单页面）
语法
${Field name of radio button menu} == '{Value of radio button menu}'
具有字段名“Example1”和提交值“Option1”的单选按钮菜单将跳转到此页面切换器（表单页面）。
$Example1 == 'Option1'
您可以根据需要设置复杂的条件以显示特定的表单页面。以下PHP函数可以在条件中使用
- floatval
- strval
- intval
- in_array
- str_contains
如果需要更多功能，请随意创建一个特性问题。
按钮
提交按钮和后退按钮已设置为
上一页
表单页面。它们将适用于页面切换（表单页面）上方的表单字段。
类
类将始终用于
上一页
表单页面。它们将适用于页面切换（表单页面）上方的表单字段。
保护和隐藏表单页面
使用选项 ‘保护表单页面’ 和 ‘仅向访客显示’，始终适用于
上一页
表单页面。它们将适用于页面切换（表单页面）上方的表单字段。
选项
支持
我们 只提供 对 错误和特性请求 的支持；请只发布关于这两个主题的问题。
如果您需要帮助实现 Contao Advanced Form 或您刚开始使用 Contao，请访问我们的 网站，访问 Contao 社区 或 Contao Slack，您将在那里找到更多帮助。
这有助于我们更快地解决与该插件相关的问题。
许可
本项目采用 AGPL-3.0 许可协议——有关更多详细信息，请参阅 LICENSE。
赞助
如果您觉得这个插件很有用，请考虑 赞助我们，以帮助我们贡献时间和进一步开发这个及其他开源项目。感谢您的支持！ - Oveleon。