Activity completion

Activity completion allows the teacher to set completion criteria in a specific activity's settings. A check image appears against the activity when the user meets this criterion. The criterion might be viewing, receiving a certain score or a user marking it as complete.

A teacher may mark an activity complete on behalf of a user from the Activity completion report if they have the capability Override activity completion (which is enabled by default.)

Activity completion settings

Activity settings

Depending on the type of activity, there are different completion requirements.

Completion tracking

There are three options:

  • Do not indicate activity completion - this will not show checks (ticks) next to the activity
  • Users can manually mark the activity as completed - users 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 ticked, users have to view the activity i.e. click the link in order to complete it. You should not turn on the 'view' condition if you have other requirements - this makes extra work for the server and it's unlikely that a user could meet any other conditions without viewing the activity.

Require grade

When this option is ticked, users 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 user 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 the Activity completion report.

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

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 '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 users. 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 user obtains this grade.

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

Note

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

Lesson completion settings

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

Require end reached

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

Require time spent

In order for the lesson to be marked complete, the user 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.

Assignment completion settings

User must submit to this activity to complete it

This setting means that an assignment may be considered as completed once the user 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 user 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 user 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 users cannot create discussions in those two types.

Require replies

For the forum to be classed as "complete" the user 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 a Forum activity, or for a resource, such as a Page or Folder, the expected completion date will be displayed on the Course overview 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 user 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 users 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 user 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 user is logged in, they may not see the changes for some minutes.

Required course settings

See Enabling course completion.

You must enable this setting.

Changing activity completion settings in bulk

Within a course, the default settings for activity completion may be changed and several activities may have their completion settings updated at once, from the tabs in the Course completion screen.

Default activity completion allows you to select one or more course activities or resources and change their default settings (usually 'manual') to a setting of your choice. For example, if you always want your quizzes to be completed with a specific passing grade, you can specify this here. If you always want assignments to be completed when submitted, you can specify this here. Note that the altered settings only apply to items added after the change, not to existing items on the course page.

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.

Using Activity completion

Why use Activity completion

  • If this feature is enabled, it is a helpful way for users to be able to track their progress in a course. The user has an easy to see checklist of what they have done so far.
  • It can also be linked to Course completion in order to allow both users and teachers to watch progress through a course. As each activity is checked off as "complete", the user moves futher towards final completion of the course.
  • It can also be linked to Restrict access in order to allow the teacher to set criteria upon which a user is allowed to progress through a course and access materials.
  • It is possible to edit default activity completion settings within a course and to bulk update the settings for existing activities.

Activity completion icons

image manual - not yet marked as complete

image manual - enabled

image manually completed

image automatically completed

image automatically failed

image automatic - not completed

image automatically passed

image automatic - enabled

The manual - enabled and automatic - enabled icons are used on the course page when editing is turned on for teachers to see at a glance which activities have manual completion and which have automatic completion.

Activity completion report

Activity completion info can be viewed by managers, teachers and non-editing teachers by clicking course actions image at the top right of the page in line with the course name and selecting "Show More> Reports>Activity completion"

Teachers can mark activities complete on behalf of users by clicking into the relevant completion boxes.