Note: You are currently viewing documentation for Moodle 2.9. Up-to-date documentation for the latest stable version of Moodle may be available here: Activity completion settings.

Activity completion settings: Difference between revisions

From MoodleDocs
mNo edit summary
(screenshot and extra details)
 
(29 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Activity completion}}==Enabling activity completion==
{{Activity completion}}
==Activity settings==


To use activity completion, the feature needs to be enabled for the site by an administrator as follows:
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''.
#In ''Settings > Site Administration > [[Advanced_features| Advanced features]]'' check the "Enable [[Completion  tracking|completion tracking]]".
 
# Click the 'Save changes' button
<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===
There are three options:
 
*''Do not indicate activity completion'' - this will not show checks (ticks) next to the activity
*''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===
 
When this option is turned on, students have to view the activity in order to complete it.
 
* In most cases, clicking the link is enough to 'view' the activity.
* 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.
 
===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).


An activity completion section will then be displayed in an activity's 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'' as below.
It does not matter how well the student did. Getting any grade will mark the activity completed.


Activity completion settings for a page:
====Setting a grade to pass for a quiz====


[[File:Acompletionsettings.png]]
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:
''
[[File:quizpassfail.png|thumb|400px|center]]


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


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


==Completion tracking settings==
'Completed, passed' shows a green tick and 'Completed, not passed' shows a red cross.


There are three settings:
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.


[[File:Completiontrackingsettings.png]]
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.


*''Do not indicate activity completion'' - this will not show checks(ticks)next to the activity;
===Quiz completion settings===
*''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.


==Activity completion criteria==
The following settings are specific to the quiz (in addition to the standard ones).
The completion criteria  you see depend on the activity.
[[File:quizpassinggrade.png|thumb|500px|center]]


===Require view===
====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.
 
====All available attempts completed====


When this option is turned on, students have to view the activity in order to complete it.
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.)


* In most cases, clicking the link is enough to 'view' the activity.
===Lesson completion settings===
* 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.
{{New features}}The following settings are specific to the Lesson activity (in additon to the standard ones)


===Require grade===
[[File:newlessonconditions.png]]


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.
====Require end reached====
In order for the lesson to be marked complete, the student must go to the very last page of the lesson.


It does not matter how well the student did. Getting any grade will mark the activity completed.
====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.


It is possible to distinguish between 'pass' and 'fail' grades so that the activity becomes 'completed, passed' or 'completed, not passed' instead of just 'completed'. These results show a different icon and alternative text.
[[File:lessonstudentviewrequiretimespent.png|thumb|400px|center|Student message if the condition is not met.]]


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


# Go to the course gradebook by clicking the 'Grades' link on the course administration block.
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.
# From the 'Choose an action' dropdown, pick 'Categories and items'.
# Click the Edit icon next to the grade item for this activity.
# Turn on 'Show Advanced'.
# Type a grade value (e.g. 5.0) in the 'Grade to pass' box.


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.
===Expect completed on===


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.  
The date is not shown to students and is only displayed in the [[Activity completion report]].


===Require posts===
===Require posts===
Line 66: Line 93:
==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.
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 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.
 
 
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==
==What happens when you unlock==
Line 84: Line 108:
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==
To use activity completion, the feature needs to be enabled for the site by an administrator as follows:
*In ''Administration > Site administration > [[Advanced_features| Advanced features]]'' check the "Enable completion tracking" box.
*The admin may also set the default completion tracking setting when adding new activities, choosing from 'Do not indicate completion' or ' Use activity default'
{|
|[[File:26defaultactivtycompletion.png|thumb|Selecting the default completion tracking setting]]
|}
* Click the 'Save changes' button
==Required course settings==
''Administration > Course administration > Edit settings'' and look for the ''Completion tracking'' section.
You must enable this setting.
[[Category: Completion]]


[[de:Einstellungen zum Aktivitätsabschluss]]
[[de:Einstellungen zum Aktivitätsabschluss]]
[[es:Configuraciones de finalización de actividad]]

Latest revision as of 14:29, 2 November 2015

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.

Completion tracking

There are three options:

  • Do not indicate activity completion - this will not show checks (ticks) next to the activity
  • 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

When this option is turned on, students have to view the activity in order to complete it.

  • In most cases, clicking the link is enough to 'view' the activity.
  • 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.

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

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

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:

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.

Quiz completion settings

The following settings are specific to the quiz (in addition to the standard ones).

quizpassinggrade.png

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.

All available attempts completed

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

Lesson completion settings

New feature
in Moodle 2.9!
The following settings are specific to the Lesson activity (in additon 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.

Require submission

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.

Expect completed on

The date is not shown to students and is only displayed in the Activity completion report.

Require posts

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.

Require discussions

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

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

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 site settings

To use activity completion, the feature needs to be enabled for the site by an administrator as follows:

  • In Administration > Site administration > Advanced features check the "Enable completion tracking" box.
  • The admin may also set the default completion tracking setting when adding new activities, choosing from 'Do not indicate completion' or ' Use activity default'
Selecting the default completion tracking setting
  • Click the 'Save changes' button

Required course settings

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

You must enable this setting.