MoodleDocs - Användarbidrag [sv]

mod/quiz/statistics

2022-03-22T11:41:29Z

Timhunt: Redirected page to Quiz statistics report

#redirect [[Quiz_statistics_report]]

Participants

2020-12-20T20:55:43Z

Timhunt: /* Filtering and searching for users */

{{Course enrolment}}
==About==
The Participants page enables teachers to easily enrol, view, search for, filter, edit and delete course participants.

The Participants page can be accessed from the navigation drawer in the [[Boost theme]] or the Administration block in other themes. It can also be accessed from the More link in the gear menu, by clicking Enrolled users in the Users tab.

{{MediaPlayer | url = https://youtu.be/EoUqSxYLO4Q | desc = Participants filtering}}

==Enrolling users==
Users may be enrolled from the Enrol users button at the top right and bottom right of the screen.

[[File:NewEnrolUsers.png]]

==Filtering and searching for users==

{{Note|This section currently describes how filtering worked in Moodle up to 3.8. To see how filtering works since Moodle 3.9, please watch the video above.}}

The filter at the top left of the screen allows for filtering by period of activity, enrolment method, group, role and status:

[[File:ParticipantsFilter.png]]

You can also search users by any of the fields defined in the "Show user identity" setting. Some of the searchable fields, such as username, first name and last name, allow you to use wildcards to represent one or more characters. There are two wildcards:
* % The percent sign represents zero, one, or multiple characters
* _ The underscore represents a single character (Note: MS Access uses a question mark '?' instead of the underscore '_').

These wildcards can be escaped, if needed, to search users containing them, using a backslash '\':
* A_B will find all the users starting with an A, followed by any character and then B (i.e. AxB or A2B, but not AxxB).
* A\_B will find users starting exactly with 'A_B'.

It is possible to bulk select, edit and delete users who have self enrolled, in a similar way to users who have been enrolled manually.

==Roles==
*To assign an enrolled user a role, click the pencil icon in the Roles column then select the desired role and click the save icon to confirm the change.
*To remove a role assignment, click the delete icon (a cross) next to the role name.
*Only roles which can be assigned in the course context type are available to select. The course context type may be set by an admin by editing the role via Site administration > Users > Permissions > Define roles.
*Only roles which a user is allowed to assign are available to select.

==Groups==
To add a user to a group (requires at least one group to have been created previously), click the pencil icon in the Groups column, select the group and then click the save icon to confirm the change.

[[File:NewGroupSelect.png]]

==Status==
The status column shows the current status of a user's enrolments, for example Active or Suspended. Where a user has two different enrolment types (eg manual/cohort sync) both are displayed in the status column:

[[File:Statuscolumn.png]]

==City/town or country==

Users' city/town or country may be displayed for users with the capability moodle/site:viewuseridentity (by default manager, teacher and non-editing teacher) by selecting these fields in 'Show user identity' in [[User policies]] in the Site administration.

==Sending a message, adding a note, or editing manual or self enrolments==

You can send a message, add a note, or edit or delete selected manual user enrolments via the dropdown menu below the list of course participants.

Note that only users who were previously manually or self enrolled can have their enrolment edited or deleted in bulk. The enrolment for users who enrolled using a different enrolment method, may be edited or deleted for a user via the edit enrolment link (cog icon) in the status column.

[[File:BulkEditDeleteUsers.png]]

==Hiding the list of participants==

If required, you can use the capability [[Capabilities/moodle/course:viewparticipants|View participants]] to prevent students from viewing the list of participants.

At the course level:

# On the Participants page from the actions menu (cog icon) select Permissions
# Filter by viewparticipants
# For the capability 'View participants' remove the student role and confirm.

At site level, the 'View participants' capability can be unset for the role of student.

[[fr:Participants]]
[[es:Participantes]]
[[de:Teilnehmer/innen]]
[[it:Partecipanti]]

Participants

2020-12-20T20:52:46Z

Timhunt: /* Filtering and searching for users */

{{Course enrolment}}
==About==
The Participants page enables teachers to easily enrol, view, search for, filter, edit and delete course participants.

The Participants page can be accessed from the navigation drawer in the [[Boost theme]] or the Administration block in other themes. It can also be accessed from the More link in the gear menu, by clicking Enrolled users in the Users tab.

{{MediaPlayer | url = https://youtu.be/EoUqSxYLO4Q | desc = Participants filtering}}

==Enrolling users==
Users may be enrolled from the Enrol users button at the top right and bottom right of the screen.

[[File:NewEnrolUsers.png]]

==Filtering and searching for users==

Note that this section currently describes how filtering worked in Moodle up to 3.8. To see how filtering works since Moodle 3.9, please watch the video above.

The filter at the top left of the screen allows for filtering by period of activity, enrolment method, group, role and status:

[[File:ParticipantsFilter.png]]

You can also search users by any of the fields defined in the "Show user identity" setting. Some of the searchable fields, such as username, first name and last name, allow you to use wildcards to represent one or more characters. There are two wildcards:
* % The percent sign represents zero, one, or multiple characters
* _ The underscore represents a single character (Note: MS Access uses a question mark '?' instead of the underscore '_').

These wildcards can be escaped, if needed, to search users containing them, using a backslash '\':
* A_B will find all the users starting with an A, followed by any character and then B (i.e. AxB or A2B, but not AxxB).
* A\_B will find users starting exactly with 'A_B'.

It is possible to bulk select, edit and delete users who have self enrolled, in a similar way to users who have been enrolled manually.

==Roles==
*To assign an enrolled user a role, click the pencil icon in the Roles column then select the desired role and click the save icon to confirm the change.
*To remove a role assignment, click the delete icon (a cross) next to the role name.
*Only roles which can be assigned in the course context type are available to select. The course context type may be set by an admin by editing the role via Site administration > Users > Permissions > Define roles.
*Only roles which a user is allowed to assign are available to select.

==Groups==
To add a user to a group (requires at least one group to have been created previously), click the pencil icon in the Groups column, select the group and then click the save icon to confirm the change.

[[File:NewGroupSelect.png]]

==Status==
The status column shows the current status of a user's enrolments, for example Active or Suspended. Where a user has two different enrolment types (eg manual/cohort sync) both are displayed in the status column:

[[File:Statuscolumn.png]]

==City/town or country==

Users' city/town or country may be displayed for users with the capability moodle/site:viewuseridentity (by default manager, teacher and non-editing teacher) by selecting these fields in 'Show user identity' in [[User policies]] in the Site administration.

==Sending a message, adding a note, or editing manual or self enrolments==

You can send a message, add a note, or edit or delete selected manual user enrolments via the dropdown menu below the list of course participants.

Note that only users who were previously manually or self enrolled can have their enrolment edited or deleted in bulk. The enrolment for users who enrolled using a different enrolment method, may be edited or deleted for a user via the edit enrolment link (cog icon) in the status column.

[[File:BulkEditDeleteUsers.png]]

==Hiding the list of participants==

If required, you can use the capability [[Capabilities/moodle/course:viewparticipants|View participants]] to prevent students from viewing the list of participants.

At the course level:

# On the Participants page from the actions menu (cog icon) select Permissions
# Filter by viewparticipants
# For the capability 'View participants' remove the student role and confirm.

At site level, the 'View participants' capability can be unset for the role of student.

[[fr:Participants]]
[[es:Participantes]]
[[de:Teilnehmer/innen]]
[[it:Partecipanti]]

E-examination quick guide

2020-06-11T14:20:31Z

Timhunt:

INTERMEDIARY WORK IN PROGRESS

'''''Sorry, but I don't think 'E-assessment quick guide'. E-assessment is a very broard concept. High-stakes tests with a lock-down browser are a very small corner of E-assessment. Please can we change the page name.'''''--Tim Hunt

@ Tim Hunt: Would "E-examination quick guide" be a better page name?

:-) Much better, thanks.

some work needed
{{Quiz}}
The Quiz is a very powerful activity that can meet many teaching needs, from simple, multiple-choice knowledge tests to complex, self-assessment tasks with detailed feedback. E-assessments can be done by using the quiz module in combination with the [[Safe Exam Browser]]. This quick guide gets you started, but if you really want to make the most of everything a Moodle/Safe Exam Browser-E-assessment can do, make sure you study the full '''[[Quiz activity]]''' as well as the '''[[Safe Exam Browser]]''' documentation.

==Set up the quiz for a summative test==
===Quiz settings===
Quiz settings define the circumstances of your exam, e.g. when it starts, how long it takes, and address organizational matters, e.g. exam may be taken only using Safe Exam Browser. They assure the safety of your quiz, e.g. that no participant can see its content beforehand and no second attempt is allowed. These settings can be predefined site-wide to help teachers set them up more easily.

'''Timing | Open the quiz'''

This is the time by which a student may first start the quiz. When activated it prevents students from starting the quiz earlier than one wants them to start.

'''Timing | Close the quiz'''

This is the time by which a student may last write a quiz. Once this point in time is reached, all quiz attempts are closed irregardless if certain students had still some time left because they started late or were granted additional time due to technical problems or a compensation for disadvantages. In case such compensations are needed during an exam, "close the quiz" may be updated during an exam. But we would recommend to set the quiz end time a quarter of an hour later than the actual end of the quiz in order to reduce stress during the exam.

'''Timing | Time Limit'''

When enabled this is the maximum time students may take for the quiz. They will see the time left in the quiz navigation. During the last minute the time left turns from a light pink into a deep red. Once the time is expired, students may no longer edit their answers. Students are always able to hand in ahead of time.

'''Timing | When time expires'''

This setting may only be used when "time limit" is enabled. For summative examinations it is recommended to chose "Open attempts are submitted automatically". This way the students last (partial) answer is saved and the results are handed in automatically. S

'''Grade | Attempts allowed'''

As one usually does not want students to retake a summative exam , this setting has to be set to 1. Once students hand in their quiz (or once it is handed in automatically) students can no longer access the quiz. Depending on how review options are set, they may now see feedback on their exam.

'''Question behaviour | How questions behave: Deferred Feedback'''

'''Review options'''
[[File:review.png|thumb]]
Deselect all review options as shown above. You may have manually graded questions in your quiz and/or you want to check if the automatic grading is correct before your students are able to see the grades or the correct answers. Only show the grading by the time you are sure that it is fully correct.

'''Require password'''
Fill in a password that a student must enter to access the quiz. This allows you to give some last minute information before the start of the quiz. Once you've told the password, your studnets are able to access the quiz. A password also increases the security since it prevents unauthorised persons from accessing the quiz.

===Extra things===
(This is probably not needed. But I state those here because I don't believe they should be mentioned in the standard description but deserve explanation nevertheless)

'''Layout | Navigation method'''

'''Appearance | Show blocks during quiz attempts'''

===The Safe Exam Browser section quiz settings===

==Prepare the participants for an E-assessment==

===Pre-Test, SEB Installation (BYOD)===
===Procedure when starting, conducting and submitting the real exam===

[[Category:Quick guide]]

[[es:Guía rápida de E-evaluación]]

E-examination quick guide

2020-05-28T12:54:13Z

Timhunt:

E-examination quick guide

2020-05-28T12:53:38Z

Timhunt:

INTERMEDIARY WORK IN PROGRESS

Sorry, but I don't think 'E-assessment quick guide'. E-assessment is a very broard concept. High-stakes tests with a lock-down browser are a very small corner of E-assessment. Please can we change the page name.--Tim Hunt

some work needed
{{Quiz}}
The Quiz is a very powerful activity that can meet many teaching needs, from simple, multiple-choice knowledge tests to complex, self-assessment tasks with detailed feedback. E-assessments can be done by using the quiz module in combination with the [[Safe Exam Browser]]. This quick guide gets you started, but if you really want to make the most of everything a Moodle/Safe Exam Browser-E-assessment can do, make sure you study the full '''[[Quiz activity]]''' as well as the '''[[Safe Exam Browser]]''' documentation.

==Set up the quiz for a summative test==
===Quiz settings===
To assure the safety of your quiz, e.g. that no participant can see its content beforehand, isn't allowed a second attempt once submitted etc. some options are considered to be useful to set up.

'''Timing | Open the quiz'''

'''Timing | Close the quiz'''

'''Timing | Time Limit'''

'''Timing | When time expires'''

'''Grade | Attempts allowed'''

'''Question behaviour | How questions behave: Deferred Feedback'''

'''Review options'''

===Extra things===
(This is probably not needed. But I state those here because I don't believe they should be mentioned in the standard description but deserve explanation nevertheless)

'''Layout | Navigation method'''

'''Appearance | Show blocks during quiz attempts'''

===The Safe Exam Browser section quiz settings===

==Prepare the participants for an E-assessment==

===Pre-Test, SEB Installation (BYOD)===
===Procedure when starting, conducting and submitting the real exam===

[[Category:Quick guide]]

[[es:Guía rápida de E-evaluación]]

Quiz settings

2020-04-25T07:44:03Z

Timhunt: /* Timing */

{{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.

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|The user's time-zone - as set in the user profile - only affects how a particular time is displayed to that user. The actual timing for the quiz is not changed by that.}}
;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 display both the open and close date for students.
;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

;When time expires..

{{Note|It is always the case that if the student is actively working on the quiz when the count-down timer reachers zero, then their attempt will be automatically submitted at that moment. This setting only affects what happens if the student starts a timed attempt, then leaves the attempt, and then later 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:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted.

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.

{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections in quiz administration.}}

===Example 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==
;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.
{{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.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;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==
;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.

If you have many questions that use many high definition images and the server suffers performance issues, showing only one question per page is easier on the server that showing many (or all) questions in one page.

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:This is the primary way to control the experience a student has as they interact with each question in the quiz. If you want students to get immediate feedback on their response with a chance to try again, if they get it wrong, then select 'Interactive with multiple tries' (and add some hints to your questions and specify a retry penalty if desired). If you want to replicate a traditional exam, select 'Deferred feedback'. In other situations, the other options can be useful. For a description of all the behaviours, see [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. Importantly, for students to continue with the same question, the question definition must contain hints. It must also have been added manually into the quiz, rather than randomly (see [[Building Quiz#Adding questions]]). Otherwise, the 'redo' will occur with a different question from the one they were working on previously if there are other questions available (such as when the question slot is filled by a random question). A student's grade for that question slot is based on the most recent question they have started. ''Note: by default students are allowed three tries to answer a question correctly in Interactive mode before the 'redo' option becomes available. The number of tries cannot be reduced but it can be increased by adding more hints to the question in the 'Multiple tries' section of the question's configuration page.''
;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:quizreview.png|thumb|600px|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'.

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) 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.
;Decimal places in question grades
:By default this is an advanced setting. You need to click Show more ... to reveal it. Lets you have a different display of grades for each question compared to the quiz total. For example you may which to see the total as a whole number, but still show fractional grades for each question.
;Show blocks during quiz attempts
:Also an advanced setting by default. You can control whether blocks are shown on the page during quiz attempts.

==Extra restrictions on attempts==
;Require password
: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. If you have many users taking one simultaneous quiz, it may help to assign a very long password to the quiz, so that the load on the server is spread over time (see [https://moodle.org/mod/forum/discuss.php?d=316736#p1273704 this forum thread]).
;Require network address
: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
: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:
[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]
:* 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. (However, it is impossible for a web site to create a browser window that cannot be minimised or moved aside.)
:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

:This option will only appear if your administrator has enabled it in ''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==
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.

If you want to reduce the number of boundaries and feedbacks, you will need to remove all feedbacks and boundaries and then add the reduced amount.

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

==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.
===Quiz completion===

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==
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 Quiz administration. In situations where two group overrides may apply to a single user, the most lenient date is used. For "Open the quiz" dates, this means the earliest possible date is used, for "Close the quiz" dates, this means that the latest possible date is used Note also that if there exists a user override for a student, it will always take precedence over any group overrides.

===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>User overrides'', make the changes you wish and save or enter another override.

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. 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 ''Site administration > Plugins > Question behaviours > Manage question behaviours''.

==See also==

[[fr:Ajouter/modifier un test]]
[[de:Test konfigurieren]]
[[es:Configuraciones del examen]]

Mall:Note

2020-04-25T07:41:49Z

Timhunt:

<div class="alert alert-info">'''Note:''' {{{message|{{{1|}}}}}}</div>
<noinclude>
Usage:
<pre>
{{Note|Enter the note here...}}
</pre>

== See also ==

* [[Template:Warning]]
</noinclude>

Quiz settings

2020-04-25T07:39:27Z

Timhunt: /* Timing */

{{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.

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|The user's time-zone - as set in the user profile - only affects how a particular time is displayed to that user. The actual timing for the quiz is not changed by that.}}
;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 display both the open and close date for students.
;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

;When time expires..

{{Note|It is always the case that if the student is actively working on the quiz when the count-down timer reachers zero, then their attempt will be automatically submitted at that moment. This setting only affects what happens if the student starts a timed attempt, then gone away to do something else, then later 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:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted.

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.

{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections in quiz administration.}}

===Example 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==
;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.
{{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.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;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==
;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.

If you have many questions that use many high definition images and the server suffers performance issues, showing only one question per page is easier on the server that showing many (or all) questions in one page.

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:This is the primary way to control the experience a student has as they interact with each question in the quiz. If you want students to get immediate feedback on their response with a chance to try again, if they get it wrong, then select 'Interactive with multiple tries' (and add some hints to your questions and specify a retry penalty if desired). If you want to replicate a traditional exam, select 'Deferred feedback'. In other situations, the other options can be useful. For a description of all the behaviours, see [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. Importantly, for students to continue with the same question, the question definition must contain hints. It must also have been added manually into the quiz, rather than randomly (see [[Building Quiz#Adding questions]]). Otherwise, the 'redo' will occur with a different question from the one they were working on previously if there are other questions available (such as when the question slot is filled by a random question). A student's grade for that question slot is based on the most recent question they have started. ''Note: by default students are allowed three tries to answer a question correctly in Interactive mode before the 'redo' option becomes available. The number of tries cannot be reduced but it can be increased by adding more hints to the question in the 'Multiple tries' section of the question's configuration page.''
;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:quizreview.png|thumb|600px|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'.

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) 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.
;Decimal places in question grades
:By default this is an advanced setting. You need to click Show more ... to reveal it. Lets you have a different display of grades for each question compared to the quiz total. For example you may which to see the total as a whole number, but still show fractional grades for each question.
;Show blocks during quiz attempts
:Also an advanced setting by default. You can control whether blocks are shown on the page during quiz attempts.

==Extra restrictions on attempts==
;Require password
: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. If you have many users taking one simultaneous quiz, it may help to assign a very long password to the quiz, so that the load on the server is spread over time (see [https://moodle.org/mod/forum/discuss.php?d=316736#p1273704 this forum thread]).
;Require network address
: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
: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:
[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]
:* 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. (However, it is impossible for a web site to create a browser window that cannot be minimised or moved aside.)
:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

:This option will only appear if your administrator has enabled it in ''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==
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.

If you want to reduce the number of boundaries and feedbacks, you will need to remove all feedbacks and boundaries and then add the reduced amount.

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

==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.
===Quiz completion===

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==
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 Quiz administration. In situations where two group overrides may apply to a single user, the most lenient date is used. For "Open the quiz" dates, this means the earliest possible date is used, for "Close the quiz" dates, this means that the latest possible date is used Note also that if there exists a user override for a student, it will always take precedence over any group overrides.

===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>User overrides'', make the changes you wish and save or enter another override.

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. 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 ''Site administration > Plugins > Question behaviours > Manage question behaviours''.

==See also==

[[fr:Ajouter/modifier un test]]
[[de:Test konfigurieren]]
[[es:Configuraciones del examen]]

Quiz settings

2020-04-25T07:38:36Z

Timhunt: /* Timing */

{{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.

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|The user's time-zone - as set in the user profile - only affects how a particular time is displayed to that user. The actual timing for the quiz is not changed by that.}}
;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 display both the open and close date for students.
;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

;When time expires..

{{Note|It is always the case that if the student is actively working on the quiz when the count-down timer reachers zero, then their attempt will be automatically submitted at that moment. This setting only affects what happens if the student starts a timed attempt, then gone away to do something else, then later 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:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted.

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.

{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections in quiz administration.}}

===Example 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==
;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.
{{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.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;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==
;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.

If you have many questions that use many high definition images and the server suffers performance issues, showing only one question per page is easier on the server that showing many (or all) questions in one page.

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:This is the primary way to control the experience a student has as they interact with each question in the quiz. If you want students to get immediate feedback on their response with a chance to try again, if they get it wrong, then select 'Interactive with multiple tries' (and add some hints to your questions and specify a retry penalty if desired). If you want to replicate a traditional exam, select 'Deferred feedback'. In other situations, the other options can be useful. For a description of all the behaviours, see [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. Importantly, for students to continue with the same question, the question definition must contain hints. It must also have been added manually into the quiz, rather than randomly (see [[Building Quiz#Adding questions]]). Otherwise, the 'redo' will occur with a different question from the one they were working on previously if there are other questions available (such as when the question slot is filled by a random question). A student's grade for that question slot is based on the most recent question they have started. ''Note: by default students are allowed three tries to answer a question correctly in Interactive mode before the 'redo' option becomes available. The number of tries cannot be reduced but it can be increased by adding more hints to the question in the 'Multiple tries' section of the question's configuration page.''
;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:quizreview.png|thumb|600px|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'.

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) 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.
;Decimal places in question grades
:By default this is an advanced setting. You need to click Show more ... to reveal it. Lets you have a different display of grades for each question compared to the quiz total. For example you may which to see the total as a whole number, but still show fractional grades for each question.
;Show blocks during quiz attempts
:Also an advanced setting by default. You can control whether blocks are shown on the page during quiz attempts.

==Extra restrictions on attempts==
;Require password
: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. If you have many users taking one simultaneous quiz, it may help to assign a very long password to the quiz, so that the load on the server is spread over time (see [https://moodle.org/mod/forum/discuss.php?d=316736#p1273704 this forum thread]).
;Require network address
: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
: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:
[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]
:* 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. (However, it is impossible for a web site to create a browser window that cannot be minimised or moved aside.)
:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

:This option will only appear if your administrator has enabled it in ''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==
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.

If you want to reduce the number of boundaries and feedbacks, you will need to remove all feedbacks and boundaries and then add the reduced amount.

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

==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.
===Quiz completion===

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==
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 Quiz administration. In situations where two group overrides may apply to a single user, the most lenient date is used. For "Open the quiz" dates, this means the earliest possible date is used, for "Close the quiz" dates, this means that the latest possible date is used Note also that if there exists a user override for a student, it will always take precedence over any group overrides.

===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>User overrides'', make the changes you wish and save or enter another override.

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. 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 ''Site administration > Plugins > Question behaviours > Manage question behaviours''.

==See also==

[[fr:Ajouter/modifier un test]]
[[de:Test konfigurieren]]
[[es:Configuraciones del examen]]

Quiz settings

2020-04-25T07:34:32Z

Timhunt: /* Example of how timing is handled */

{{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.

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|The user's time-zone - as set in the user profile - only affects how a particular time is displayed to that user. The actual timing for the quiz is not changed by that.}}
;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 display both the open and close date for students.
;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
;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:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted.

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.

{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections in quiz administration.}}

===Example 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==
;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.
{{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.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;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==
;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.

If you have many questions that use many high definition images and the server suffers performance issues, showing only one question per page is easier on the server that showing many (or all) questions in one page.

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:This is the primary way to control the experience a student has as they interact with each question in the quiz. If you want students to get immediate feedback on their response with a chance to try again, if they get it wrong, then select 'Interactive with multiple tries' (and add some hints to your questions and specify a retry penalty if desired). If you want to replicate a traditional exam, select 'Deferred feedback'. In other situations, the other options can be useful. For a description of all the behaviours, see [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. Importantly, for students to continue with the same question, the question definition must contain hints. It must also have been added manually into the quiz, rather than randomly (see [[Building Quiz#Adding questions]]). Otherwise, the 'redo' will occur with a different question from the one they were working on previously if there are other questions available (such as when the question slot is filled by a random question). A student's grade for that question slot is based on the most recent question they have started. ''Note: by default students are allowed three tries to answer a question correctly in Interactive mode before the 'redo' option becomes available. The number of tries cannot be reduced but it can be increased by adding more hints to the question in the 'Multiple tries' section of the question's configuration page.''
;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:quizreview.png|thumb|600px|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'.

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) 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.
;Decimal places in question grades
:By default this is an advanced setting. You need to click Show more ... to reveal it. Lets you have a different display of grades for each question compared to the quiz total. For example you may which to see the total as a whole number, but still show fractional grades for each question.
;Show blocks during quiz attempts
:Also an advanced setting by default. You can control whether blocks are shown on the page during quiz attempts.

==Extra restrictions on attempts==
;Require password
: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. If you have many users taking one simultaneous quiz, it may help to assign a very long password to the quiz, so that the load on the server is spread over time (see [https://moodle.org/mod/forum/discuss.php?d=316736#p1273704 this forum thread]).
;Require network address
: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
: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:
[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]
:* 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. (However, it is impossible for a web site to create a browser window that cannot be minimised or moved aside.)
:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

:This option will only appear if your administrator has enabled it in ''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==
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.

If you want to reduce the number of boundaries and feedbacks, you will need to remove all feedbacks and boundaries and then add the reduced amount.

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

==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.
===Quiz completion===

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==
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 Quiz administration. In situations where two group overrides may apply to a single user, the most lenient date is used. For "Open the quiz" dates, this means the earliest possible date is used, for "Close the quiz" dates, this means that the latest possible date is used Note also that if there exists a user override for a student, it will always take precedence over any group overrides.

===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>User overrides'', make the changes you wish and save or enter another override.

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. 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 ''Site administration > Plugins > Question behaviours > Manage question behaviours''.

==See also==

[[fr:Ajouter/modifier un test]]
[[de:Test konfigurieren]]
[[es:Configuraciones del examen]]

The OU workflow system

2020-03-30T07:34:07Z

Timhunt: /* Automatic script actions */

The Workflow system is used at the OU to manage the production of courses and some activities. It comprises a block and a related admin report.

==Overview==

A workflow (for our purposes) is a linear sequence of steps. A step has
* a name
* some instructions;
* a check-list of actions;
* a list of roles who are responsible for performing this step;
* a list of actions that are taken automatically when the step is started/finished, for example assigning roles or changing activity settings.

The system allows the definition of different workflows. Each workflow has
* a name
* a description
* an indication of the type of thing it relates to (e.g. ‘course’, ‘mod_quiz’)

Under Admin -> Plugins -> Blocks -> Workflow, there is an interface for Administrators to define and edit workflows, and to import and export workflow definitions as XML.

To use a workflow to manage the production of, say, a course, you go to the course, and add a workflow block to it. Initially, the block will display a message “There is currently no workflow associated with this course.” with an Add workflow button. Clicking the button allows you to select from any of the workflows that are appropriate for ‘course’.

When the workflow is added to the course, the first step in the workflow becomes active. The workflow block now displays the step instructions for the currently active step; the checklist items as a list of check-boxes; a comments area; a Finish step button; and a link to the workflow overview.

When a step becomes active, all the people responsible for completing the step are sent an email informing them that they should do the step. These people may also get an additional role assigned to them in the context the workflow applies to.

The comments area in the workflow block is a simple editable text area where people working on the step can leave notes for each other.

The Finish step button leads to a confirmation page. If the action is confirmed, then the workflow advances to the next step. When the last step of the workflow is finished, the workflow either stops, or loops back to one of the other steps.

The workflow overview gives an overview of all the steps in this workflow, and the progress through it. The system tracks the timestamp, and the user, each time a step is finished or made active.

The overview page also allows workflow administrators (those with an appropriate capability) to jump the workflow to any particular step.

There is also a report that summarise the workflow across a selection of courses or activities.

==Setting up a workflow==

Before you can use the workflow system, you have to create a workflow. To set up workflows, you need to go to Admin -> Plugins -> Blocks -> Workflows.

===Creating a workflow===

To create a workflow, click on the 'Add workflow' icon at the bottom of the 'Manage Workflows' section of the page. This takes you to the Add workflow form.

Like with Roles, you need to give your workflow both an internal 'Short name' and a human-readable name. It is a good idea to use the description to explain what this particular workflow is for.

You need to specify what type of thing the workflow applies to, either a course, or a type of activity.

Finally, you can say whether they workflow is available for use yet. You should probably leave the 'Current status' as 'Disabled' until you have finished building the workflow.

Once you have got this far, click Save changes.

===Adding steps to a workflow===

Once the workflow is created, you are taken to a page where you can edit this list of steps in the workflow.

The newly created workflow will have one step already. Click the edit icon by that step, to see what you can change.

You can edit the Steps name, and instructions, and you should probably do that.

The 'On step activation' and 'On step completion' boxes let you cause things to happen automatically when a step starts or finishes. This is an advance feature,

===Defining the list of tasks for a step===

===What happens at the end of the workflow===

===Automatic script actions===

There are two scripts associated with each task. The '''On step activation''' script is always run when the step starts. The '''On completion step''' script only runs if the step finishes normally with someone clicking the finish step button. This distinction is subtle, but important.

There is also a third script you can use, which runs at a set time (e.g. 2 weeks before the course start date) if this script happens to be active at that time.

Any line of the script that starts with a # character is considered to be a comment and ignored. You are encouraged to use comments to document what your script does.

Remaining lines are commands, which are a sequence of words separated by spaces. The first word on the line determines which command this is. The meaning of the remaining words depends on the type of command. These available commands. In the templates below, you need to replace the bits in {...} with the actual values you want, so an actual example of the first rule would be "email mytemplate to editingteacher".

; email {templatename} to {role1} {role2} ...
: Sends an email to all the users with any of these roles in the context the workflow applies to. If a user has multiple roles, they only get one email. templatename refers the shortname of one of the email templates that has been defined. The roles are identified by their shortnames.

; assignrole {newrole} to {role1} {role2} ...
: This assigns the new role to any user who has any of the other roles in this context (not parent contexts), and who does not already have newrole in this context. The roles are identified by their shortnames.

; setactivityvisibility {hidden|visible}
: sets the course_module.visible column to 0 or 1 as appropriate. Can only be used in activity workflows.

; setcoursevisibility {hidden|visible}
: sets the course.visible column to 0 or 1 as appropriate. Can only be used in course workflows.

; override {role} {inherit|allow|prevent|prohibit} {capability} in {course|activity}
: sets a role override. The role is identified by its shortname. In course workflows, only course can be used as the last word. In activity workflows, either course or activity can be used.

; setactivitysetting {column} to {value}
: This can only be used in activity workflows. Sets that column in the module’s table, for example in the quiz table. value has to be a fixed value, and (at least at present) only values that are a single word need to be supported. (The word may be a number or a string.)

; setactivitylinkedsetting {tablename} by {foreignkeycolumnname} clear
; setactivitylinkedsetting {tablename} by {foreignkeycolumnname} set {field1} {value1} {field2} {value2} ...
: This one is quite complex. See https://github.com/moodleou/moodle-block_workflow/blob/master/classes/command_setactivitylinkedsetting.php#L28 for more.

===Email templates===

These are used by the <tt>email</tt> script command. Each template has a shortname, which is how the email command refers to it. They also have a subject and a message body.

The subject and the message body can contain the following tokens, which are replaced the the appropriate value:

; %%workflowname%% : the name of this workflow.
; %%stepname%% : the name of the current workflow step.
; %%contextname%% : the name of the context the workflow applies to. For example “Course B747-11B” or “Quiz iCMA41”. For courses, that is using the course shortname. For activities, it is using the activity name.
; %%contexturl%% : the URL of the course of activity that this workflow relates to.
; %%coursename%% : for course workflows, this is the same as %%contextname%%. For activity workflows, it is “Course B747-11B” with the applicable course shortname.
; %%usernames%% : a comma-separated list of all the users who will be receiving this email.
; %%currentusername%% : the name of the user who triggered the action that lead to this email being sent.
; %%instructions%% : the instructions for the current step.
; %%tasks%% : the list of tasks for the current step.
; %%comment%% : when executing the onactivescript this is set to the comment from the step that was just completed. When executing the oncompletescript, this is set to the comment from this step. If the comment is blank, this is set to ‘[none]’.

So, a typical email template for an On step activation email might look like:
; Subject : Please do workflow step %%stepname%% for %%contextname%%
; Message
: Dear %%usernames%%,
: You are responsible for performing the workflow step %%stepname%% as part or workflow %%workflowname%% for %%contextname%%.
: The step instructions are:
: ---------------------------------------------------------------------
: %%instructions%%
: ---------------------------------------------------------------------
: To perform this step, please go to <%%contexturl%%>
: The people working on the previous step left the comment:
: ---------------------------------------------------------------------
: %%comment%%
: ---------------------------------------------------------------------

===Managing workflows===

On the main manage workflows page, as you might expect, you can edit or delete any workflow.

The system will only let you delete a workflow that it not used anywhere, so instead of deleting a workflow, you may prefer to hide it using the 'eye-con'. If a workflow is hidden, then it will go on working in any place where it is used, but you will not be able to start using it in any new place. In other words, the workflow will be hidden from the list available when you select the workflow to add to a course or activity.

==Importing and exporting workflows==

On the manage workflows page, you can export any workflow to an XML file, and import a workflow from an XML file. The import/export automatically includes all the necessary email templates.

==Using the workflow system==

For definiteness, in this section, I will talk about using a workflow on a course. Using a workflow on an activity is very similar, you just add the block in a different place.

===Adding a workflow to a course===

On the course page, turn editing on. Then do Add a block -> Workflow. That adds the workflow block, but it does not yet add a workflow. The block will be showing

===The list of tasks===

===Using comments===

===The workflow overview===

==The workflow report==

==See also==

* [[Installing plugins]]
* [http://moodle.org/plugins/view.php?plugin=block_workflow Plugins database entry for the block]
* [http://moodle.org/plugins/view.php?plugin=report_workflow Plugins database entry for the admin report]
* [https://github.com/moodleou/moodle-block_workflow The block on github]
* [https://github.com/moodleou/moodle-report_workflow The report on github]

[[Category:Contributed code]]

Installation quick guide

2020-03-20T16:06:15Z

Timhunt: /* Getting Moodle */

{{Installing Moodle}}
''This page is intended for administrators who are experienced with installing web server applications and are in a hurry to get up and running. Otherwise please see [[Installing Moodle]]''.

==Basic Requirements==

* You will need a working web server (e.g. [[Apache]]), a database (e.g. [[MySQL]], [[MariaDB]] or [[PostgreSQL]]) and have [[PHP]] configured. See the [{{Release notes}} release notes] in the dev docs for software requirements.
* Moodle requires a number of [[PHP]] extensions. However, Moodle checks early in the installation process and you can fix the problem and re-start the install script if any are missing.
* If you want Moodle to send email (you probably do) you need a working Sendmail (Unix/Linux) on your server or access to an SMTP mail server.

==Getting Moodle==

You have two basic options:
* Download your required version from http://moodle.org/downloads ... OR
* Pull the code from the Git repository (recommended for developers and also makes upgrading very simple):
<pre>
git clone -b MOODLE_38_STABLE git://git.moodle.org/moodle.git
</pre>
...this fetches a complete copy of the Moodle repository and then switches to the {{Version}} Stable branch.

See [[Git_for_Administrators|Git for Administrators ]] for details on using Git to install Moodle code.

Note: Only download Moodle from one of the moodle.org sources. Other versions (e.g. control panel based installers, Linux distribution repositories, other "one click" installers) cannot be guaranteed to work properly, be upgradable or be supportable.

==Create a database==

* Using your chosen database server, create a new empty database. The default encoding must be UTF8. For example, using MySQL:
<pre>
CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
</pre>
* Create a user/password combination with appropriate permissions for the database. For example (MySQL again):
<pre>
mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO 'moodleuser'@'localhost' IDENTIFIED BY 'yourpassword';
</pre>

Notes: It is important to GRANT ON moodle.* as the database name including the '.*' and not just the bare database name. Save this password you use for the Moodle user, since you will need it later in the install.

==Create data directory==

* Create an empty directory to hold Moodle files. It '''must not''' be in the area served by the web server and must have permissions so that the web server user can write to it. Other than that it can be located anywhere. Typically, either make it owned by the web server user or give it write permissions for 'everyone'. If it is on a shared/NFS drive then read [[Caching]] - Moodle caches to this disk area by default and a slow share will mean terrible performance.

==Install Moodle code==

* If you downloaded the zip or tgz file earlier, then unzip / untar / move / copy the Moodle code (obtained above) so that it will be served by your web server (e.g. on Debian based Linux, move to /var/www/html/moodle)
* Check the permissions and make sure that the web server does '''not''' have permissions to write to any of the files in the Moodle code directories (a very common root cause of sites being hacked).
* If you need to, configure your web server to serve the Moodle site with your chosen URL.

==Configure Moodle==

* In the Moodle code directory, find the file ''config-dist.php'' and copy it to a new file called ''config.php'' (but read next step, 'Install Moodle', first).
* Edit config.php with your favourite editor and change the appropriate settings to point to your site, directories and database. ''Note: the Moodle install script will create config.php for you if it does not exist but make sure you (re-)set permissions appropriately afterwards''

==Install Moodle==

* Go to the URL for your moodle site in a browser (installation will complete automatically) or run the command line version at (requires cli version of PHP):
<pre>
/usr/bin/php /path/to/moodle/admin/cli/install.php
</pre>
The CLI creates the config.php for you and will not run if you created one in the previous step.
* After completing the install make sure your file permissions are ok for the Moodle program files (not writeable by web server) and the Moodle data files (writeable by web server).

==Set up cron==

You will need a cron job to run periodically. It is recommended that ''the cron is run every minute'', as required for asynchronous activity deletion when using the [[Recycle bin|recycle bin]]. A typical Unix cron entry will be as follows:
<pre>
* * * * * /usr/bin/php /path/to/moodle/admin/cli/cron.php >/dev/null
</pre>
Your site '''will not work properly''' unless cron is running regularly. It is very important you do not skip this step.

See [[Cron]] for details.

==Congratulations!==

You are now ready to use your Moodle site.

If you run into problems, check the [[Installation FAQ]] and visit the [http://moodle.org/mod/forum/view.php?id=28 Installation help forum].

[[Category:Quick guide]]

[[de:Installation in Kürze]]
[[fr:Installation_rapide]]
[[es:Inicio_Rápido_de_Instalación]]
[[ja:インストレーションクイックガイド]]

Quiz settings

2020-02-22T13:10:14Z

Timhunt: /* Appearance */

{{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.

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|The user's time-zone - as set in the user profile - only affects how a particular time is displayed to that user. The actual timing for the quiz is not changed by that.}}
;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 display both the open and close date for students.
;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
;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:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted

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.

{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections in quiz administration.}}

===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==
;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.
{{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.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;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==
;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.

If you have many questions that use many high definition images and the server suffers performance issues, showing only one question per page is easier on the server that showing many (or all) questions in one page.

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:This is the primary way to control the experience a student has as they interact with each question in the quiz. If you want students to get immediate feedback on their response with a chance to try again, if they get it wrong, then select 'Interactive with multiple tries' (and add some hints to your questions and specify a retry penalty if desired). If you want to replicate a traditional exam, select 'Deferred feedback'. In other situations, the other options can be useful. For a description of all the behaviours, see [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. Importantly, for students to continue with the same question, the question definition must contain hints. It must also have been added manually into the quiz, rather than randomly (see [[Building Quiz#Adding questions]]). Otherwise, the 'redo' will occur with a different question from the one they were working on previously if there are other questions available (such as when the question slot is filled by a random question). A student's grade for that question slot is based on the most recent question they have started. ''Note: by default students are allowed three tries to answer a question correctly in Interactive mode before the 'redo' option becomes available. The number of tries cannot be reduced but it can be increased by adding more hints to the question in the 'Multiple tries' section of the question's configuration page.''
;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:quizreview.png|thumb|600px|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'.

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) 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.
;Decimal places in question grades
:By default this is an advanced setting. You need to click Show more ... to reveal it. Lets you have a different display of grades for each question compared to the quiz total. For example you may which to see the total as a whole number, but still show fractional grades for each question.
;Show blocks during quiz attempts
:Also an advanced setting by default. You can control whether blocks are shown on the page during quiz attempts.

==Extra restrictions on attempts==
;Require password
: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. If you have many users taking one simultaneous quiz, it may help to assign a very long password to the quiz, so that the load on the server is spread over time (see [https://moodle.org/mod/forum/discuss.php?d=316736#p1273704 this forum thread]).
;Require network address
: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
: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:
[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]
:* 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. (However, it is impossible for a web site to create a browser window that cannot be minimised or moved aside.)
:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

:This option will only appear if your administrator has enabled it in ''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==
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.

If you want to reduce the number of boundaries and feedbacks, you will need to remove all feedbacks and boundaries and then add the reduced amount.

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

==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.
===Quiz completion===

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==
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 Quiz administration. In situations where two group overrides may apply to a single user, the most lenient date is used. For "Open the quiz" dates, this means the earliest possible date is used, for "Close the quiz" dates, this means that the latest possible date is used Note also that if there exists a user override for a student, it will always take precedence over any group overrides.

===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>User overrides'', make the changes you wish and save or enter another override.

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. 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 ''Site administration > Plugins > Question behaviours > Manage question behaviours''.

==See also==

[[fr:Ajouter/modifier un test]]
[[de:Test konfigurieren]]
[[es:Configuraciones del examen]]

Quiz settings

2019-12-24T10:09:07Z

Timhunt: /* Question behaviour */

{{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.

==General==
Add a name here (which students will click on to access the quiz) and, if desired, a description of what they must do.

==Timing==
{{Note|The user's time-zone - as set in the user profile - only affects how a particular time is displayed to that user. The actual timing for the quiz is not changed by that.}}
;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 display both the open and close date for students.
;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
;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:
# Open attempts are submitted automatically (This is the default)
# There is a grace period when open attempts can be submitted, but no more questions answered
# Attempts must be submitted before time expires, or they are not counted

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.

{{Note|You can change quiz availability and duration for different groups or users in the Group or User override sections in quiz administration.}}

===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==
;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.
{{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.}}
;Grade to pass
Here you can set a passing grade for the quiz. This may be connected with [[Activity completion]] and [[Conditional activities]] such that a student will not be able to access a follow up activity until they have passed the quiz.
;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==
;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.

If you have many questions that use many high definition images and the server suffers performance issues, showing only one question per page is easier on the server that showing many (or all) questions in one page.

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

Choose ''Sequential'' instead of ''Free'', if you want to force the student to progress through the questions in order and not go back to a previous question or skip to a later one.

==Question behaviour==
;How questions behave
:This is the primary way to control the experience to student has as they interact with each question in the quiz. If you want students to get immediate feedback on their response, with a chance to try again, if they get it wron, then select 'Interactive with mulitple tries' (and add some hints to your questions). If you want to replicate a traditional exam, select 'Deferred feedback'. In other situations, the other options can be useful. For a description of all the behaviours, see [[Question behaviours]].
;Allow redo within an attempt (available by clicking "Show more")
:If using Interactive or Immediate feedback mode, enabling this setting means students can try a question again even if they have used up their allowed attempts. This is helpful if they wish to learn from the feedback given at the end of their attempts. They will be given a different question from the one they were working on previously if there are other questions available. A student's grade for that question slot is based on the most recent question they have started.
;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:quizreview.png|thumb|600px|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'.

==Appearance==
;Show the user's picture
:It is now possible, when displaying the user's profile picture for proctoring purposes, to choose whether a large image or thumbnail will be displayed.
;Decimal places in grades
:This option determines how many digits will be shown after the decimal separator (see [[dev:Translation_langconfig|langconfig]] ) 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==
;Require password
: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. If you have many users taking one simultaneous quiz, it may help to assign a very long password to the quiz, so that the load on the server is spread over time (see [https://moodle.org/mod/forum/discuss.php?d=316736#p1273704 this forum thread]).
;Require network address
: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
: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:
[[File:seb24.png|thumb|Student view of quiz question with full screen popup.]]
:* 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. (However, it is impossible for a web site to create a browser window that cannot be minimised or moved aside.)
:* The students are prevented, as far as is possible, from using facilities like copy and paste.

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

:This option will only appear if your administrator has enabled it in ''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==
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.

==Outcomes==
This setting will only appear if [[Outcomes]] have been enabled by the administrator and are used in the course. See [[Outcomes]] for how to remove an outcome once it has been added to a quiz.

==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.
===Quiz completion===

The following automatic activity completion conditions apply to the quiz:

:''Require view'' - the student clicks on the quiz to view it
:''Require grade'' - the student obtains a grade
:''Require a passing grade'' - a 'Grade to pass' is specified for the quiz in the gradebook.
:''All available attempts completed'' - a certain number of attempts were allowed on the quiz and the student has completed them all.

==Group and User overrides==
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 Quiz administration. In situations where two group overrides may apply to a single user, the most lenient date is used. For "Open the quiz" dates, this means the earliest possible date is used, for "Close the quiz" dates, this means that the latest possible date is used Note also that if there exists a user override for a student, it will always take precedence over any group overrides.

===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>User overrides'', make the changes you wish and save or enter another override.

==Site administration settings==

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

The time period settings for a quiz (such as time limit, submission grace period, autosave period and so on) can be set here with a duration of seconds, minutes, hours, days or weeks. These defaults will then be used when new quizzes are created.

;Autosave period
:If enabled, student responses will be saved at regular period according to the selection here. the default is one minute. 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 ''Site administration > Plugins > Question behaviours > Manage question behaviours''.

==See also==

[[fr:Ajouter/modifier un test]]
[[de:Test konfigurieren]]
[[es:Configuraciones del examen]]

Diskussion:Caching

2019-05-21T16:59:30Z

Timhunt: /* Memcache / Memcached */

When editing cache mappings most of a Primary store and a Final store setting. These setting really need to be defined as to their purpose.

=== Redis Cache Store Instance ===
The '''Section 6 Adding cache store instances''' section of this doc has these four options:

6.1 File cache
6.2 Memcache
6.3 Memcached
6.4 MongoDB

What about Redis? Can a "Redis cache store instance" be used here too? If so, please expand the article to explain this.

=== Memcache / Memcached ===
As of May 2019 various documents indicate that Memcache and Memcached are old technologies that aren't fully compatible with PHP 7 anymore. Examples:
* MDL-55602 says "memcache is not PHP7 compatible".
* [https://moodle.org/mod/forum/discuss.php?d=355932#p1435923 Re: memcached problem]
* [https://moodle.org/mod/forum/discuss.php?d=371013#p1496352 Re: Memcahed and moodle 3.5]
* [https://moodle.org/mod/forum/discuss.php?d=366556 Upgrading 3.1.5 to 3.4.1]

Should this Memcache / Memcached section be removed from this documentation, or at least updated to indicate the modern alternatives that should be used instead?

Linked Tracker issue: MDL-65542

--[[User:Luis de Vasconcelos|Luis de Vasconcelos]] ([[User talk:Luis de Vasconcelos|talk]]) 11:23, 21 May 2019 (UTC)

;; As I commented in the tracker issue: Memcache and memcached as two separate interface libraries for PHP code to communicate with a a memcached back-end. Only memcached still works with PHP 7.x, but it does work just fine.--[[User:Tim Hunt 2|Tim Hunt 2]] ([[User talk:Tim Hunt 2|talk]]) 16:59, 21 May 2019 (UTC)