Assignment submissions : Mahara Assignment Submission

Maintained by Mahara logo Aaron Wells, Picture of Tony Box Tony Box, Picture of Ruslan Kabalin Ruslan Kabalin, Picture of Catalyst IT Catalyst IT
Allows grading of Mahara portfolio pages & collections in Moodle.
611 sites
15 fans
Moodle 2.3, 2.4, 2.5

Mahara Assignment Submission Plugin

This repository houses an updated Mahara assignment submission plugin.


  • XML-RPC integration with a Mahara installation
  • The student selects one of their Mahara portfolio pages or collections as a Moodle assignment submission
  • If multiple submissions are allowed, it releases the previously selected submission
  • Abides by Moodle assignments config options
  • Popups for quickly previewing submissions (no windows... no tabs)
  • Mahara pages can be made to lock upon submission, and unlock upon grading. Or stay permanently locked. Or not lock at all.
  • Unlock-on-grading functionality also supports marking workflow. Submitted pages will unlock when the workflow state changes to "Released".



  1. Make sure that your Moodle and Mahara versions are up to date.
  2. Connect your Moodle and Mahara sites via MNet. (For detailed instructions see the Mahara wiki).
  3. If you are using Mahara 1.9 or earlier, apply the included patch file "mahara-patch.txt" to your Mahara site.
  4. If you are using Moodle 2.6, apply the included patch file "moodle-patch.txt" to your Moodle site.
  5. If you are using Moodle 2.5 or earlier, install the Mahara local plugin now.
  6. Install this plugin the normal way: by using the Moodle web installer, or by extracting the plugin archive to {Moodle_Root}/mod/assign/submission/mahara and going to the admin "Notifications" page.
  7. Once the plugin is installed, go to "Site administration -> Networking -> Manage Peers". Select the peer record for your Mahara site, click on the "Services" tab, and subscribe to the "Assign Submission Mahara services" service.
  8. Open the "Site admin" -> "Plugins" -> "Activity modules" -> "Assignment" -> "Submission plugins" -> "Mahara portfolio" and configure default locking behavior.
  9. Now you may create your first Mahara assignment.

Upgrading (Moodle 2.6 or later)

There were previously two different forks of the Mahara assignment submission plugin for Moodle, one developed by the University of Portland, and another by Lancaster University. This plugin is designed to allow you to upgrade from either. It will automatically detect which version of the plugin you have installed, and migrate it accordingly. So all you need to do is:

  1. Remove the current contents of your mod/assign/submission/mahara directory.
  2. Follow the steps under "Installation" above. (This will trigger the database upgrade script.)
  3. If you are using Moodle 2.7 or later and you have previously installed the Mahara assignment feedback plugin (mod/assign/feedback/mahara), the upgrade will prompt you to uninstall it. You will then need to remove its directory.
  4. If you have also installed the Mahara local plugin (local/mahara), you should now uninstall it and remove its directory.

NOTE: If you were using the Mahara assignment feedback plugin before, you need to upgrade this assignment submission plugin before uninstalling the assignment feedback plugin. This is to allow the per-assignment locking settings from the feedback plugin to be migrated into the replacement system in the submission plugin.


  1. Go into a Moodle course as a teacher.
  2. An an "Assignment" activity to the course.
  3. Under the assignment's "Submission types" section, you should see an option for "Mahara portfolio". Tick this box, and any others you also want the student to include in their submission.
  4. Use the "Lock submitted pages" menu to choose whether you want submitted Mahara pages & collections to be locked from editing in Mahara. This feature is useful if you wish to prevent students to edit the page after the submission deadline.
  5. Once the assignment is set up, a student in the course will see a screen to let them select one of their Mahara portfolio pages or collections as part of their assignment submission.
  6. As the teacher, when you view the assignment submission via the gradebook, you will see a link that will allow you to view the submitted Mahara page or collection. (The plugin will automatically generate the access rights in Mahara).
  7. See the Readme for more details.

Feedback plugin (Moodle 2.6 only)

In Moodle 2.6, if you set the plugin to lock submitted pages & collections, they will remain locked in Mahara permanently. If you wish them to become unlocked once they are graded, you should also install the Mahara assignment feedback plugin, and activate it in your assignment.


Please use plugin repository bug tracker for reporting issues.


The original Moodle 1.9 version of this plugin was funded through a grant from the New Hampshire Department of Education to a collaborative group of the following New Hampshire school districts:
  • Exeter Region Cooperative
  • Windham
  • Oyster River
  • Farmington
  • Newmarket
  • Timberlane School District

The upgrade to Moodle 2.0 and 2.1 was completed by Aaron Wells at Catalyst and supported by NetSpot and Pukunui Technology.

The upgrade to the Moodle 2.3 mod/assign plugin was developed by:

Subsequent updates to the plugin for Moodle 2.6 and 2.7 were implemented by Aaron Wells at Catalyst with funding from:

The upgrade to use events for unlocking behaviour and supporting grading workflow was developed by Lancaster University.


This plugin is part of set Mahara assignment.

Potential privacy issues

Mahara pages & collections submitted by the student will be visible to the teacher (or any Moodle user who can view the gradebook), regardless of their privacy settings in Mahara. The plugin generates a special "secret URL" for this purpose, which it links to in the Moodle gradebook. This acts like any other Mahara "secret URL", except that the student cannot delete it, and it will only work for users who are logged in to Mahara via MNet. If the page is released after grading, the "secret URL" will be disabled at that time.


Screenshot #0
Screenshot #1
Screenshot #2
Screenshot #3
Screenshot #4
Screenshot #5


Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Mahara logo
    Thu, 12 Mar 2015, 10:15 AM
    Thanks Chris, I'm glad to hear it!
  • Picture of Anis Jradah
    Wed, 27 May 2015, 4:23 PM
    Dear All,

    While we are upgrading to the latest version we are getting this error:
    Cannot downgrade assignsubmission_mahara from 20140412000 to 2014082002.

    Any help.

    Thank you,
  • Mahara logo
    Thu, 28 May 2015, 7:43 AM
    It appears that the problem Anis describes, is due to the last release of the Portland U plugin having an erroneous extra "0" on the end of its version number. The workaround is to directly update the stored version number in your database.

    update mdl_config_plugins set value='2014041200' where plugin='assignsubmission_mahara' and name='version' and value='20140412000';

    There is a bug tracker report about this issue here:
  • Picture of Remy Olasoji
    Wed, 7 Oct 2015, 6:38 PM
    Dear all,

    Thanks for these plugin which I believe I installed successfully today. As directed, I subscribed to "Assign Submission Mahara services" on our peer record's Services tab. However, when I tried to add an assignment activity to a course, there was no option for Mahara as a submission type.

    Have I missed a step?

  • Picture of Remy Olasoji
    Wed, 7 Oct 2015, 6:40 PM
    By the way, we've got Moodle 2.7.7 and Mahara 15.04 installed so I've downloaded and installed assignfeedback_mahara_moodle27_2014051200 & assignsubmission_mahara_moodle27_2014110502 plugins.
  • Picture of Remy Olasoji
    Wed, 7 Oct 2015, 10:20 PM

    UPDATE: Please ignore the above two comments. The option is now showing - cache problem I guess.
    My apologies.

  • Picture of Anis Jradah
    Wed, 4 Nov 2015, 8:46 PM
    Dear All,

    Kindly advise if this plug-in works well with Moodle 2.9

    Thank you for your help.

    Best regards,
  • Mahara logo
    Fri, 6 Nov 2015, 1:32 PM
    Hi Anis,

    I haven't tested it in Moodle 2.9 yet, so I can't say for sure. But at a quick glance it looks like there aren't any major API differences for mod/assign between 2.8 and 2.9, so the Moodle 2.8 version will probably work in Moodle 2.9.

  • Mahara logo
    Mon, 9 Nov 2015, 2:43 PM
    Update: It has been verified that the plugin works in Moodle 2.9.
  • Mahara logo
    Mon, 7 Dec 2015, 1:15 PM
    I've tested and found that the current version of the plugin also works fine in Moodle 3.0:
  • Mahara logo
    Fri, 3 Jun 2016, 12:19 PM
    Tested in Moodle 3.1 with no problems.
  • Picture of Andreas Schenkel
    Thu, 8 Dec 2016, 3:10 AM
    Hello. I am thinking about installing the "Mahara Assignment Submission plugin" for many moodle instances. Will the development of this plugin be continued in the future for the new moodle relaeses?
    I am a little bit afraid to install the plugin for so many schools. If the developement would stop then many schools would be disappointed ... So what should I do. Can you give me a hint?
  • Mahara logo
    Mon, 9 Jan 2017, 6:36 AM
    Hi Andreas,

    My employer, Catalyst IT in New Zealand, is one of the primary maintainers of this plugin (and of Mahara). We're an open-source software consulting company. If you want some assurance that the plugin will continue to be maintained, your surest bet would be to look into opening a support contract with us. smile

    Outside of that, we try to at least test out the plugin against each new Moodle release to ensure that it continues to function. The fine folks at University of Portland and University of Lancaster have been putting in occasional work on the plugin as well, as needed by their institutions. And as an open-source project, we always welcome contributions from anyone, via the project's Github page.

  • Lina
    Fri, 3 Mar 2017, 5:31 PM
    Hi Aaron,
    We have installed the Mahara assignment plugin on Moodle3.1 and it was working fine.
    But after we've upgrade the Mahara to Mahara 16.10.1., we found the problem as below:

    Students can login to Mahara through Moodle. So the SSO is working fine.
    But when the students trying to add a Mahara submission, after they click the "add submission" button, it is always saying:
    You have no available Mahara pages or collections. Please click here to visit "Mahara" and create a new one.

    But the students do have a lot pages which are just created, haven't submitted to any other assignments yet.
    Would you please help with this?
    Many thanks.

    Best wishes,
  • Picture of Kristina Hoeppner
    Fri, 24 Mar 2017, 4:55 AM
    Discussed with Lina at and problem was resolved.
1 2
Please login to post comments