轻松创建测验！

特性

• 创建测验！
  • 加权答案测验（最多6个问题，结论按得分分类，如“你得到0到5分”，每个问题单选（单选框）或复选（复选框）答案！），
  • 解释性测验（最多4个问题，结论按最大符号数分类，如“你多数是◆”），
  • 通过管理员选项选择显示随机问题/答案！（或者不显示）
  • 管理员选项中还可以显示得分（对于加权答案测验）！（或者不显示）
• 创建重定向到您的测验的django-cms插件（测验可以通过特殊URL访问，默认情况下不能将cms插件添加到测验中）。
• （可选）将测验数据保存在您的数据库中（已开始的测验，完成的测验，结果）
• （可选）在测验末尾添加一般问题以收集更多信息！（（fr）部门，工作，年龄段，[...]）
• （可选）从保存的数据生成PDF。
• （可选）从保存的测验中导出数据。

警告！

不要使用版本< 3.0.0，它们不是生产就绪版本，并且存在许多问题。

安装

1. 安装包

   python3 -m pip install django-easy-quiz
   

2. 将这些应用添加到您的INSTALLED_APPS

   "filer",
   "ckeditor",
   "ckeditor_uploader",  # for hosting images in your ckeditor view, see below for a ready-to-use config
   "ckeditor_filebrowser_filer",
   "import_export",
   "django_easy_quiz",
   

3. 如果尚未添加，请将sessions中间件添加到您的设置中

   MIDDLEWARE = (
       # [...]
       "django.contrib.sessions.middleware.SessionMiddleware",
       # [...]
   )
   

4. 将这些URL添加到您的urls.py

   # main app urls
   path("quiz/", include("django_easy_quiz.urls")),
   # ckeditor-related urls
   path("ckeditor/", include("ckeditor_uploader.urls")),
   path("filer/", include("filer.urls")),
   path("filebrowser_filer/", include("ckeditor_filebrowser_filer.urls")),
   path("filebrowser_filer/filer_", include("ckeditor_filebrowser_filer.urls")),  # only add this line if you're using django-ckeditor-filebrowser-filer from the develop branch or our fork on the "various-fixes" branch
   

5. 迁移

   python3 manage.py migrate
   

6. 这就是全部了！

配置

Ckeditor配置

您需要在测验描述中配置 django-ckeditor 以使其工作。以下是一个可以直接粘贴到项目设置中的预配置代码片段：

CKEDITOR_UPLOAD_PATH = "uploads/"
CKEDITOR_IMAGE_BACKEND = "pillow"
CKEDITOR_THUMBNAIL_SIZE = (150, 150)
CKEDITOR_ALLOW_NONIMAGE_FILES = False
CKEDITOR_CONFIGS = {
  "default": {
    "language": "{{ language }}",
    "toolbar": "Simple",
    "toolbar_Simple": [
        ["Undo", "Redo"],
        ["Styles", "Format"],
        ["TextColor", "BGColor"],
        ["Subscript", "Superscript", "-", "RemoveFormat", "PasteText", "PasteFromWord", "FilerImage"],
        ["Link", "Unlink"],
        ["Source"],
    ],
    "autoParagraph": False,
    "colorButton_colors": "01b6ad,00b6ef,a0cd49,ffc01c,9d1a75,fff,000",
    "skin": "moono-lisa",
    "height": "600px",
    "extraPlugins": "filerimage",
    "removePlugins": "image"  # do not use the classic image plugin, use the one from django-ckeditor-filebrowser-filer
  }
}

您可以通过查看 django-ckeditor 文档 了解更多有关这些配置值的信息，并自定义它们。

在数据库中保存测验

在设置中添加 DJANGO_EASY_QUIZ_SAVE_QUIZZES_RESULTS=True（默认 False）。

显示“更多信息”问题

在设置中添加 DJANGO_EASY_QUIZ_GATHER_STATISTICS=True（默认 False）。

默认情况下，“更多信息”问题将在回答测验后显示在摘要页面上。

如果您想在测验过程中显示“更多信息”问题，请将设置中的 DJANGO_EASY_QUIZ_GATHER_STATISTICS_DURING_QUIZ 设置为 True（默认 False）。

下载包含测验信息的 pdf 文件

在设置中添加 DJANGO_EASY_QUIZ_SAVE_PDF（默认 False）。

仅在 DJANGO_EASY_QUIZ_SAVE_QUIZZES_RESULTS 为真时有效。需要 weasyprint。要编辑的模板在 django_easy_quiz/quiz_pdf.html 中。

您可以使用 DJANGO_EASY_QUIZ_PDF_FILE_NAME 更新 pdf 文件名（默认 _("quiz_summary.pdf")）。

您还可以使用 DJANGO_EASY_QUIZ_PDF_LOGO 更新 pdf 中的标志（默认 logo.png）。

如果您想对 pdf 进行更多更改，您可以在 templates/django_easy_quiz 中创建一个名为 quiz_pdf.html 的文件，并更新 html 文件（使用 weasyprint 渲染为 pdf 文件）。

添加“重新启动测验”按钮

在设置中添加 DJANGO_EASY_QUIZ_RELAUNCH_BUTTON（默认 False）。