13.6. Setup in Canvas

You can set up the LTI connection to Mahara either for all your courses in Canvas or for a single course.

The advantage of setting up the connection for your entire instance of Canvas is that your teachers do not have to set up the connection themselves and everybody connects to the same instance of Mahara and to the same institution.

If you want to ive more control to what institution in Mahara your learners shall connect, you can set up the LTI connection on the course level.

You can choose to set up the connection via the Edu App Center or via manual configuration. The manual configuration allows you to open Mahara in its own window rather than within Canvas.

13.6.1. Setup via the Edu App Center

When you set up Mahara via the Edu App Center, your Mahara instance is opened as iframe within Canvas reducing the space you have available to view Mahara. You will always see the Canvas navigation around it as well.

Warning

For security reasons, Mahara prevents being embedded as iframe in another website. If you want to use the Edu App Center and not set up Mahara manually (just slightly longer setup time), you will need to disable a security feature on Mahara, which is not recommended. You can do so by adding $cfg->sameoriginframes = false; to your config.php.

See also

If you want to have Mahara opened in a separate window, you can follow the setup instructions for that.

Choose Mahara from the Edu App Center

  1. Click Settings in your Canvas site or course.

    Note

    If you choose to put the link in your site, all courses will have the link in their navigation. If you decide to put the link only into your course, only your course participants will be able to access Mahara.

  2. Click the Apps tab. You have access to the Edu App Center.

  3. Search for ‘mahara’ in the search field.

  4. Click the Mahara app that is presented to you. You are taken to a screen that shows you more information about the app itself.

  5. Click the Add App button to start the configuration.

In order to add the connection to Mahara, you need to have set up Canvas as external tool in Mahara for your institution because you require the consumer key and consumer secret.

Configure Mahara via the Edu App Center

  1. Name: You can decide what you want to call the app. The name you choose here will be the one displayed in your course navigation.

  2. Consumer Key: Paste the consumer key from Mahara for the LTI connection that you set up earlier.

  3. Shared Secret: Paste the consumer secret from Mahara for the LTI connection that you set up earlier.

  4. Launch URL: Paste the URL of your Mahara instance.

  5. Click the Add App button to finish the setup.

  6. Click the Close button or the Close icon to abort the setup.

  7. The app appears in your course navigation when you refresh the page.

  8. Click the app to be authenticated in your Mahara instance.

    Note

    If you already have an account in the institution in Mahara with the email address you use in Canvas, you are taken to that account.

    If your email address does not yet exist in Mahara and you allowed for automatic account creation, an account will be set up for you.

    If your email address exists in Mahara but you are not a member of the institution for which you set up the Canvas integration, you receive an error message and will need to become a member of that institution before you can log in via Canvas.

13.6.2. Manual setup

You may prefer the manual setup of the connection to Mahara at times.

Choose to set up Mahara manually

  1. Click Settings in your Canvas site or course.

    Note

    If you choose to put the link in your site, all courses will have the link in their navigation. If you decide to put the link only into your course, only your course participants will be able to access Mahara.

  2. Click the Apps tab.

  3. Click the View App Configurations button.

  4. Click the App button to add your Mahara app manually.

You add the details for your Mahara instance in the pop-up window.

Configure the connection to Mahara

  1. Configuration Type: Select ‘By URL’. The configuration parameters are available in your Mahara instance.

  2. Name: You can decide what you want to call the app. The name you choose here will be the one displayed in your course navigation.

  3. Consumer Key: Paste the consumer key from Mahara for the LTI connection that you set up earlier.

  4. Shared Secret: Paste the consumer secret from Mahara for the LTI connection that you set up earlier.

  5. Config URL: Paste the URL of your Mahara instance and add the following to the end of it: /module/lti/configxml.php

  6. Click the Submit button to finish the setup.

  7. Click the Cancel button or the Close icon to abort the setup.

  8. You are taken to the ‘External Apps’ page.

You will need to add a custom parameter in order to use the assignment submission functionality.

Make changes to the LTI setup

  1. Next to the app that you just created, click the Configure button.

  2. Select the Edit option.

Now you can enter the additional parameter without which the connection cannot be established properly.

Edit the LTI configuration in Canvas

  1. Name: The name of your external application.

  2. Consumer Key: Review or change the consumer key here that you have from your Mahara instance.

  3. Shared Secret: That is the ‘Consumer secret’ on Mahara. If it has changed, update it here.

  4. Launch URL: The launch URL is the domain of your Mahara instance with /webservice/rest/server.php at the end of it.

    Note

    This URL is different from the one that you entered when setting up the connection. That is correct. When you set up the connection, you need to use /module/lti/configxml.php for Canvas to complete the setup properly.

  5. Domain: Do not enter anything here.

  6. Privacy: Leave this set to ‘Public’.

  7. Custom Fields: Add wsfunction=module_lti_launch here so that the assignment submission process works.

  8. Description: You can leave the default text here.

  9. Click the Submit button to finish the setup.

  10. Click the Cancel button or the Close icon to abort the setup.

  11. You are taken to the ‘External Apps’ page.

  12. The app appears in your course navigation when you refresh the page.

  13. Click the app to be authenticated in your Mahara instance.

    Note

    If you already have an account in the institution in Mahara with the email address you use in Canvas, you are taken to that account.

    If your email address does not yet exist in Mahara and you allowed for automatic account creation, an account will be set up for you.

    If your email address exists in Mahara but you are not a member of the institution for which you set up the Canvas integration, you receive an error message and will need to become a member of that institution before you can log in via Canvas.

13.6.3. Set up an assignment in Canvas

Prerequisite: You have set up the connection to Mahara already via the setup instructions.

In Canvas you can set up the LTI assignment submission as part of the assignment functionality.

Add an assignment to your Canvas course

  1. In your course navigation, click the Assignments navigation item.

  2. On the resulting page, click the Assignment button to set up a new assignment.

Note

You can add the assignment to a group of assignments as you wish.

Assignment settings for your LTI activity

  1. Once you created an assignment, you can change its parameters, including the assignment name.

  2. Provide a description or task for the assignment.

  3. Points: Enter ‘100’ here as LTI expects a scale from 0 to 100.

  4. Display Grade as: Decide how you want to display the final grade for the assignment.

  5. Submission type: Select ‘External Tool’ from the drop-down menu.

  6. Click the Find button to see all external tools that are available in your course and select the Mahara one. Click the Save button to confirm your selection.

  7. Load This Tool In A New Tab: Tick this checkbox if you want to load Mahara in a new tab. Note that there is no navigation visible on the Mahara submission screens because they are meant to be embedded in the assignment activity.

  8. Click the Save button if you want to save an preview your assignment or click the Save & Publish button if you are ready to take the assignment live. Click the Cancel button to abort setting up the activity.

  9. Click the activity name or button to finalize the assessment settings. Learners are not able to use the activity until these settings have been saved.