Test requirements:

• A publicly accessible site (since LTI calls back to the Moodle site admin access) (or a site running with ngrok)
• Admin access

This test makes use of Saltire.

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!

Test steps:

As admin

1. Go to "Site administration > Plugins > Activity modules > External Tool > Manage tools".
2. Add a tool using only the launch URL (old interface) by clicking on 'configure a tool manually.'. You can use https://saltire.lti.app/tool for this manually configured tool.
3. Add a tool using an XML cartridge (e.g. from eduappcenter.com - you need to visit this site to get the URL you need, eg. https://www.edu-apps.org/lti_public_resources/config.xml?id=youtube) by pasting the tool URL into the Tool URL field and pressing "Add Legacy LTI"
4. Set up a page on another publicly accessible Moodle instance and publish it as an LTI tool , using the "Legacy LTI (1.1/2.0)" tab, and take note of the "Registration URL")
5. Add a tool using the registration URL from the other Moodle site, by pasting that URL into the "Tool URL..." field and clicking "Add Legacy LTI" Make sure you continue and "Register" the tool. Make sure you activate the tool also.
6. Add an LTI Advantage tool via dynamic registration using the URL "https://robotest.theedtech.dev/register" for the Tool URL field and pressing "Add LTI Advantage". Make sure you get a successful registration message. Press the close button. Confirm the tool displays on the tools list and that you can activate it.
7. Remove a tool using the delete button on the card.
8. Enter a URL that does not exist, make sure you see a browser-specific error (something along the lines of a domain not found or a 404 if it's just an invalid resource on a valid domain) within the tool iframe. Make sure to click 'Cancel' once the error gets thrown
9. Enter a URL to an XML file that is not a cartridge, and click "Add legacy LTI". Make sure you get an error (an example file which can be used: http://www.w3schools.com/xml/note.xml )
10. Edit a tool that was made via a cartridge URL using the cog button on the card (e.g. the youtube tool we created using the cartridge from eduapps center above)
11. Edit a tool that was made via the LTI 2 registration URL using the cog button on the card (e.g the tool created by using the registration URL on the other Moodle site).
12. Add another tool using only the launch URL (old interface) by clicking on 'configure a tool manually.' Use the following information:
    • Tool name: 1.1 upgrade test
    • Tool URL: https://robotest.theedtech.dev
    • LTI version: 1.0/1.1
    • Shared secret: robohasnosecret
    • Consumer Key: testme
13. Again, try to add an LTI Advantage tool via dynamic registration using the URL "https://robotest.theedtech.dev/register" for the Tool URL field and pressing "Add LTI Advantage". Verify you're asked to either update the existing tool (1.1 upgrade test) or create a new tool
14. Click to upgrade the existing tool
15. Edit the 1.1 upgrade test tool and verify it's now listed with LTI version 1.3/LTI Advantage
16. Set this tool to show in the activity chooser ('launch container' setting)
17. Save the tool

As a teacher 

1. Create a new external tool in a course ("More" > "LTI External tools", then add tool)
   • Set the Tool URL to a cartridge (e.g. from eduappcenter.com).
   • Save changes
2. Create a new instance of that tool (new activity) in the course by selecting the tool from the activity chooser.
3. Launch that tool instance now, and make sure the tool works, and correct tool is displayed (e.g youtube)
4. Log out as the teacher then log in as the admin and add a manual configuration
   1. Go to "Site administration > Plugins > Activity modules > External tool > Manage preconfigured tools".
   2. Delete https://saltire.lti.app/tool if you've added it already.
   3. Use "configure a tool manually"
   4. Add https://saltire.lti.app/tool
   5. Set the consumer key to 'jisc.ac.uk'
   6. Set the secret to "secret"
   7. Click save
5. Log out as the admin then log back in as the teacher and view the course external tools ("More" > "LTI External tools")
6. Set the Saltire tool you created above to show in the activity chooser
7. Create a new instance of the Saltire tool in the course by selecting the tool from the activity chooser.
8. Ensure the tool works by launching it (verify the launch reports a success (green indicator)
9. As an admin, go back to "Site administration > Plugins > Activity modules > External tool > Manage preconfigured tools".
10. Edit the tool you created
11. Change the secret to something else e.g. "asdf"
12. Go back to the external tool you created in the course
13. Ensure that the tool gives an error
14. Create an instance of the '1.1 upgrade test tool' (i.e. robotest that was updated from 1.1 to 1.3) from the preconfigured tools list in the activity settings, by selecting it from the activity chooser
    • You'll need to select content for this tool, so click "Select content" when configuring the instance
    • Click the first item to return "A single not graded LTI Link (newwin)"
    • Click "Save and return to course"
15. Launch the tool and make sure the tool works. Note: Despite being advertised as 'newwin', this content will launch in an embedded view, because that's how the site tool is configured, and this is no longer delegated to the individual tool instances.