Your Moodle version

Activities: Checklist

Maintained by Davo Davo Smith
A checklist can be created by a teacher (or generated from the activities in a course) and then the students or teachers can check-off each item as they are completed.
Moodle 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 3.0, 3.1

This is a Moodle activity module for Moodle 1.9 and Moodle 2.0+ that allows a teacher to create a checklist / todo list / task list for their students to work through. The teacher can monitor all the students' progress, as they tick off each of the items in the list. Items can be indented and marked as optional. Students are presented with a simple bar showing how far they have progressed through the required/optional items and can add their own, private, items to the list. 
Features include:

  • Choose whether students or teachers can check-off items
  • Students can add their own notes to their checklist
  • Dates can be added to items (and exported to the calendar)
  • Teachers can comment on an individual student's items
  • Progress is exported to the gradebook
  • Choice of colours for each checklist item
  • Heading items (without checkboxes)
  • (Optional) Import list of current course activities and automatically check-off as activities completed

There are two other plugins that further enhance this activity:

Video overview of this plugin:

The latest version (and the Moodle 1.9 version) can always be found here: (the version on will be updated from time to time)


This plugin is part of set Checklist.


Davo Smith (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Adele Shemberger
    Fri, Feb 26, 2016, 4:38 AM

    Thanks for the response. I assumed you just missed the original comment. We have a Moodle Partner. I'll have to see if they'd be willing to take a look at it. If you do get a chance to look at it and patch it please let me know. I can't thank you enough for this tool.
  • Picture of Michael Lynn
    Tue, Mar 8, 2016, 7:24 PM
    We are using this plugin with Moodle 2.5.4+ and have noticed that an error is logged every time the cron runs:
    [08-Mar-2016 10:46:02 UTC] PHP Fatal error: Class 'mod_checklist\local\autoupdate' not found in /home/mysite/public_html/mod/checklist/lib.php on line 695

    On this test server the error logging level is: $CFG->debug = (E_ALL | E_STRICT);
    Turning off error logging suppresses the error in the log.
    Is there a fix for this?
  • Davo
    Tue, Mar 8, 2016, 7:29 PM
    It should work fine if you upgrade to any of the currently-supported versions of Moodle (2.7 or above), but if you are unable to upgrade, then it should be possible to fix by adding into that function:

  • Picture of Michael Lynn
    Tue, Mar 8, 2016, 7:48 PM
    That works! Thanks. We plan to upgrade to 2.9.4 at some time in the near future.
  • Picture of Frank Leone
    Tue, Mar 8, 2016, 11:57 PM
    Thanks for the great plug-in! We plan to use the checklist plug-in to allow student groups to manage themselves. In other words: they set all the to-do's, including deadlines. For this, we can give the students to access the edit-page.

    In addition, we need a separate list of to-do's per group, rather than one shared for all groups/students. Moreover, they should only be able to see progress within their own group, not in other groups. We will now solve this by making a single-activity course, with only a checklist, for each group of students. In that way, they can manage their own to-do's and also have a sense of group progress.

    However, this is quite a detour. Davo, do you have any suggestions on how we can do this easier? I'm happy to make the edits myself, but some pointers would be nice. Afterwards, we would also like to add assigning to-do's to specific users, etc, but that's for later smile
  • Davo
    Wed, Mar 9, 2016, 4:04 PM
    Hi Frank - I don't think there is any simple way to make what you want easier to do. You can enable per-user checklist items, but they can only be seen by the user in question, not any other users. There is no support for adding per-group items (or allowing users to edit per-group).

    In theory, some of this *should* be easy to add to the code and, if I was writing it now (with many more years Moodle dev experience), they could be added very quickly. However, the code is messy and long overdue a refactor, making small changes much more difficult to implement.
  • Picture of Paula Moreira
    Sat, Mar 26, 2016, 11:45 PM
    Hi Davo,

    I want the % to show on the block after the bar. is there a simple way to get that? If i open the cheklist i have the % para i wish that could also be seen on the course page. Thanks
  • Davo
    Sat, Mar 26, 2016, 11:58 PM

    If you want to show the percentage in the block, then open up blocks/checklist/block_checklist.php and edit the lines that call 'print_user_progressbar', to change the 4th param from 'false' to 'true' (without quotes). The first call to 'print_user_progress' in that file is for teachers seeing an overview of all students in the course, the second call is for students seeing their own progress bar.
  • Picture of Paula Moreira
    Mon, Mar 28, 2016, 7:52 PM
    Thanks Davo! works perfectly!
  • Picture of Raad Al-Rawi
    Fri, Apr 8, 2016, 10:23 PM
    Hi Davo

    We're using checklist 2.x (Build: 2014080601) with our main University Moodle v2.7.7 and we would very much like to have support for the Book module, so that student progress can be monitored against course content in books.
    We are currently in the early stages of our upgrade to 3.0.x - is this something that is in the Moodle v3 version of checklist, or if not, is it on the roadmap?

    Best regards

  • Davo
    Fri, Apr 8, 2016, 10:35 PM
    There is no particular roadmap of new features for the checklist plugin. I rarely add new features, as it already does most things that people want.

    I'm not clear exaclty what support you are wanting for the book module. Is it just updating the checklist when a book activity is 'complete'? If so, the easiest way to do this is to use the standard Moodle activity completion and my plugin will pick this up automatically. If you can't use this, then someone would need to find the name of the event (if any) that fires when a book is finished, then edit mod/checklist/classes/local/autocomplete.php to add the name of this event.
  • Picture of Matt Polaniecki
    Sat, Apr 16, 2016, 12:20 AM
    Thank you so much for this great plugin!

    My question is when you create multiple checklists for different groups in a course, they all show in the gradebook as expected grades for all students.

    For example, if have Group A, Group B, and Group C in my course, I would create 3 checklists that correspond to those groups. I would then restrict access based on groups so that each group can only see the correct checklist.

    The problem is that in the gradebook, it shows all checklists for all students and would give a 0 to that student if they haven't completed the checklist. Is there a way to filter out the gradebook to only show checklists that were assigned to that group?
  • Davo
    Tue, Apr 19, 2016, 3:32 AM
    Matt - not that I'm aware of. I don't think the gradebook has any functionality built in to it to exclude items related to activities that certain users cannot access (due to groups or other access restrictions).

    Maybe you could take a look on and see if there exists a feature request for that?

    An alternative might be to simply not include any checklist in the gradebook (do this by setting the grade to 0 in the checklist settings).
  • Picture of Ryan Bernstein
    Sat, May 14, 2016, 1:04 AM

    We're hoping to find a way to value the checklist in the gradebook as either a 0 value or a 1. The maximum value of the activity is 1 point, but Moodle seems to round up in the gradebook. For example, if there are 6 checklist items in the activity, and the student completes 4 of them, he gradebook will display a .67% for the grade item. We'd like it to be all or nothing. The student would have to check all 6 items to earn the point. Anything less than 6 is a 0.

    Thanks or any help you can provide.
  • Davo
    Sat, May 14, 2016, 1:49 AM
    Ryan - I think the closest you can get to this, without code changes, would be to use 2 checklists and activity completion. The first would work as it does now, but with the score set to 0. The second would import the activities from the course, but exclude everything except for the first checklist (the second checklist could be put in an orphaned course section to hide it from students). The second would have its score set to 1.

    Once the first checklist was complete the one and only item in the second checklist (i.e. the first checklist itself) would be marked as complete. So, the score for the second checklist would be either 0 or 1.

    Maybe a bit fiddly to implement, but possibly less confusing than adding another setting to the checklist module to cover this use case ...
1 2 3 4 5 6 7 8 9 10 11 12 13 14
Please login to post comments