NOTE: This test requires admin access. If you would like to use the QA testing site for running the test, please see the QA testing guide for details of how to request admin access. Begin just after the hourly reset to give yourself plenty of time to complete the test!

If not testing on QA: LTI Advantage requires your site to be reachable from the internet. If not, Install ngrok to expose your moodle setup externally. Refer here for additional guidelines

Create LTI tool

1. As admin got to Site administration > Plugins > Activity modules > External tool > Manage tools
2. Enter https://saltire.lti.app/tool in the Tool URL input and click "Add LTI Advantage"
3. When Saltire loads in the frame, click the "Sign in" link there and continue to sign in using Google SSO.
4. Leave the "Allow anyone to use this registration" option unchecked
5. Click continue
6. When you see the registration is successful, you can click "Close"
7. Click "Activate" to activate the tool
8. Click on its edit button
9. Change the Tool configuration usage dropdown to "Show in activity chooser and as a preconfigured tool"
10. Under "Privacy" make sure "Accept grades from the tool" is set to "As specified in Deep Linking definition or delegate to teacher"
11. Click "Save changes"

Create an instance of the tool in a course

1. Still as the admin, go to a course
2. Click to add an activity or resource
3. Select "Saltire" from the activity chooser
4. Click the select content button to launch into the Deep linking picker
5. Click "Sample content" in the header. You'll see a page with a single item checked.
6. Uncheck the checked item. I.e. uncheck "LTI launch - a link to launch this tool"
7. Check the item "LTI launch 2 - a link to launch this tool with an associated gradebook column"
8. Scroll to the bottom of that view and click "Return selection"
9. Back on the activity add/edit form, confirm that the grade section of the form shows "Point" and that max grade is set to 50.
10. Click "Save and return to course"

Launch as a student and confirm grade passback is working

1. Log in as a student and launch the tool instance in the course
2. Once it loads, select "Service > OAuth 2 Access token" from the tool header
3. Select all scopes and click "Request new token"
   • Ignore any message which says "The platform did not offer the following requested scopes".
   • If asked to view the service request, just click "No".
4. Now, again in the header, select "Service > Assignment and grade"
5. Expand "Score publish service"
6. Set points to 0.7 (meaning 70%)
7. Click "Create/Update"
8. When asked to view the service request, click "Yes"
9. Confirm that you see scoreGiven is something like 0.7 (might be 0.6999999 or something very close)
10. Close that modal.
11. Now, go back to the Moodle course and go to Grades
12. Verify you see the grade 70% for that activity and that it's reporting a score of 35/50 (=70%) too