Skip to content
Dan Marsden edited this page Jul 24, 2018 · 5 revisions

The recompetion plugin adds course level settings for recompletion - clearing all course and activity completion for a user based on a duration, notifying the student they need to return to the course and recomplete it.

This plugin could be used to facilitate annual re-certification.

Setting up a course to facilitate recompletion.

  • Under administration > Advanced features, make sure "Enable completion tracking" is set to yes.
  • In the course settings, make sure "Enable completion tracking" is set to "yes"
  • Add some activities to the course that have activity completion settings configured.
  • Click on the cog at the top right of your course and choose "Course Completion"
  • Set the conditions required for course completion. Note: you must set some conditions, you cannot just set the "completion requirements" option at the top. Save.
  • Click on the cog at the top right of your course and choose "More.." to view all settings/reports for this course. Make sure you can now see "Course completion" listed under "reports". If you cannot see this report then course completion has not been set correctly.
  • Click on the cog at the top right of your course and choose "Course recompletion"
  • Tick the box for "Enable recompletion" and set the recompletion period. (note the seconds/minutes option is only intended for testing and the recompletion scheduled task is set to run hourly by default.) If you want to trigger recompletion faster than 1 hour you will need to run the recompletion task manually or change the frequency under admin > server > scheduled tasks.

Data reset during recompletion

The following information is cleared from the course during recompletion:

  • All activity grades cleared (and saved to standard grade history tables.)
  • All activity completion and course completion flags removed. (with the option to archive this information)

The following activities have extra support:

  1. Quiz - You can choose to delete all existing quiz attempt data with the option to archive the information or, you can keep the existing attempts and give the student the ability to add new attempts.

  2. SCORM - You can choose to delete all existing SCORM attempt data with the option to archive the information.

  3. Assignment - You can choose to give the student another attempt (if the assignment is configured to allow reopening and the maximum number of attempts has not been reached.

Other activities that store user data will have the activity completion data reset, but may require manual intervention as they are not yet supported fully. Get in touch privately if you would like to fund support for other activities with user data.

Cron

The recompletion requires cron is set up correctly on your site, however if testing the plugin it might be helpful to be aware of the following scheduled tasks.

  • \core\task\completion_regular_task - this task may need to be run multiple times for a users course completion to be marked complete.
  • \local_recompletion\task\check_recompletion - this task is responsible for checking if a recompletion is required.

Tips for testing.

First make sure you have some users that have completed the course by clicking on the cog in the top right of your course and choosing "more" then find the "Course Completion" report and check to make sure you have some users that have the "course complete" box ticked. If they have completed all the expected activities but the course complete box is still not ticked, the cron process is not running or you have set course completion settings wrong. To manually trigger completion you could try going to admin > server > scheduled tasks and find the task "\core\task\completion_regular_task" and hit the option to "run now" - you may have to make this run multiple times. Check to see if you now have students with the "course complete" box ticked.

Clone this wiki locally