Add LTI Content Item support to mod_lti

Setup

1. Download and run ngrok

   ./ngrok http 80 --region=au

External tool configuration

1. Navigate to Site administration ► Plugins ► Activity modules ► External tool ► Manage tools.
2. Enter "http://lti.tools/test/tp.php" into the Tool URL... field.
3. Click Add
4. On the IMS LTI Tool Provider: Tool registration emulator, click Registration.
5. Check out the Enabled capabilities multi-select box.
   • Confirm that it contains "ContentItemSelectionRequest" under the Message types option group.
6. Select all of the options under Enabled capabilities.
7. Select all of the options under Tool services.
8. Click Register tool.
9. On the confirmation page, click Yes to activate the tool.
10. Click on the Edit link (the cog icon) for the Test tool provider entry.
11. Click on Show more...
12. Check out the Content-Item message.
    • Confirm that it is ticked.
    • Confirm that it is disabled.
13. Under Tool configuration usage, select Show in activity chooser and as a preconfigured tool.
14. Click Save changes
15. Click again on the Edit link (the cog icon) for the Test tool provider entry.
16. Click on Show more...
17. Check out the Content-Item message.
    • Confirm that it is still ticked.
    • Confirm that it is still disabled.

Adding an external tool to a course

1. Create a course
2. Login as a teacher enrolled to the course
3. Turn editing on.
4. Click Add an activity or resource. Take note of the section it is being added to.
5. Select Test tool provider then click Add.
6. Enter Test tool under Activity name
7. Open your browser's JavaScript console.
8. Click Select content
9. On the IMS LTI tool provider emulator dialogue, check the Request summary
   • Confirm that it says ContentItemSelectionRequest message request is valid.
10. Click Content-Item.
11. Click Cancel at the bottom of the page.
    • Confirm that the dialogue closes.
    • Confirm that there are no error messages displayed.
    • Confirm that there are no JavaScript console errors after the dialogue has closed.
12. Click again on Select content
13. Click Content-Item.
14. Select Bespoke item
15. Under "Type:", select "LtiLinkItem"
16. Enter a value for Title.
17. Enter a value for Text.
18. Enter a URL for URL.
19. Enter an icon URL for Icon.
20. For LTI custom parameters, enter values like

    a=1

    b=2

21. Select a value for Select return container.
22. Click Return selection
    • Confirm that the dialogue closes.
    • Confirm that there are no JavaScript console errors after the dialogue has closed.
23. Expand all the fields and check the form.
    • Confirm that Activity name is the same as the value entered in Title.
    • Confirm that Activity description is the same as the value entered in Text.
    • If the URL's schema is set to https, confirm that the value should be in Secure launch URL. Otherwise, it should be in Launch/cartridge URL.
    • If the Icon's schema is set to https, confirm that the value should be in Secure icon URL. Otherwise, it should be in Icon URL.
    • Confirm that Custom parameters is the same as the value entered in LTI custom parameters.
    • Confirm that Launch container matches the selected return container. See table below:

      Select return container	Launch container
      No preference	Default
      frame	Embed, without blocks
      iframe	Embed
      window	New window

24. Click Save and return to course.
    • Confirm that Test tool was added into the course under the correct section.

Test on other editors.

1. Repeat the previous test with the user's default editor preference set to TinyMCE.
   • Confirm that Activity description is the same as the value entered in Text.
2. Repeat the previous test with the user's default editor preference set to plain text area.
   • Confirm that Activity description is the same as the value entered in Text.

Automated tests

1. Run Behat tests for @mod_lti tags.
   • Confirm that there are no errors nor failures.
2. Run PHP unit tests for the mod_lti_testsuite.
   • Confirm that there are no errors nor failures.

Backup test

1. Go to a course
2. Add a tool of the type you created
3. Add a bespoke item, but make sure you select ltiLink
4. Add a title and content
5. Back it up
6. Restore it on another site
7. Make sure the content you selected is still displayed (it will be among the huge dump of data, use search to find it if you can't see it.