View source for Quiz settings

{{Quiz}}
Creating a new quiz is a two-step process. In the first step, you create the quiz activity and set its options which specify the rules for interacting with the quiz. In the second step you add questions to the quiz.
This page describes the options you can set for the quiz activity. The page [[Building Quiz]] describes how to set up the questions for the quiz.

==Quiz administration==
When you first set up your quiz from ''Add an activity or resource > Quiz'', (or, if you don't have this link, the dropdown ''Add an activity>Quiz'') you will get the following settings, (which can also be changed later in the Edit Settings link of the Quiz administration settings block) All settings may expanded by clicking the "Expand all" link top right.

[http://www.test.com link title]==General==
{|
|[[File:quizgeneral25.png|thumb|General settings expanded by default]]
|}
;Name
:This is the standard name field. This name will appear on the home page of the course, navigation menu and other places which will show or provide links to this quiz.

;Description
:Describe the purpose of the glossary and provide instructions or background information, links etc. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.

;'''Display description on course page'''
:If ticked, the quiz description will appear on the course page directly under the quiz name.

==Timing==
(These settings are collapsed by default)
{|
|[[File:quiztiming25.png|thumb|Timing settings expanded]]
|}

;Open the quiz
:You can specify times when the quiz is accessible for people to make attempts. Before the opening time the quiz will be unavailable to students. They will be able to view the quiz introduction but will not be able to view the questions. Quizzes with start times in the future diasplay both the open and close date for students.

Note: You can make the quiz available at different times for different groups or users in the Group or User override sections of the Quiz Administration settings block.

;Close the quiz
:After the closing time, the students will not be able to start new attempts. Answers that the student submits after the quiz closing date will be saved but they will not be marked. 


: Even after the quiz has closed students will still be able to see the quiz description and review their attempts. What exactly they will see depends on the settings you choose for review options (see below).
;Time limit
:By default, quizzes do not have a time limit, which allows students as much time as they need to complete the quiz. If you do specify a time limit, several things are done to try and ensure that quizzes are completed within that time:
{|
|[[File:quiz timer.png|thumb|Navigation block showing quiz timer]]
|}

# A countdown timer is shown in the quiz navigation block 
# When the timer has run out, the quiz is submitted automatically with whatever answers have been filled in so far 
# If a student manages to cheat and goes over the allotted time, no marks are awarded for any answers entered after the time ran out

Note: You can make the quiz available last a different period of time for different groups or users in the Group or User override sections of the Quiz Administration settings block (see below).

;When time expires..

There are three options as to what will happen when the time limit is up. Choose the one you need from the dropdown menu:
{|
|[[File:quiztiming25.png|thumb|right|Timing options]]
|}

If you select "''there is a grace period...''" then you can check the box to enable the "Submission grace period" and specify a period of time during which learners may still submit the quiz after the time is up.

===Examples of how timing is handled===

#A student starts a quiz at noon. The quiz has a one-hour time-limit, and a 1 hour delay between attempts. The student gets distracted, and so actually does not submit (using the overdue handling) until 1:30pm. ''They are allowed to start their second attempt at 2. pm''
#The quiz count-down timer submits a student's quiz attempt at the last second when time expires. Because the server is heavily loaded, it takes 30 seconds to process the student's attempt. ''The submission is accepted nonetheless.''
#Same situation as above but with a 120 second delay: ''The submission is rejected.''
#The delay is not because of server load but because the student found a way to cheat the timer. ''Moodle cannot know what causes a delay.The behaviour is controlled by the admin setting(quiz | graceperiodmin), 60 seconds by default.''
#A student is a member of 3 groups,all of which have different override settings. Which limits will apply to this student? ''If there is any user-specific override, then that is used, and the group overrides for that setting are not used at all. Otherwise, if there are multiple group overrides, the most generous values are used (the earliest open date, the latest close date, the longest time limit, the most number of attempts, and the student can type any of the passwords).''

==Grade==
(These settings are collapsed by default)
{|
|[[File:quizgrade25.png|thumb|Grade settings expanded]]
|}

;Grade category
If you have categories in your gradebook, select the one you wish the quiz to be in here.
;Attempts allowed
:Students may be allowed to have multiple attempts at a quiz. This can help make the process of taking the quiz more of an educational activity rather than simply an assessment. If the quiz is randomized then the student will get a new version for each attempt. This is useful for practice purposes.

Note: You can change the allowed number of attempts for different groups or users in the Group or User override sections of the Quiz Administration settings block.

;Grading method
:When multiple attempts are allowed, there are different ways you can use the grades to calculate the student's final grade for the quiz.
* Highest grade - the final grade is the highest (best) grade in any attempt
* Average grade - the final grade is the average (simple mean) grade of all attempts
* First grade - the final grade is the grade earned on the first attempt (other attempts are ignored)
* Last grade - the final grade is the grade earned on the most recent attempt only

==Layout==
(These settings are collapsed by default)
{|
|[[File:quizlayout25.png|thumb|Layout settings expanded]]
|}

;Question order
:If 'Shuffled randomly' is selected, then the order of questions in the quiz will be randomly shuffled each time a student starts a new attempt at the quiz. The intention is to make it a little harder for students to copy from each other.

;New page
:For longer quizzes it makes sense to stretch the quiz over several pages by limiting the number of questions per page. When adding questions to the quiz, page breaks will automatically be inserted according to the setting you choose here. However, you will also be able to move page breaks around by hand later on the editing page.
:'''Note that changing this setting has no effect on questions you have already added to the quiz'''. The setting will only apply to questions you add subsequently. To change the page breaks in an existing quiz, you need to go to the quiz editing screen, tick the 'Show page breaks' checkbox, then use the repaginate control.

;Navigation method (available by clicking ''Show More'')

By choosing ''Sequential'' instead of ''Free'', the teacher is forcing the student to progress through the questions in order without being able to go back to a previous question or skip to a later one.

==Question behaviour==
(These settings are collapsed by default)
{|
|[[File:quizbehaviour25.png|thumb|Question behaviour settings expanded]]
|}
;Shuffle within questions

If set to 'yes', then each time the student takes a quiz the parts of the question will be shuffled randomly.
;How questions behave
* Deferred feedback - Students must enter an answer to each question and then submit the entire quiz, before anything is graded or they get any feedback.
* Adaptive mode and Adaptive mode (no penalties) - Allows students to have multiple attempts at the question before moving on to the next question. The question can adapt itself to the student's answer, for example by giving some hints before asking the student to try again.
*Interactive mode - After submitting one answer, and reading the feedback, the student has to click a 'Try again' button before they can try a new response. Once the student has got the question right, they can no longer change their response. Once the student has got the question wrong too many times, they are just graded wrong (or partially correct) and get shown the feedback and can no longer change their answer. There can be different feedback after each try the student makes. 
*Immediate feedback - Similar to interactive mode in that the student can submit their response immediately during the quiz attempt, and get it graded. However, they can only submit one response, they cannot change it later. 
*Deferred feedback or Immediate feedback with '''Certainty-based marking''' ('''CBM''') - With CBM, the student does not only answer the question, but they also indicate how sure they are they got the question right. The grading is adjusted by the choice of certainty, so that students have to reflect honestly on their own level of knowledge in order to get the best mark.  See the ''See Also'' section below for an example quiz using CBM and a blog post explaining the philosophy.

''Note:'' There is also an option "Manual grading" which can be enabled from A''dministration>Site administration>Plugins>Question behaviour'' This causes all questions in the quiz to require manual grading.
===Certainty-based marking===
When a student answers a question they also have to state how sure they are of the answer: not very (less than 67%); fairly (more than 67%) or very (more than 80%). Their grading is then ajusted according to how certain they are, which means that for example if they answered correctly but were only guessing, their mark is adjusted from 1 to 0.33. If they answered wrongly but were very sure, their mark is adjusted from 0 to -2. (See also the forum discussion: [https://moodle.org/mod/forum/discuss.php?d=225920 CBM too harsh?]

{|
| [[File:cbm03.png|thumb|correct answer; very sure]]
| [[File:cbm05.png|thumb|correct answer; fairly sure]]
| [[File:cmb04.png|thumb|correct answer; not very sure]]
| [[File:cbm01.png|thumb|wrong answer; very sure]]
| [[File:cbm99.png|thumb|wrong answer; not very sure]]
|}


;Each attempt builds on the last (available by clicking "Show more")
:If multiple attempts are allowed and this setting is set to Yes, then each new attempt contains the results of the previous attempt. This allows the student on the new attempt to concentrate on just those questions that were answered incorrectly on the previous attempt. If this option is chosen then each attempt by a particular student uses the same questions in the same order, independent of randomization settings. To show a fresh quiz on every attempt, select No for this setting.

==Review options==
(These settings are collapsed by default)
{|
|[[File:quizreviewoptions25.png|thumb|Review options expanded]]
|}

This section controls what information students will be shown when they review their past attempts at the quiz, and during the attempt in adaptive mode.  It is a matrix with check boxes.

The various pieces of information that can be controlled are:
; The attempt: Will show how the student responded to each question.
; Whether correct: Displays whether the students response to each question is correct or incorrect.
; Marks:  Reveals the marks awarded to the student and the grade for the quiz.
; Specific feedback: Will show the feedback for the response to the answer as set when adding the question to the quiz. Each response to a question can have feedback for both correct and incorrect answers.
; General feedback: Displays the general feedback for the whole question as set when adding the question to the quiz. You can use the general feedback to give students some background to what knowledge the question was testing. 
; Right answer:  Reveals the correct answer to each question, whether the student answered correctly or not (See note below).
; Overall feedback: Displays feedback for the entire quiz as set in the quiz settings (See note below).

For each of the above items, you can determine the timeframe when the students will see them:
; During the attempt : is only available when ''‘How questions behave’'' has been set to ''‘Immediate feedback’'', ''‘Immediate feedback with CBM’'' and ''‘Interactive with multiple tries’''. If set to one of these options then a ''‘Check’'' button will appear below the answer and when clicked the student will submit that response and then receive immediate feedback.
; Immediately after the attempt : means within 2 minutes of the student clicking "submit all and finish". 
; Later, while the quiz is still open : means after 2 minutes, but before the close date (if the quiz does not have a close date, this phase never ends).
; After the quiz is closed : means what it says (you never get here for quizzes without a close date).

:''Tip:'' Checking any of the boxes in the timeframe row, will reveal the test to the student. For example, to allow students to see their quiz immediately after taking it but not later, make sure none of the boxes in "Later" or "After" rows are checked.  The student will be able to see their grade but not get into the quiz.

Note: Currently, the Answers display is a bit inconsistent between different question types. For example, the matching question type shows students which of their responses are correct, but does not tell them the right answer for the ones they got wrong. The short answer and multiple choices question types do tell the student what the correct answer is.

Users with the capability 'View hidden grades' [[Capabilities/moodle/grade:viewhidden|moodle/grade:viewhidden]] (typically teachers and administrators) are not affected by these settings and will always by able to review all information about a student's attempt at any time.

In your list of review options, you must have 'The attempt' (the first option in the lists) selected  before you can enable the options to show 'Whether correct', 'Specific feedback', 'General feedback', and 'Right answer'. If you choose not to let the students review the attempt, your only options are to display 'Marks' and 'Overall feedback'.

==Display==
(These settings are collapsed by default)
{|
|[[File:quizdisplay25.png|thumb|Display settings expanded]]
|}

;Decimal places in grades
:This option determines how many digits will be shown after the decimal point when the grade is displayed. A setting of 0 for example means that the grades are displayed as integers. This setting is only used for the display of grades, not for the display or marking of answers.

==Extra restrictions on attempts==
(These settings are collapsed by default nd are available by clicking "Show more")
{|
|[[File:quizextrarestrictionsonattempts25.png|thumb|Extra restrictions settings expanded]]
|}

;Require password
:This field is optional. 

:If you specify a password in here then participants must enter the same password before they are allowed to make an attempt on the quiz. This is useful to give only a selected group of students access to the quiz.

;Require network address
:This field is optional.

:You can restrict access for a quiz to particular subnets on the LAN or Internet by specifying a comma-separated list of partial or full IP address numbers. This is especially useful for a proctored (invigilated) quiz, where you want to be sure that only people in a certain room are able to access the quiz. For example: 192.168. , 231.54.211.0/20, 231.3.56.211

:There are three types of numbers you can use (you can not use text based domain names like example.com): 

# Full IP addresses, such as 192.168.10.1 which will match a single computer (or proxy). 
# Partial addresses, such as 192.168 which will match anything starting with those numbers. 
# CIDR notation, such as 231.54.211.0/20 which allows you to specify more detailed subnets. 

:Spaces are ignored.

;Enforced delay between attempts
:These two  fields are optional.

:You can set a time (from seconds to weeks) between the first and second attempt of a quiz. You can also (or alternatively) set a time from seconds to weeks for subsequent attempts after the second attempt. Thus, you might allow a student to take the quiz twice immediately with no delay, but if they want to improve their score with a third attempt, they are forced to wait a week and use the time for extra revision.

;Browser security
:This is by default an advanced field, visible by clicking "Show advanced".
:The options in this section offer various ways to try to restrict how students may try to 'cheat' while attempting a quiz. However, this is not a simple issue, and what in one situation is considered 'cheating' may, in another situation, just be effective use of information technology. (For example, the ability to quickly find answers using a search engine.)

::Note also that this is not just at problem of technology with a technical solution. Cheating has been going on since long before computers, and while computers make certain actions, like copy and paste, easier, they also make it easier for teachers to detect cheating - for example using the quiz reports. The options provided here are not fool-proof, and while they do make some forms of cheating harder for students, they also make it more inconvenient for students to attempt the quizzes, and they are not fool-proof.

:'''Full screen pop-up with some JavaScript security'''

:There is a limit to what the quiz, which runs on a web server, can do to restrict what the student sitting at their computer can do while attempting the quiz. However, this option does what is possible:

:* The quiz will only start if the student has a JavaScript-enabled web-browser.
:* The quiz appears in a fullscreen popup window that covers all the other windows and has no  course navigation controls.

{|
|[[File:seb24.png|thumb|Student view of quiz question with full screen popup. (Click to see enlarged)]]
|}
:* The students are prevented, as far as is possible, from using facilities like copy and paste.
:* This setting does not work well with the MyMobile theme for mobile devices included in the standard installation.  In particular, quiz time limits do not function correctly (MDL-32047).

:'''Require the use of Safe Exam Browser'''

:This option will only appear if your administrator has enabled it in ''Settings > Site administration > Development > Experimental > Experimental settings''.

:[[Safe exam browser|Safe Exam Browser]] is a customised web browser that must be downloaded and installed on the computer that the student uses to attempt the quiz. It restricts student use more effectively than a pop up window option.  Features include full screen, without web navigation options, shortcut keys including copy and paste are disabled and of course surfing the web during an exam.

==Overall feedback==
(These setttings are collapsed by default)
{|
|[[File:quizoverallfeedback25.png|thumb|Overall feedback settings expanded]]
|}
Overall feedback is shown to a student after they have completed an attempt at the quiz. The text that is shown can depend on the grade the student got. Click "Show editing tools" to display the rich text editor, and drag the bottom right of the text box out to expand it.

For example, if you entered:

:Grade boundary: 100%
:Feedback: "Well done"
:Grade boundary: 40%
:Feedback: "Please study this week's work again"
:Grade boundary: 0%

Then students who score between 100% and 40% will see the "Well done" message, and those who score between 39.99% and 0% will see "Please study this week's work again". That is, the grade boundaries define ranges of grades, and each feedback string is displayed to scores within the appropriate range.

Grade boundaries can be specified either as a percentage, for example "31.41%", or as a number, for example "7". If your quiz is out of 10 marks, a grade boundary of 7 means 7/10 or better. 

Note that the maximum and minimum grade boundaries (100% and 0%) are set automatically.

You can set as many or as few grade boundaries as you wish. The form allows you up to 5 ranges at first, but you can add more by clicking the "Add 3 fields to form" button underneath.

If you're getting confusing error messages about a boundary being out of sequence (when it's obviously *in* sequence), or "boundaries must be between 0% and 100%" (and they are) -- check that the Maximum Grade for this quiz is set to something greater than zero.

==Common module settings==
(These settings are collapsed by default)
See [[Common module settings]]

==Restrict access/Activity completion==
(These settings are collapsed by default)

The Restrict access and Activity completion settings are visible if [[Conditional activities]] and [[Activity completion]] have been enabled in the site and the course.

==Group and User overrides==

[[File:overridesquiz.png]]

Dates, timing and number of allowed attempts may be changed for individual users or groups by following the links ''Group Overrides'' or ''User Overrides'' in the Quiz Administration settings block.

===Group overrides===
To change a quiz setting for a particular group, click the "add group override" button in ''Quiz Administration>Group overrides'', make the changes you wish and save or enter another override.

===User overrides===
To change a quiz setting for a particular user or users, click the "add user override"button in ''Quiz Administration>Group overrides'', make the changes you wish and save or enter another override.

[[Image:groupuseroverride.png|groupuseroverride.png]]

==Site administration settings==

The quiz module has additional settings which may be changed by an administrator in ''Administration > Site administration > Plugins > Activity modules > Quiz''.

{{New features}}
;Autosave period
:If enabled, student responses will be saved every minute/two minutes/five minutes (according to selection) This is useful so that students don't lose work but does increase the load on the server.


How questions behave can be configured in ''Administration>Site administration>Plugins>Question behaviours>Manage question 
behaviours''

[[de:Test konfigurieren]]

==See also==

[http://school.demo.moodle.net/mod/quiz/view.php?id=1496  School demo example of a quiz with CBM]  Log into with username "parent" and password "moodle"

[https://moodle.org/mod/forum/discuss.php?d=225920 Forum thread: Certainty based marking - too harsh?]

[http://helderenwijzer.nl/2011/10/certainty-based-marking-in-moodle/ Blog post on CBM (Certainty Based Marking)in Moodle]

[[fr:Ajouter/modifier un test]]