Docs

The relevant documentation for this feature can be found at Publish as LTI tool

Prerequisites

Two sites are required for testing this feature and they must be able to communicate with one another.

1. LTI platform (formerly known as consumer)
2. LTI tool (formerly known as provider).

Important: If you're testing locally, you'll need to disable the 'Blocked hosts' setting in BOTH sites. You can find it in Site administration ► Security ► HTTP security. You'll need to clear the values and save.

Registration and publication

1. Following the docs linked above, specifically the section on Enabling the 'Publish as LTI tool' feature, enable the relevant plugins in the tool site.
2. Following the docs linked above, specifically the section on Dynamic registration, create the tool-platform registration
3. In the platform site, edit the preconfigured tool settings for the tool you just created
4. Set "Tool configuration usage" to "Show in activity chooser and as a preconfigured tool"
5. Change the name of the tool to "QA test tool"
6. Save the tool configuration
7. In the tool site, create a course with a single assignment and enrol a teacher t1
8. Log in to the tool site as a teacher t1
   Following the docs linked above, specifically the section on Sharing access to a course or activity, publish an assignment over LTI Advantage. When publishing, use the form defaults.
9. Log out of BOTH the tool and platform sites

Account provisioning modes

1. Log in to the platform as the admin user
2. Create a new course
3. Enrol two teachers: t1 and t2
4. Enrol two students: s1 and s2
5. Log out
6. Log in to the platform site as the teacher t1
7. Go to the course and turn editing on
8. Click to add an activity or resource
9. Select "QA test tool"
10. Click "Select content"
11. When prompted, sign in to the tool site in another tab in the same browser session, and then repeat the "Select content" process (i.e. close the modal and launch it again)
12. Now, when you see your teacher account in the modal, click to link the account
13. When presented with the published resources list, select the "Add to course" checkbox for the assignment you published in the tool earlier.
14. Click "Add content"
15. Save the activity and return to the course home
16. Launch the activity you just created
17. Verify you're taken directly into the assignment
18. Now log out of BOTH the tool and platform sites (note:you may need to visit TOOLSITE/login/index.php on the tool site to trigger a logout if running in embedded mode, since the site will be shown without navigation)
19. Log in to the platform as teacher t2
20. Go to the course
21. Launch the assignment activity
22. Verify you're presented with 2 options: Create a new account, or Link an existing account
23. Log out of the platform
24. Log in to the platform as the student s1
25. Go to the course
26. Launch the assignment activity
27. Verify you're taken directly to the assignment without being prompted about account creation or linking
28. Log out
29. Log in to the tool site as the teacher t1
30. Go to the course where the activity has been published
31. Go to "Published as LTI tool" via the course navigation
32. Edit the settings of the published assignment enrolment instance
33. Change "Teacher first launch provisioning mode" to "Existing accounts only (prompt)"
34. Change "Student first launch provisioning mode" to "Existing and new accounts (prompt)"
35. Click "Save changes"
36. Log out of the tool site
37. Log in to the platform site as teacher t2
38. Go to the course
39. Launch the assignment activity
40. Verify you now see only 1 option: Link an existing account
41. Log out
42. Log in to the platform site as the student s2
43. Go to the course
44. Launch the assignment activity
45. Verify you're presented with 2 options: Create a new account, or Link an existing account