Activity completion settings: Difference between revisions

From MoodleDocs
(screenshot)
m (→‎Activity settings: clean up, typos fixed: eg → e.g.)
 
(46 intermediate revisions by 8 users not shown)
Line 2: Line 2:
==Activity settings==
==Activity settings==


Depending on the type of activity, there are different completion requirements. For example, a [[Page|Page]] might have the requirement to ''require view''; a [[Quiz|Quiz]] might have the requirement to ''require grade'' while a [[Forum|Forum]] might have the requirement to ''require posts/discussions/replies''.  
Depending on the type of activity, there are different completion requirements. For example, a [[Page]] might have the requirement to ''require view''; a [[Quiz]] might have the requirement to ''require grade'' while a [[Forum]] might have the requirement to ''require posts/discussions/replies''.


<gallery widths="300px">
File:Activity_completion_settings_common.png|Common settings for most graded activities
File:Forumactivitycompletion.png|Forum activity settings
File:24assignmentsubmit.png|Assignment settings
</gallery>


===Completion tracking===
{{New features}}
There are three options:


*''Do not indicate activity completion'' - this will not show checks (ticks) next to the activity
The completion requirements display progressively depending on what the teacher selects and what the default completion settings defined by the admin are.
*''Students can manually mark the activity as completed'' - students press the check (tick) to change it. (Note: they can do this even without doing the activity!)
*''Show activity as complete when conditions are met'' - the selected completion criteria must be met before the check (tick) will change style


===Require view===
For example, in this assignment the default setting is ''None'':


When this option is turned on, students have to view the activity in order to complete it.
[[File:43none.jpg|600px]]


* In most cases, clicking the link is enough to 'view' the activity.
When the teacher selects ''Add requirements'', it opens up more options:
* You should usually not turn on the 'view' condition if you have other requirements - this makes extra work for the server and it's unlikely that a student could meet any other conditions without viewing the activity.
 
[[File:43addreq.jpg|600px]]
 
When the teacher selects ''Receive a grade'' it opens up more options, e.g. Pass grade:
 
[[File:43pass.jpg|600px]]
 
 
===View the activity===
 
When this option is ticked, students have to view the activity i.e. click the link in order to complete it. No need to check the 'view' condition if you have other requirements.


===Require grade===
===Require grade===


When this option is turned on, students have to get a grade on the activity in order to complete it. For example, a quiz would be marked completed as soon as the user submits it (so long as it doesn't contain any "essay" questions).
When this option is ticked, students have to get a grade on the activity in order to complete it. For example, a quiz would be marked completed as soon as the user submits it (so long as it doesn't contain any "essay" questions).


It does not matter how well the student did. Getting any grade will mark the activity completed.
It does not matter how well the student did. Getting any grade will mark the activity completed.
===Receive a passing grade===
A passing grade may be required for completion of a graded activity. This condition is used together with the Require grade requirement.
===Quiz completion settings===


====Setting a grade to pass for a quiz====
====Setting a grade to pass for a quiz====


It is possible to distinguish between 'pass' and 'fail' grades so that a quiz becomes 'completed, passed' or 'completed, not passed' instead of just 'completed'. These results show a different icon and alternative text in ''Course administration >Reports >Activity completion:
It is possible to distinguish between 'pass' and 'fail' grades so that a quiz becomes 'completed, passed' or 'completed, not passed' instead of just 'completed'. These results show a different icon and alternative text in the [[Using Activity completion|Activity completion report]].
''
[[File:quizpassfail.png|thumb|400px|center]]
[[File:quizpassfail.png|thumb|400px|center]]


Line 39: Line 46:


# Go to the Quiz settings and in the Grade section, locate the 'Grade to pass' field.
# Go to the Quiz settings and in the Grade section, locate the 'Grade to pass' field.
# Enter a grade value (e.g. 5.0)  
# Enter a grade value (e.g. 5.0)
# Click the 'Save changes' button
# Click the 'Save changes' button


Line 48: Line 55:
There is one limitation: this only works if grades are immediately visible to students. The grade must be neither permanently hidden, nor hidden until a certain date. If a grade is hidden then only the standard 'completed' state will be displayed - even once the hidden date has passed.
There is one limitation: this only works if grades are immediately visible to students. The grade must be neither permanently hidden, nor hidden until a certain date. If a grade is hidden then only the standard 'completed' state will be displayed - even once the hidden date has passed.


===Quiz completion settings===
====Require passing grade====


The following settings are specific to the quiz (in addition to the standard ones).
If a grade to pass is set for the quiz then it will be marked complete once the student obtains this grade.
[[File:quizpassinggrade.png|thumb|500px|center]]


====Require passing grade====
If a certain number of attempts are allowed, the quiz may be marked complete once the student has done them all (even if, for example, they did not achieve the passing grade.)


If a 'Grade to pass' is set for the quiz then it will be marked complete once the student obtains this grade.
Note that ''Require grade'' must be ticked as well as "Require passing grade".


====All available attempts completed====
====Require attempts in a quiz====


If a certain number of attempts are allowed, the quiz may be marked complete once the student has done them all (even if, for example, they did not achieve the passing grade.)
Quizzes may be automatically marked complete when one or more attempts have been submitted. This can be helpful for example when manually graded questions are included but the teacher wants the quiz to be complete before these questions are graded.


===Lesson completion settings===
===Lesson completion settings===
The following settings are specific to the Lesson activity (in additon to the standard ones)
The following settings are specific to the Lesson activity (in addition to the standard ones)


[[File:newlessonconditions.png]]
[[File:newlessonconditions.png|600px]]


====Require end reached====
====Require end reached====
Line 72: Line 78:
In order for the lesson to be marked complete, the student must stay within the lesson pages for the time specified by the teacher here. The time can range from seconds to weeks. If they finish the lesson sooner, they will see an alert saying they did not reach the minimum time acceptable and may have to repeat the lesson.
In order for the lesson to be marked complete, the student must stay within the lesson pages for the time specified by the teacher here. The time can range from seconds to weeks. If they finish the lesson sooner, they will see an alert saying they did not reach the minimum time acceptable and may have to repeat the lesson.


[[File:lessonstudentviewrequiretimespent.png|thumb|400px|center|Student message if the condition is not met.]]
[[File:lessonstudentviewrequiretimespent.png|thumb|300px|center|Student message if the condition is not met.]]
 
===Assignment completion settings===


===Require submission===
=====Student must submit to this activity to complete it=====
This setting means that an assignment may be considered as completed once the student has submitted it but before the teacher has had time to grade it.


This setting appears in assignments and means that an assignment may  be considered as completed once the student has submitted -  but before the teacher has had time to grade it.
===Forum completion settings===


===Expect completed on===
====Require posts====
For the forum to be classed as "complete" the student must either start a discussion or reply to a discussion. The total number of posts they must make can be specified in the box.


The date is not shown to students and is only displayed in the [[Activity completion report]].
====Require discussions====
For the forum to be classed as "complete", the student must start a discussion topic. The number of posts they must make can be specified in the box. ''Note: this requirement cannot be satisfied using the "Single simple discussion" and the "Q and A" forum types, since students cannot create discussions in those two types.''


===Require posts===
====Require replies====
This setting is seen in forums. For the forum to be classed as "complete" the student must either start a discussion or reply to a discussion. The number of posts they must make can be specified in the box.
For the forum to be classed as "complete" the student must reply to a discussion. The number of posts they must make can be specified in the box.


===Require discussions===
===Expect completed on===
This setting is seen in forums. For the forum to be classed as "complete", the student must start a discussion topic. The number of posts they must make can be specified in the box.


===Require replies===
When a date is entered here for an activity (e.g. Forum, Choice), or for a resource, such as a Page or Folder, the expected completion date will be displayed in the [[Timeline block]].
This setting is seen in forums. For the forum to be classed as "complete" the student must reply to a discussion. The number of posts they must make can be specified in the box.


==Locked completion options==
==Locked completion options==


If at least one person has completed an activity, completion options are 'locked'. This is because changing these options may result in unexpected behaviour. For example, if somebody has ticked an activity as manually completed, and you then set it to automatic completion, the activity will become unticked - very confusing for the student who had already ticked it!
If at least one person has completed an activity, completion options are 'locked'. This is because changing these options may result in unexpected behaviour. For example, if somebody has ticked an activity as manually completed, and you then set it to automatic completion, the activity will become unticked - very confusing for the student who had already ticked it!


:''Tip:'' It is best not to unlock options unless you are sure it won't cause problems - for example, if you know that students don't have access to the course yet, so it will only be staff who have marked the activity completed when testing.
:''Tip:'' It is best not to unlock options unless you are sure it won't cause problems - for example, if you know that students don't have access to the course yet, so it will only be staff who have marked the activity completed when testing.
Line 108: Line 117:
If you change completion options while a student is logged in, they may not see the changes for some minutes.
If you change completion options while a student is logged in, they may not see the changes for some minutes.


==Required site settings==
==Required course settings==
To use activity completion, the feature needs to be enabled for the site by an administrator as follows:
Completion tracking in a course may be disabled/enabled and shown/hidden from the actions menu >Edit settings (Boost theme) or via the course administration block (Classic theme).
*In ''Administration > Site administration > [[Advanced_features| Advanced features]]'' check the "Enable completion tracking" box.
Completion tracking may be set to show or hide conditions on the course page. Manual completion for Label, URL and File will still display the 'Mark as done' button even when completion conditions are hidden.
*The admin may also set the default completion tracking setting when adding new activities, choosing from 'Do not indicate completion' or ' Use activity default'
 
{|
All activity completion conditions are now also visible when clicking into an activity, even when the completion conditions are hidden on the course page.
|[[File:26defaultactivtycompletion.png|thumb|Selecting the default completion tracking setting]]
 
|}
Manual completion may now be done from within the activity, meaning learners can move directly from one activity to the next, without going back to the main course page.
 
==Site administration settings==


* Click the 'Save changes' button
Completion tracking is enabled by default from ''Site administration > General > Advanced features,'' but can be disabled here if not wanted on the site.


==Required course settings==
{{New features}}
{{MediaPlayer | url = https://youtu.be/a64gC_2OKEA | desc = Site level default completion settings}}
 
From ''Site administration > Courses > Default settings'', a new page Default activity completion allows admins to specify sensible default completion for settings in new courses, making it easier for teachers to manage activity completion. All activities are set to None if the admin makes no changes.
 
[[File:sitedefault.jpg|Example sensible default for Choice activity]]
 
==Course activity default settings==
 
Within a course, the default settings for activity completion may be changed and several activities may have their completion settings updated at once, from ''Course navigation > More > Course completion'' and selecting either Default activity completion or Bulk edit activity completion.
 
 
'''Default activity completion''' is the same page as the site-level default activity completion page and allows teachers to change the site-level defaults for their course.
 
'''Bulk edit activity completion''' allows you to change the completion requirements of one or several existing activities in one step. For example, if you have four quizzes with manual activity completion, you can bulk edit them so that all four require a grade to be marked complete.


''Administration > Course administration > Edit settings'' and look for the ''Completion tracking'' section.
==Capabilities==


You must enable this setting.
* [[Capabilities/moodle/course:isincompletionreports|Be shown on completion reports]]
* [[Capabilities/moodle/course:overridecompletion|Override activity completion status]]
* [[Capabilities/report/progress:view|View activity completion reports]]
* [[Capabilities/moodle/course:togglecompletion|Manually mark activities as complete]]


[[Category: Completion]]
[[Category:Completion]]


[[de:Einstellungen zum Aktivitätsabschluss]]
[[de:Einstellungen zum Aktivitätsabschluss]]
[[es:Configuraciones de finalización de actividad]]
[[es:Configuraciones de finalización de actividad]]
[[fr:Paramètres Achèvement des activités]]

Latest revision as of 16:49, 11 January 2024

Activity settings

Depending on the type of activity, there are different completion requirements. For example, a Page might have the requirement to require view; a Quiz might have the requirement to require grade while a Forum might have the requirement to require posts/discussions/replies.


New feature
in Moodle 4.3!


The completion requirements display progressively depending on what the teacher selects and what the default completion settings defined by the admin are.

For example, in this assignment the default setting is None:

43none.jpg

When the teacher selects Add requirements, it opens up more options:

43addreq.jpg

When the teacher selects Receive a grade it opens up more options, e.g. Pass grade:

43pass.jpg


View the activity

When this option is ticked, students have to view the activity i.e. click the link in order to complete it. No need to check the 'view' condition if you have other requirements.

Require grade

When this option is ticked, students have to get a grade on the activity in order to complete it. For example, a quiz would be marked completed as soon as the user submits it (so long as it doesn't contain any "essay" questions).

It does not matter how well the student did. Getting any grade will mark the activity completed.

Receive a passing grade

A passing grade may be required for completion of a graded activity. This condition is used together with the Require grade requirement.

Quiz completion settings

Setting a grade to pass for a quiz

It is possible to distinguish between 'pass' and 'fail' grades so that a quiz becomes 'completed, passed' or 'completed, not passed' instead of just 'completed'. These results show a different icon and alternative text in the Activity completion report.

quizpassfail.png

To set this up, you need to specify the pass value for the quiz activity's individual grade:

  1. Go to the Quiz settings and in the Grade section, locate the 'Grade to pass' field.
  2. Enter a grade value (e.g. 5.0)
  3. Click the 'Save changes' button

'Completed, passed' shows a green tick and 'Completed, not passed' shows a red cross.

Once you have done this, anybody submitting the quiz will receive either the pass or fail completion icon. If the quiz can be taken multiple times, the completion icon will automatically update whenever the grade does.

There is one limitation: this only works if grades are immediately visible to students. The grade must be neither permanently hidden, nor hidden until a certain date. If a grade is hidden then only the standard 'completed' state will be displayed - even once the hidden date has passed.

Require passing grade

If a grade to pass is set for the quiz then it will be marked complete once the student obtains this grade.

If a certain number of attempts are allowed, the quiz may be marked complete once the student has done them all (even if, for example, they did not achieve the passing grade.)

Note that Require grade must be ticked as well as "Require passing grade".

Require attempts in a quiz

Quizzes may be automatically marked complete when one or more attempts have been submitted. This can be helpful for example when manually graded questions are included but the teacher wants the quiz to be complete before these questions are graded.

Lesson completion settings

The following settings are specific to the Lesson activity (in addition to the standard ones)

newlessonconditions.png

Require end reached

In order for the lesson to be marked complete, the student must go to the very last page of the lesson.

Require time spent

In order for the lesson to be marked complete, the student must stay within the lesson pages for the time specified by the teacher here. The time can range from seconds to weeks. If they finish the lesson sooner, they will see an alert saying they did not reach the minimum time acceptable and may have to repeat the lesson.

Student message if the condition is not met.

Assignment completion settings

Student must submit to this activity to complete it

This setting means that an assignment may be considered as completed once the student has submitted it but before the teacher has had time to grade it.

Forum completion settings

Require posts

For the forum to be classed as "complete" the student must either start a discussion or reply to a discussion. The total number of posts they must make can be specified in the box.

Require discussions

For the forum to be classed as "complete", the student must start a discussion topic. The number of posts they must make can be specified in the box. Note: this requirement cannot be satisfied using the "Single simple discussion" and the "Q and A" forum types, since students cannot create discussions in those two types.

Require replies

For the forum to be classed as "complete" the student must reply to a discussion. The number of posts they must make can be specified in the box.

Expect completed on

When a date is entered here for an activity (e.g. Forum, Choice), or for a resource, such as a Page or Folder, the expected completion date will be displayed in the Timeline block.

Locked completion options

If at least one person has completed an activity, completion options are 'locked'. This is because changing these options may result in unexpected behaviour. For example, if somebody has ticked an activity as manually completed, and you then set it to automatic completion, the activity will become unticked - very confusing for the student who had already ticked it!

Tip: It is best not to unlock options unless you are sure it won't cause problems - for example, if you know that students don't have access to the course yet, so it will only be staff who have marked the activity completed when testing.

What happens when you unlock

Once you unlock options and then click 'Save changes', all completion information for the activity will be deleted and, if possible, regenerated according to the new settings.

  • If the new completion option is manual, everyone will be set to 'not completed' regardless of any previous setting.
  • If it is automatic then, depending on the options chosen, the system may or may not be able to construct a correct current value for everyone.
    • The 'viewed' requirement will not work - even if a student has viewed the activity before, it will not be marked completed until they view it again.
    • Most other options will be recalculated successfully.

If you change completion options while a student is logged in, they may not see the changes for some minutes.

Required course settings

Completion tracking in a course may be disabled/enabled and shown/hidden from the actions menu >Edit settings (Boost theme) or via the course administration block (Classic theme). Completion tracking may be set to show or hide conditions on the course page. Manual completion for Label, URL and File will still display the 'Mark as done' button even when completion conditions are hidden.

All activity completion conditions are now also visible when clicking into an activity, even when the completion conditions are hidden on the course page.

Manual completion may now be done from within the activity, meaning learners can move directly from one activity to the next, without going back to the main course page.

Site administration settings

Completion tracking is enabled by default from Site administration > General > Advanced features, but can be disabled here if not wanted on the site.

New feature
in Moodle 4.3!

Site level default completion settings

From Site administration > Courses > Default settings, a new page Default activity completion allows admins to specify sensible default completion for settings in new courses, making it easier for teachers to manage activity completion. All activities are set to None if the admin makes no changes.

Example sensible default for Choice activity

Course activity default settings

Within a course, the default settings for activity completion may be changed and several activities may have their completion settings updated at once, from Course navigation > More > Course completion and selecting either Default activity completion or Bulk edit activity completion.


Default activity completion is the same page as the site-level default activity completion page and allows teachers to change the site-level defaults for their course.

Bulk edit activity completion allows you to change the completion requirements of one or several existing activities in one step. For example, if you have four quizzes with manual activity completion, you can bulk edit them so that all four require a grade to be marked complete.

Capabilities