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.

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.

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:

Remove the current contents of your mod/assign/submission/mahara directory.

Follow the steps under "Installation" above. (This will trigger the database upgrade script.)

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.

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.

Usage

Go into a Moodle course as a teacher.

An an "Assignment" activity to the course.

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.

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.

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.

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).

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.

Sets

Potential privacy issues

Mahara pages and collections submitted by the student will be visible to the teacher (or any Moodle user who can view the gradebook and grade students), 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.

Comments

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?

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. https://catalyst.net.nz/contact-us

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.

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.

I have installed this plugin Release 1.2.1-mdl2.7+ in my 3.1.1 Moodle dev, and I have 16.10 Mahara dev. The SSO from Moodle to Mahara is working fine.

The student can add the Mahara portfolio (page) in the Moodle assignment submission window w/o any trouble. However, when the teacher clicks on the submitted link via "view submissions" page in Moodle, it brings the teacher back to the Moodle dev login page. The same thing happens if the student clicks on "click here" link within the sentence "Select one of your available portfolio pages or collections from the list below, or click here to visit "cuportfolio-dev" and create a new one."

I have examined the hyperlink for "click here", and it points to the same url as the link inside "Network services" block for SSO. But not sure why it doesn't work as the SSO link.

We have just installed the assignment plugin (build 2017101600) on our 3.1.5 Moodle and while we had successfully set up SSO beforehand however now when students attempt to submit anything to Mahara via an assignment they see a message saying "You have no available Mahara pages or collections. Please click here to visit "Home - Mahara" and create a new one."

Hermann, what makes this specific user different than the others? Does that user have any portfolios in their account that have already been submitted? Is there anything in the error log (Moodle / Mahara) when that the account tries to retrieve the portfolios?

Hello,
It looks like we have the exact same issue as Hermann & Nick were having, but I can't find any solution anyhwere.
We've been trying to fix it for a few days but with no luck. Basically it seems that if a student has created more than 5 mahara pages the link doesn't work and on moodle this message comes up "You have no available Mahara pages or collections. Please click here to visit "Home - Mahara" and create a new one." Less than 5 pages it seems to work ok and the list displays. We updated to moodle 3.4.3 this summer and these are the first submissions since. Our mahara version is 18.04.02 and the assignsubmission_mahara plugin version is 1.3 2018053100.
Can anyone post how they fixed the problem?