pdir / contao-survey
Contao 扩展包，用于创建问卷调查和在线调查
Requires
- php: ^8.0
- contao/core-bundle: ^4.9
- doctrine/dbal: ^2.5 || ^3.0
- hschottm/contao-textwizard: ^3.2
- mvo/contao-group-widget: ^1.4
- sonata-project/exporter: ^1.0
- symfony/polyfill-php80: ^v1.26
Requires (Dev)
- bamarni/composer-bin-plugin: ^1.5
- contao/easy-coding-standard: ^3.0
- contao/manager-plugin: ^2.0
- phpstan/phpstan: ^1.10
- phpstan/phpstan-phpunit: ^1.1
- phpstan/phpstan-symfony: ^1.2
- phpunit/phpunit: ^7.1 || ^8.4 || ^9.5
- symfony/phpunit-bridge: ^4.4 || ^5.1
- terminal42/notification_center: 1.6.0
Conflicts
- contao/manager-plugin: <2.0 || >=3.0
- dev-master
- 3.6.1
- 3.6.0
- 3.5.0
- 3.4.3
- 3.4.2
- 3.4.1
- 3.4.0
- 3.3.0
- 3.2.12
- 3.2.11
- 3.2.10
- 3.2.9
- 3.2.8
- 3.2.7
- 3.2.6
- 3.2.5
- 3.2.4.1
- 3.2.4
- 3.2.3
- 3.2.2
- 3.2.1
- 3.2.0
- 3.2.0-RC1
- dev-fix-tan-survey
- dev-MDevster-patch-1
- dev-fix/413/useArrayUtils
- dev-heimrichhannot-fix/patch-1
- dev-heimrichhannot-fix/php8
- dev-feature/cm/add_question_slider
This package is auto-updated.
Last update: 2024-09-18 12:26:10 UTC
README
pdir 分支
原始包
contao-survey
一个用于创建在线调查的 contao 扩展包。支持单选题、开放式问题、矩阵问题和恒定总和问题。调查可以作为匿名调查或针对特定成员的个性化调查进行。匿名调查可以仅限于 TAN 访问以运行代表性调查。
调查结果可以作为累积和详细结果提供，并可选择导出结果。
导出将为 csv 格式。如果安装了 hschottm/contao-xls-export 扩展包，导出将为 Excel xls 格式；如果安装了 phpoffice/phpspreadsheet 扩展包，导出将为 Excel xlsx 格式。
特别感谢 Georg Rehfeld 为其详细的调查导出和调查工具的改进所做的开发。
安装和使用
- 安装该包。
- 新增了“调查”菜单项。
- 将新的“调查”内容元素直接添加到您的页面上。
3.6.0 版本功能
从版本 3.6.0 开始增加了通知中心支持。还增加了新的通知中心令牌和新字段。
已添加以下 NC 令牌
- ##survey_title##
- ##survey_link##
- ##survey_duration##
- ##survey_recipient_email##
- ##survey_recipient_firstname##
- ##survey_recipient_lastname##
- ##survey_recipient_fullname##
目前针对这些令牌实现了德语和英语翻译。
已完全修订了 TAN 的生成，并提高了某些与 TAN 相关操作的安全性。
- 当生成 TAN 时，系统现在区分 个体调查类型。
- 单个请求可以生成的“与成员无关”的 TAN 数量现在限制为 999，可以使用环境变量 MAX_ALLOWED_TAN 进行配置。
- 以前，可以通过单个请求生成无限（或非常大量）的 TAN，这可能导致 PHP 进程崩溃。在这里，也必须谨慎配置环境变量！
- 在大多数情况下，您不需要超过 999 个 TAN
当 NC 安装时，可以使用通知进行特定调查。
- 当然，通知必须 事先 进行配置。
- 邀请和提醒应与 成员组 结合使用。
- 根据用户的指示，系统 向 调查的所有 参与者 发送 邀请和提醒。 这可以包括多个组！
- 属于多个组的成员 只会 一次性 被通知。
- 如果参与者不受限于一个组，系统 将向所有成员发送邀请！
- 系统考虑了调查参与者是否 已经被邀请 以及他们 何时以及多少次 被提醒的情况。
- 因此，已经被邀请的参与者不会再次被邀请，已经被提醒的参与者会被 记录。
- 已发送的提醒数量会被计数，目前 没有限制。
- 已经开始或完成调查的参与者 将不会被再次邀请或提醒。
- 发送邀请或提醒始终需要将调查与调查页面之间建立关联，以便为每个参与者分配一个个性化的链接。
- 邀请和提醒应以单一通知的形式发送——而不是通过BCC发送。优点是每个通知中都有所有与订阅者相关的数据。缺点是必须逐个发送多个/许多通知，这会耗费时间和资源。
邀请模板的一个简单示例
将它们复制并粘贴到您的通知中。
We would like to invite you to participate in the following survey: ##survey_title##
the following tokens can be used:
survey_title: ##survey_title##
survey_link: ##survey_link##
survey_duration: ##survey_duration##
survey_recipient_email: ##survey_recipient_email##
survey_recipient_firstname: ##survey_recipient_firstname##
survey_recipient_lastname: ##survey_recipient_lastname##
survey_recipient_fullname: ##survey_recipient_fullname##`
已添加新的 surveyDuration 字段。现在可以包括调查的估计持续时间（以分钟为单位，最大255分钟）。要么是估计的，要么在自我测试期间由调查创建者确定持续时间。
许可证
Font Awesome
完整的图标集、示例和文档可以在以下网址找到： https://fontawesome.com/ Font Awesome许可证文件包含在本包中的 LICENSE_FONT_AWESOME
- Font Awesome字体许可在SIL开放字体许可下 - http://scripts.sil.org/OFL
- Font Awesome CSS、LESS和SASS文件许可在MIT许可下 - https://open-source.org.cn/licenses/mit-license.html
- Font Awesome图标许可在CC BY 3.0许可下 - http://creativecommons.org/licenses/by/3.0/
- Font Awesome 3.0中不再需要归属，但非常感谢：“Font Awesome by Dave Gandy - http://fortawesome.github.com/Font-Awesome”
贡献者
由贡献者创建 contributors-img。
开发人员注意事项
在提交前运行
vendor/bin/ecs check src tests
vendor/bin/phpstan analyse
vendor/bin/phpunit --colors=always
使用包中包含的调查表测试您的更改。
在版本3.4.3中，我们已将调查表添加到包中，以允许一致测试。您可以在 _misc 文件夹中的 reference-survey.sql 文件中找到这些表。因此，如果您想以可重复的方式测试更改后的代码的行为，请使用这些表。
如果您更改了调查表，请也将它们提交到 reference-survey.sql，以便开发人员可以针对此参考调查测试他们自己的代码。
将表加载到您的数据库中，并激活包含五个问题页面和一个结果页面的Survey 1。目前，您需要手动将这些表加载到数据库中，但我们正在努力使测试更加自动化。
问题页面涵盖了该包目前提供的所有问题。结果页面显示了问题页面的结果。然而，目前不幸的是，结果页面仍有错误。