This document will describe how users will be able to add Unitu onto Moodle through an LTI integration (Learning Tools Interoperability). More information about LTI can be found here: https://www.imsglobal.org/activity/learning-tools-interoperability
We will be using LTI version 1.
What is it?
Moodle Sandbox is a demo version of Moodle that is available for everyone to use and experiment with. You can test new features and try out new things. However, it is shared by all users simultaneously, therefore other users might be using the platform at the same time as you. To be safe and to reset all changes, Moodle will rest the platform to default settings every hour.
Why are we using it?
We want to provide you with a step-by-step documentation on how to perform an LTI integration with Unitu on Moodle. We believe Moodle Sandbox would enable us to do just that without the overhead of setting up a new account and registering on Moodle.
Difference between my Moodle and Moodle Sandbox?
The difference will vary upon each customer, however, these differences should only be in appearance and not functionality. Therefore, this documentation should apply to all versions of Moodle implemented with any configuration or style.
Benefits of integrating Unitu within Moodle
Increases Unitu’s Visibility
We believe that making Unitu visible on Moodle and especially showing the tool within their modules will greatly increase engagement with the platform. This will also re-assure the students that the university is serious about student feedback as it would seem like the university is encouraging student feedback (which is in fact what we want).
Convenience for the students
Making the platform readily available on Moodle and easily accessible from their course page or home page will, we believe, greatly encourage students to provide feedback relevant to their course. Which will result in more relevant engagement on the Unitu platform.
Moreover, students will not need to log in again which will simplify the whole process of providing feedback – again increasing the engagement with the platform.
Security of the integration
Moodle LTI integrations only allow service providers which have https (secured) connection protocols. That’s great because Unitu uses HTTPS and has a COMODO RSA Domain Validation Secure Server CA authorised certificate. This means that all the data either being sent or received through the site is secure.
We authenticate users only via their email when they access our site via a valid LTI connection. Therefore users will only have to be authenticated on Moodle and so our authentication security is heavily reliant on Moodle’s authentication system.
Video for Integration
Method for Integration
Setting up Unitu as an external tool in Moodle
Navigate to “External tool configuration” input form via:
- Login as a Site admin
- Click on “Site administration”
- Click on “Plugins” to open the tab
- Under “Activity Modules” click “Manage Tools” which is right below “External Tools”
- Click on “configure a tool manually”
Enter the following configurations
Under “Tool Settings”
- Tool Name: “Unitu – The Student Voice Platform”
This is the name that will be assigned to the tool on Moodle and will also be visible to students
- Tool URL:<the url provided by us>
This is the url that will be used to connect to Unitu’s LTI login service
- Tool Description: <User’s choice>
[Suggested: “Unitu, your student voice platform”]
This is a short description that will be visible to students below the tool name
- LTI version: “1.0/1.1”
This is the version of LTI used to integrate with Unitu
- Consumer Key: <provided by us>
- Shared Secret: <Provided by us>
- Custom Parameters: <leave empty>
- Tool Configuration usage: <leave default>
- Default Launch Container: <User’s choice>
[Recommended to use “Embed, without blocks”]
This is how the tool will be displayed for students when the click on the link
- Share Launcher’s email with tool: “Always”
We need the email to be sent to us for us to be able to log in the user onto Unitu
Add the Unitu tool to Modules in Module
- Make sure edit mode is on (in the settings drop-down on the right)
- click “Add an activity or resource”
- Inside External tool click on “Add”
- Input the following:
Activity name: <User’s Choice>
Pre-configured tool: Unitu
- Click “Save”
Add as a HTML block within Moodle
- Go to the Homepage and turn the editing mode on
- In the left menu click on “Add a block” and then select “Html”
- Configure the new Html block:
HTML block title: <User’s Choice>
Body: Add an image, it can be the user’s choice, but we recommend using the banner we provide
Add hyperlink to the image using the student access link:
- Log in as a student
- Right click on the Unitu Tool in the course
- Click “Copy link addresss
- Inside “Where this block appears” for “Page Context”: <User’s Choice>
Recommend: “Display everywhere
- Click “Save”
Common Error Troubleshooting
User not found:
The main reason for this error is that the user has not been registered on Unitu yet. Which means you will need to contact the Unitu Support team and make sure that your account has been created with the same email as the one you are trying to gain access with. This would usually be the email address you used to log in onto Moodle.
Incorrect LTI details:
Please make sure that the LTI configurations that you have inputted are valid and verified.
These are Tool URL, Consumer Key, and Shared Secret
Try re-entering the details, sometimes it is best to remove and re-integrate the Unitu tool using the steps above. If this issue persists, please contact Unitu Support, and someone will be able to help you out.
User is disabled:
The user has been disabled on Unitu, please contact our Unitu Support team to know why and how they can be re-enabled.