Connecting your LMS
If your organization already runs an LMS — Moodle, Canvas, D2L Brightspace, Blackboard — you can connect it to your Grapevine site through LTI 1.3. Its instructors then add your courses from inside the LMS, each LMS course gets its own copy of the course, its learners are signed in and enrolled on their first click, and their grades go back to the LMS gradebook.
You register the LMS once, on your site. After that the work is the instructors’ — see Adding a course to your LMS.
What you need first
The Grapevine API turned on for your site, in Site Admin → Integrations. LTI works through it, and while the API is off the LMS cannot reach your site. See Turning on the API.
Somebody who administers the LMS, too. Adding a tool is an LMS administrator’s job, not an instructor’s.
Moodle is the LMS this has been tested with so far. Canvas, D2L Brightspace and Blackboard follow the same standard and are expected to work; if you connect one, we would like to hear how it went.
The quick way: a registration link
Most LMSs, Moodle among them, can register Grapevine themselves.
- In Site Admin → Integrations, under LTI platforms, choose Get a registration link.
- Give the link to your LMS administrator, who pastes it where the LMS asks for a tool or registration URL. In Moodle it goes in under Add LTI Advantage.
- The LMS and Grapevine exchange their details, and the LMS appears in your list.
The link works once, and within an hour. If it has been used or has expired, get a new one.
Moodle leaves a newly registered tool pending until its administrator activates it, so if instructors cannot see Grapevine yet, that is the first thing to check.
By hand
For an LMS that cannot use a registration link, the same section lists the details to enter in the LMS: the Tool URL, Initiate login URL, Redirection URI and Public keyset URL. When adding Grapevine as an LTI 1.3 tool, set it to open in a new window and to use Assignment and Grade Services, so each graded lesson gets a gradebook column.
The LMS then gives you details of its own. Choose Register an LMS and fill them in: a Name you will recognize, the Platform ID (issuer), Client ID, Deployment ID, Authentication request URL, Access token URL and Public keyset URL. Then press Register.
How many
A site can register up to 20 LMSs. Each registered LMS is listed with its name and its IDs.
Removing one
Remove beside an LMS disconnects it. Its links stop working at once, and its learners are no longer linked to their LMS accounts. Their Grapevine accounts and their progress stay.
Registering the same LMS again later does not reconnect those learners to the accounts they had. Remove one only when you mean it.
For developers
The API reference has a page on connecting an LMS.