Offline quiz activity: Difference between revisions

From MoodleDocs
(copied from 2.6 page)
 
 
(20 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{stub}}
{{Infobox plugin
{{Infobox plugin
|type = activity
|type = activity
|entry = https://moodle.org/plugins/view.php?plugin=qtype_easyostructure
|entry = https://moodle.org/plugins/view/mod_offlinequiz
|tracker = https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz
|tracker = https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz
|discussion = https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz
|discussion = https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz
Line 9: Line 7:
|float = right
|float = right
}}
}}
{{Note|You can find the most up-to-date English and German documentation for this plugin in the AMC website at http://www.academic-moodle-cooperation.org/en/module/offline-quiz/. This page is intended for users who clicked on the 'Moodle Docs for this page' link and for Moodle users of languages other than English and German (IN OTHER LANGUAGES  at the bottom of this page).}}
[[File:MC Offline quiz module thumbnail.png]]
[[File:MC Offline quiz module thumbnail.png]]
The Moodle MC Offline quiz module adds paper-and-pencil multiple-choice quizzes to Moodle. In offline quizzes students mark answers to questions on a sheet of paper (the answer form). The students' answer forms are evaluated and graded automatically by the offline quiz module.  
The Moodle MC Offline quiz module adds paper-and-pencil multiple-choice quizzes to Moodle. In offline quizzes students mark answers to questions on a sheet of paper (the answer form). The students' answer forms are evaluated and graded automatically by the offline quiz module.  
Line 31: Line 31:


==Author==
==Author==
Juergen Zimmer, from the [http://www.academic-moodle-cooperation.org Academic Moodle Cooperation] of several Vienna Universities.
Thomas Wedekind, from the [http://www.academic-moodle-cooperation.org Academic Moodle Cooperation] of several Austrian Universities.


==Moodle versions==
==Moodle versions==
This module is available from [https://moodle.org/plugins/view.php?plugin=mod_offlinequiz the Moodle plugins database] for Moodle 2.6 only.
* This module is available from [https://moodle.org/plugins/view.php?plugin=mod_offlinequiz the Moodle plugins database] for Moodle 2.6 and newer branches
 
 
[[File:Offline quiz edit offline quiz.jpg|600px]]


There seems to be a version for Moodle 2.5 in [https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz/tree/MOODLE_25_STABLE Github].
[[File:Offline quiz add random questions.jpg|600px]]


There seems to be a version for Moodle 2.2 in [https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz/blob/5dbf36388eea93f09c3bedfb06dcc77b9e993f8e/README.txt Github].
[[File:Offline quiz add a new question.jpg|600px]]


There will probably be a stable version for Moodle 2.7 by the end of 2014.


==Translations available==
==Translations available==
The Moodle 2.6 version has Mexican Spanish and German language translations made in [https://lang.moodle.org/local/amos/ AMOS].
There are French, German and Mexican Spanish language translations made in [https://lang.moodle.org/local/amos/ AMOS].


==Installation==
==Installation==
Line 50: Line 52:


The automatic analysis of questionnaires requires the activation of an appropriate cronjob (see README.txt).
The automatic analysis of questionnaires requires the activation of an appropriate cronjob (see README.txt).
===Cronjob===
Before Moodle 3.2 there was an additional cron job required for the evaluation of answer forms. This cron job is no longer necessary, unless you intend to run the cron job on a separate server.
This should look similar to the following:
    */10 * * * * DATE=`date +\%Y\%m\%d`; php <your moodle root dir>/mod/offlinequiz/cron.php --cli=1 >> /var/log/moodle/cron-olq.log.$DATE 2>&1
   
but has to be adjusted to your environment. Since the evaluation of answer forms usually takes a lot of system resources, it is recommended to run this cronjob on a separate application server to take load from the frontend servers.
===Website settings===
In the website admin settings for the module 
        Site Administration -> Plugins -> Activity modules -> Offline Quiz
One can choose the default settings for the module and also determine the University Logo that will appear on the top of the answer forms (Logo URL).
The user identification has to be set to a formula describing how the user IDs can be retrieved from the digits marked by the students on the answer forms.
For example:
A user identification formula 
        a[7]=username
means that the students mark a 7 digit number on the answer form. A concatenation of the letter 'a' and that number denotes the 'username' of the user in Moodle's 'user' table.
A formula
        b[5]cd=idnumber
means that the students mark a 5 digit number on the answer form. A concatenation of the letter 'b', the marked number,  and the string 'cd' denotes the 'idnumber' of the user in Moodle's 'user' table.


==Admin settings==
==Admin settings==
Line 70: Line 102:
[[File:Offline_quiz_screenshot.png|600px]]
[[File:Offline_quiz_screenshot.png|600px]]


==Problems when using mathematical elements in an Offline Quiz==
According to [https://moodle.org/mod/forum/discuss.php?d=391368 this post]:
I import questions from my bank, where the title or responses contain LateX formulas to create my forms.
When I use the question in a classical quiz, or just preview the lists of questions in Offline Quiz, there are no problems.
But when I generate the forms in Offline Quiz, the pictures of formulas have all disappeared !
All formulas are ok.
===The cause of the problem===
Apparently the default install in recent distributions disables converting postscript to images because of potential security issues.
I found the file policy.xml in the ImageMagick configuration directory and removed the last few lines of the file where it says it is disabling postscirpt.
After that, retested filter, deleted and recreated offline quiz form, and everything worked as expected.
===The fix for this issue===
* The solution is to remove these lines in the file policy.xml in the ImageMagick configuration directory:
  <!-- disable ghostscript format types -->
  <policy domain="coder" rights="none" pattern="PS" />.
  <policy domain="coder" rights="none" pattern="EPS" />.
  <policy domain="coder" rights="none" pattern="PDF" />
  <policy domain="coder" rights="none" pattern="XPS" />.


==Author==
==Contact==
[https://moodle.org/user/profile.php?id=1765078|  AMC Academic Moodle Cooperation]
In case you have any questions regarding this module you can post questions on the official github repository: https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz


==See also==
This information was copied from http://www.academic-moodle-cooperation.org/en/modules/offline-quiz/  
This information was copied from http://www.academic-moodle-cooperation.org/en/modules/offline-quiz/  


[[Category:Quiz]]
[[Category:Quiz]]
[[Category:Questions]]
[[Category:Questions]]
[[Category:AMC Academic Moodle Cooperation]]


[[es:mod/offlinequiz/mod]]
[[es:Actividad de examen fuera-de-línea]]

Latest revision as of 17:59, 4 December 2019

Note: You can find the most up-to-date English and German documentation for this plugin in the AMC website at http://www.academic-moodle-cooperation.org/en/module/offline-quiz/. This page is intended for users who clicked on the 'Moodle Docs for this page' link and for Moodle users of languages other than English and German (IN OTHER LANGUAGES at the bottom of this page).


MC Offline quiz module thumbnail.png The Moodle MC Offline quiz module adds paper-and-pencil multiple-choice quizzes to Moodle. In offline quizzes students mark answers to questions on a sheet of paper (the answer form). The students' answer forms are evaluated and graded automatically by the offline quiz module.

More precisely, a complete offline quiz consists (at least) of the following steps:

  • A teacher creates an offline quiz in Moodle and adds multiple-choice questions, all-or-nothing multiple-choice questions or description questions (text) to the quiz. This is very similar to creating online quizzes (standard Moodle quizzes).
  • From the question lists the teacher creates question sheets and answer forms as PDF (DOCX) documents using the module.
  • The question sheets and answer forms are handed out to students for the actual quiz. The students mark the answers they think are correct in the answer form.
  • The teacher scans the filled-in answer forms and uploads the resulting images into the offline quiz. The scanned answer forms are evaluated and graded automatically by the module.
  • If necessary, the teacher corrects errors that might have occurred due to mistakes made by the students or due to bad scan quality.

After results have been created in an offline quiz, students can review their result as usual. If the teacher allows it, students can also see the scanned answer forms and which markings have been recognised as crosses.

The module supports up to six groups which are not related to Moodle course groups. Each group can contain a different set of questions in a different order. Separate question sheets and answer forms are created for the different offline quiz groups.

The module also supports lists of participants which are useful for checking which students actually took part in the exam. Lists of participants are pre-filled with students in Moodle. PDF versions of those lists can be created in the module for easy marking during the exam. The marked lists can be uploaded and evaluated automatically.

Example

The offline quiz module is used intensively at different Austrian universities for mass exams. Hundreds of students can be easily examined at the same time (given enough seating space in lecture halls) without the need for expensive e-testing equipment.

Author

Thomas Wedekind, from the Academic Moodle Cooperation of several Austrian Universities.

Moodle versions


Offline quiz edit offline quiz.jpg

Offline quiz add random questions.jpg

Offline quiz add a new question.jpg


Translations available

There are French, German and Mexican Spanish language translations made in AMOS.

Installation

Copy the module code directly to the "mod/offlinequiz" directory. Open the messages page in the administration area to automatically start the installation.

The automatic analysis of questionnaires requires the activation of an appropriate cronjob (see README.txt).

Cronjob

Before Moodle 3.2 there was an additional cron job required for the evaluation of answer forms. This cron job is no longer necessary, unless you intend to run the cron job on a separate server.

This should look similar to the following:

    */10 * * * * DATE=`date +\%Y\%m\%d`; php <your moodle root dir>/mod/offlinequiz/cron.php --cli=1 >> /var/log/moodle/cron-olq.log.$DATE 2>&1
    

but has to be adjusted to your environment. Since the evaluation of answer forms usually takes a lot of system resources, it is recommended to run this cronjob on a separate application server to take load from the frontend servers.

Website settings

In the website admin settings for the module

        Site Administration -> Plugins -> Activity modules -> Offline Quiz

One can choose the default settings for the module and also determine the University Logo that will appear on the top of the answer forms (Logo URL).

The user identification has to be set to a formula describing how the user IDs can be retrieved from the digits marked by the students on the answer forms.

For example:

A user identification formula

       a[7]=username

means that the students mark a 7 digit number on the answer form. A concatenation of the letter 'a' and that number denotes the 'username' of the user in Moodle's 'user' table.

A formula

       b[5]cd=idnumber 

means that the students mark a 5 digit number on the answer form. A concatenation of the letter 'b', the marked number, and the string 'cd' denotes the 'idnumber' of the user in Moodle's 'user' table.

Admin settings

As an administrator you can set the default values instance-wide on the settings page for administrators in the MC Offline quiz module.

  • formula for participant identification (text field)
  • mix questions (checkbox)
  • mix answers (checkbox)
  • logo URL (text field)
  • copyright indication (checkbox)
  • settings for exam inspection (checkbox)
  • decimal places (drop down)
  • paper's white level (drop down)
  • 1-click inscription (checkbox)
  • role for inscription (drop down)
  • saving days (text field)

Screenshot of the module

Offline quiz screenshot.png

Problems when using mathematical elements in an Offline Quiz

According to this post:

I import questions from my bank, where the title or responses contain LateX formulas to create my forms. 
When I use the question in a classical quiz, or just preview the lists of questions in Offline Quiz, there are no problems. 
But when I generate the forms in Offline Quiz, the pictures of formulas have all disappeared !
All formulas are ok.

The cause of the problem

Apparently the default install in recent distributions disables converting postscript to images because of potential security issues. 
I found the file policy.xml in the ImageMagick configuration directory and removed the last few lines of the file where it says it is disabling postscirpt. 

After that, retested filter, deleted and recreated offline quiz form, and everything worked as expected.

The fix for this issue

  • The solution is to remove these lines in the file policy.xml in the ImageMagick configuration directory:
 <policy domain="coder" rights="none" pattern="PS" />.
 <policy domain="coder" rights="none" pattern="EPS" />.
 <policy domain="coder" rights="none" pattern="PDF" />
 <policy domain="coder" rights="none" pattern="XPS" />.

Contact

In case you have any questions regarding this module you can post questions on the official github repository: https://github.com/academic-moodle-cooperation/moodle-mod_offlinequiz

See also

This information was copied from http://www.academic-moodle-cooperation.org/en/modules/offline-quiz/