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.
3. In the tool site, create a course with:
   • One assignment
   • One file resource
4. Enrol a teacher t1 in the course
5. In the platform site, create a course
6. Enrol two teachers: t1 and t2
7. Enrol one student, s1

Register the tool and platform

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 instructions in the docs link above, create the tool-platform registration (dynamic or manual - either is fine).
3. When complete, log out of BOTH the tool site and the platform site
4. On the platform site, log in as the admin and go to Site Administration ► Plugins ► External tool ► Manage tools
5. Edit the settings for the preconfigured tool you just created.
6. Set "Tool configuration usage" to "Show in activity chooser and as a preconfigured tool"
7. Change the name of the tool to "QA test tool"
8. Expand "Privacy" and set "Share launcher's name with tool" to "Delegate to teacher"
9. Again in "Privacy", set "Share launcher's email with tool" to "Delegate to teacher"
10. Save the tool configuration
11. Click "Activate" on the tool card (this is only required if you used dynamic registration!).
12. Log out

Publish a course, activity and resource on the tool site

1. Log in to the tool site as the teacher t1
2. Visit the course
3. Follow Course administration ► Published as LTI tools
4. Make sure you're on the LTI Advantage tab
5. Add a new instance, setting 'Tool to be published' to the course.
6. Add a new instance, setting 'Tool to be published' to the assignment
7. Add a new instance, setting 'Tool to be published' selected to the file resource.
8. Verify you now have 3 published items
9. Log out of the tool site now.

On the platform site

1. Log in as teacher t1 and visit the course.
2. Click to add an activity or resource
3. Select "QA test tool" from the activity chooser
4. On the activity edit view, click "Select content"
5. Verify you're presented with a popup containing a message asking you to first sign in to the tool site in another tab.
6. Follow the instructions, signing in to the tool site as teacher t1 in another tab.
7. In the platform view, close the popup and click "Select content" again
8. Verify you're prompted to link the account you just signed in to the tool with
9. Click to link the account and continue when you see the success message
10. Verify you now see a list of published resources/activities including the 3 items you published earlier
11. Check the "Add to course" box for the course
12. Verify the "Add to gradebook" checkbox is automatically ticked.
13. Click "Add content"
14. Save the activity
15. Repeat the above process to create activities for the remaining two published items (the activity and the resource). The resource won't have an "Add to gradebook" checkbox - that's expected.
16. Now, log out of the platform
17. Log in to the platform as a student.
18. Visit the course and click on each LTI activity.
19. Verify each external tool instance takes you to the corresponding course/activity/resource in the tool.
20. 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)
21. Log in to the tool site as the teacher t1
22. Go to the course
23. Follow Course administration ► Published as LTI tools
24. For the assignment instance, copy the "Launch URL" and "Custom properties" into a text file (we'll need this in a moment)
25. Log out of the tool site
26. Log in to the platform site as the teacher t2 (user t2 will simulate a user having no account in the tool site and thus being unable to use deep linking content selection)
27. Go to the course
28. Enable editing
29. Click to add an activity or resource, selecting "QA test tool" from the activity chooser
30. On the external tool setting page, set the following:
    • Set "Activity name" to "Manually configured assignment link"
    • Set "Tool URL" to the value of the "Launch URL" you just copied to the text file earlier
    • Set "Custom parameters" to the value of the "Custom properties" you just copied to the text file earlier
31. Save the activity
32. Launch the activity "Manually configured assignment link" and confirm you're prompted to either link an existing account or create a new account
33. Use the "Create a new account" option
34. Verify you can now see the assignment