Activities: Checklist

Maintained by DavoDavo 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.
5472 sites
137 fans

Travis status

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 sets Checklist, MoodleCloud.


Screenshot #0
Screenshot #1


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

Comments RSS

Show comments
  • Davo
    Wed, Feb 12, 2020, 6:46 AM
    Hi Brian,

    Yes - I've seen the initial pull request and the review request that followed a couple of days later, and now your follow up message a couple of days after that. My own plugins are maintained in my free time, so it is rare for me to have space / time to review contributions. I will try to look at this in the next few weeks, but I cannot guarantee when that will be.
  • Picture of Chris Pratt
    Wed, Feb 19, 2020, 8:20 PM
    Hi, we are experiencing an issue where a checklist is only 87% complete but the instructor received an email saying the student in question had completed the list. Have you had any similar reports? Thanks
  • Davo
    Wed, Feb 19, 2020, 8:24 PM
    Hi Chris,

    There are a few possibilities I can think of off the top of my head:
    * The checklist is set to be 'complete' for some value less than 100% (e.g. at 85%) - check the activity settings for this
    * The checklist contains a mix of required and optional items, the user has completed all the required items, but not all of the optional items, so the checklist is counted as being complete
    * The user ticked all of the items on the checklist (triggering the completion email), then unticked some of them again

    If none of those are the issue, then I'd need more details about how to consistently reproduce the issue on a clean Moodle site, otherwise there isn't much I can do to help.
  • Picture of Rick Jerz
    Sat, Mar 21, 2020, 1:41 AM
    Hi Davo, I continue using your great Checklist plug-in. I wanted to mention an odd (minor) problem that I have had the last several times (the last 2 months or so) when I upgrade my Moodle. My upgrade fails with the this screen () To fix this, I delete the checklist folder on my server, then move the same copy (from my computer) back to the same location, hit "continue" and then I have success. I thought that I would mention it to you. Maybe it has something to do with the order of how Moodle updates itself.
  • Davo
    Sat, Mar 21, 2020, 2:13 AM
    The error says that there is no lang/en/checklist.php file. That is clearly not the case, as it is working for everyone else. I think you should check the file permissions on your server, as it sounds like it can't see all the files it should.
  • Picture of Tobias Sanders
    Sun, Jun 14, 2020, 2:22 AM
    Hey Davo,
    your plugin is a great of help when it comes to individual learning. It's much better than the internal activity completion plugin.
    I discovered that student can check activities as complete even if teachers have set access restrictions and/or a completion rule in the activity. Would be great if those items can not be marked as complete by the student without meeting the conditions/restrictions first. Furthermore the due dates set in the course activity should automatically appear in the plugin.
    It would also be of great help if students could reply to teacher comments for a certain item. Like a discussion option for each item.
    I know that is much to ask but if you find any of the suggestions useful and also the time to implement them I would be greatful.
  • Davo
    Sun, Jun 14, 2020, 3:44 AM

    If you don't want students to override the automatically checked-off items, then select "automatic, cannot override" instead of "automatic, can override".

    In Moodle, there is no such thing as a generic "due date" for activities - supporting automatic importing of dates would have to be written specifically for each different activity type.

    Replying to comments might be possible to implement, but it would probably be quite a bit of work to do so (I've not looked at the code involved for a long time - possibly it might be worth rewriting it using the Moodle comments system, that didn't exist when I first wrote my code).

    Thanks for the suggestions - there do seem to be some good ideas in there. Unfortunately, I spend all of my working days writing Moodle code, so it is not something I do in my free time any more (other than urgent bug fixes and checking my plugins work with new Moodle releases). I'm happy to accept simple, well written patches from other developers. I'm also happy to pass on contact details for my employers, Synergy Learning, if you have funding available to pay for the work to be done during my working hours.
  • Picture of Tobias Sanders
    Mon, Jun 15, 2020, 4:36 PM
    Hey Davo, thank you for your fast reply. As we are focussing more and more on individual learning paths a plugin that helps structuring the progress for teachers and learners AND visualizes the daily tasks would be great. As I said the built in tools (learning plans and completion) do not match our criterias right now. I totally understand that this work is worth paying for. I'll discuss this with my colleagues and perhaps get in touch with you. Cheers
  • Picture of Martin Powis
    Tue, Sep 8, 2020, 9:01 PM
    Hi Davo

    Is it possible to change the colour of the progress bar from green?


  • Davo
    Tue, Sep 8, 2020, 9:05 PM

    Yes - in your theme, override the styling for: .checklist_progress_inner and .checklist_progress_anim

    You'll need to change the background-image to point at a different image, for completeness you should also change background-color (although that will only show if the image loads slowly).

  • Picture of Martin Powis
    Tue, Sep 8, 2020, 9:22 PM
    Thanks Davo, I'll give that a go. Or give the job to someone who can be trusted smile
  • Picture of Andrew Zito
    Tue, Sep 22, 2020, 12:52 AM
    Hi Davo, I just wanted to let you know that because the last two releases of your plugin (the ones for 3.4+ and 3.9) have the same version number (2020012900), those using your plugin via Composer cannot get the correct version. For example, we are still on 3.7, and when I ask Composer for '2020012900' it gives me the 3.9 version, which we can't use.
  • Davo
    Tue, Sep 22, 2020, 2:17 AM
    Hi Andrew - there isn't any practical difference between the versions. The change was only to make travis-ci happy. If you're using an unsupported method to install the plugin, and it isn't working, then I'd advise you to use one of the standard methods to install it directly. I'll try to remember to bump the version number when I'm next doing a release (which is likely to be around the time that 3.10 comes out).
  • Picture of Charles Fulton
    Fri, Oct 30, 2020, 5:15 AM
    Hi Davo, I work with Andrew, and it's not an option for us to install the plugin directly. We build our server packages in an automated CI environment. It's crucial for us, and probably for others, that those version numbers be unique. This is also best practice per Thanks, Charles.
  • Davo
    Fri, Oct 30, 2020, 5:32 AM
    The docs don't seem to state anywhere that the version number should be different between versions of the plugin, only that the version number should be changed to trigger an upgrade (not needed in this case) and that, when changing numbers, it should always increase across supported branches.

    Nevertheless, as already stated, I will make sure that I increase the version number on the next release (which will happen in the next week or so, with the release of 3.10), to avoid such edge cases in the future.
Please login to post comments