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 lti.tools. To ensure a clear test run please purge all cookies for lti.tools via the browser dev tools.

1. Open browser dev tools (Ctrl + Shift + i)
2. Go to the 'Storage' tab (Firefox) or the 'Application' tab (Chrome)
3. Under cookies, delete all for lti.tools

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.'
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. Add a tool using the configuration URL (LTI2) https://lti.tools/test/tp.php by pasting the tool URL into the Tool URL field and pressing "Add Legacy LTI" Make sure you continue and "Register" the tool. (If the test tool configuration URL does not work, you may try setting up a page on another Moodle instance and publish it as an LTI tool and use the "Registration URL")
5. 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.
6. Remove a tool using the delete button on the card.
7. 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
8. Enter a URL to an XML file that is not a cartridge, make sure you get an error ( http://www.w3schools.com/xml/note.xml )
9. Edit a tool that was made via a cartridge URL using the cog button on the card.
10. Edit a tool that was made via the configuration URL using the cog button on the card.
11. 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
    • Client id: testme
12. 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
13. Click to upgrade the existing tool
14. Edit the 1.1 upgrade test tool and verify it's now listed with LTI version 1.3/LTI Advantage

As a teacher 

1. Add an external tool to a course.
2. Set the Tool URL to a cartridge (e.g. from eduappcenter.com).
3. Ensure you get the green tick and it says a cartridge will be used.
4. Click 'save and return to course'.
5. 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://lti.tools/test/tp.php if you've added it already.
   3. Use "configure a tool manually"
   4. Add https://lti.tools/test/tp.php (or the published tool's "Registration URL")
   5. Set the consumer key to 12345
   6. Set the secret to "secret"
   7. Click save
6. Log out as the admin then log back in as the teacher and add another external tool to a course.
7. Set the Tool URL to the URL to https://lti.tools/test/tp.php (don't select preconfigured tool from the drop down)
8. Ensure you get a green tick
9. Save changes
10. Ensure the tool works
11. As an admin, go back to "Site administration > Plugins > Activity modules > External tool > Manage preconfigured tools".
12. Edit the tool you created
13. Change the secret to something else e.g. "asdf"
14. Go back to the external tool you created in the course
15. Ensure that the tool gives an error
16. Add another external tool to a course
17. Set a URL to any invalid site you didn't add as an admin. Ensure you get a yellow warning saying that no configuration was found.
18. Save changes
19. Add another external tool to a course
20. On the settings page, click the plus to add a tool type.
21. In the External tool configuration page, put a cartridge URL into the "tool URL" text box.
22. Press save changes on the External tool configuration page.
23. Press save and display.
24. Make sure the tool works, and correct tool is displayed.
25. Add another external tool to a course, this time using the '1.1 upgrade test tool' from the preconfigured tools list in the activity settings.
26. Press save and display.
27. Make sure the tool works, and correct tool is displayed.