Parts of this article are intended for Site Administrators at your school.
These are instructions for LTI 1.1. If you wish to use LTI 1.3, please visit the article here.
General LTI - IMS & Sowiso
Sowiso has IMS Learning Tools Interoperability to connect to your Learning Management System (LMS), like Canvas, Brightspace or Moodle. The LTI connection will let you sign in automatically without having to insert a username and password again. Those are synchronised with the LMS.
When setting up Sowiso as an external source in the LMS, you must share with Sowiso the e-mail and name of the users.
What information do I need for the Moodle integration?
In order to connect SOWISO to Moodle you will need:
- URL
The URL is: https://cloud.sowiso.nl/lti
- Consumer key and shared secret
These are unique to your institution, and you can get those by contacting us.
Custom parameters
When creating the Sowiso resource in the LMS, we accept additional
custom parameters that you can pass. To enroll students into a specific class use this custom parameter:
accesscode=class_access_code
You can get the class_access_code in the Teacher menu, under Settings, Access code.
Based on this example, the custom parameter would be: accesscode=hSnGEiyR
Don't want to use custom parameters to add the access code? Use "Automatic access via LTI feature" and read about it here.
Other custom parameters you could use are:
Custom parameter: url=any_url_in_sowiso
This will redirect the resources to the URL provided. For instance, when you want to link to a test with id 3, you could use the URL as url=/content/confirm_test/3
Custom parameter: hidemenu=true
This will hide the top menu in Sowiso platform. Be careful when using this, as teachers and students won't be able to switch between the tabs on the platform.
Setting up the integration between Sowiso and Moodle: Step-by-step
Step 1: Enable editing
SOWISO can be added to multiple places in your Moodle, depending on how you want to use it. You can add it on the New site-Home page, or add it to one of the Topics in your course. Find the page where you would like to add Sowiso and enable editing in the upper right corner.
Step 2: Add an activity or resource
With editing on, new options will appear that will allow you to "Add an activity or resource".
Step 3: Choose "External tool"
In the new window, choose "External tool".
Step 4: Expand all settings
All settings may be expanded by clicking the "Expand all" link top right.
Then, click on "Show more" under General.
This way, you will see all the fields that you will need for the integration.
Step 5: Fill in the required fields
You won't have to fill in all the fields in order to set up the connection between Sowiso and Moodle. These are the required fields:
Activity name: This is what your students will see on the course page. We advise to use: Sowiso.
Preconfigured tool: This is how Moodle communicates with the tool provider. If in doubt, leave it as default. If your administrator has made a tool available site-wide, you will be able to select it here:
Launch Container: This is how the external tool will be displayed. We recommend New Window. The external tool will open in a new window. (A new window or tab will open with the External tool and the old browser window containing the course page will not change.)
Consumer key: The consumer key us given to you by Sowiso.
Shared secret: This is the "password" to connect to the tool - it is also given to you by Sowiso.
Custom parameters: These are optional, but we recommend that you add the custom parameter for the access code that will get your students to the desired class on Sowiso. See the section on "Custom parameters" above.
Tool URL - This is the URL for connecting to site. Use: https://cloud.sowiso.nl/lti
​​Privacy settings: Sowiso needs all these boxes to be checked.
Share launcher's name with the tool - this means that the student's name will be displayed on the connected site.
Share launcher's email with the tool - this means that the student's email will be displayed on the connected site.
Accept grades from the tool - if this is checked, the connecting site will send back grades to Moodle's grade book.
For Site Administrators
Adding a tool site-wide
An administrator can manually configure external tools in Site administration > Plugins > Activity modules > External tool> Manage tools so that they are available across the site.
A tool may be configured by an administrator so that it is shown in the activity chooser (in addition to the external tool activity) for a teacher to select to add to a course. Its description, if one is present, will appear in the activity chooser.
Registering an external tool
To register an external tool, click the link. Alternatively, you can configure a tool manually.
Choose the same settings as described in the section above.
How will the students see it?
When students click on the Sowiso link in Moodle, they will be taken to a new tab to Sowiso. Their Moodle credentials will be used for their Sowiso account as well.
Moodle support
Visit the Moodle website for more information about this LMS.