Prerequisites Two sites are required for testing this feature and they must be able to communicate with one another. LTI platform (formerly known as consumer) 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. In the tool site, create a course with: One assignment One file resource Enrol a teacher t1 in the course In the platform site, create a course Enrol two teachers: t1 and t2 Enrol one student, s1 Enable the 'Publish as LTI tool' feature in the 'tool' site Log in to the tool site as an administrator. Follow Site administration ► Security ► HTTP security and enable 'Allow frame embedding'. Follow Site administration ► Plugins ► Authentication ► Manage authentication' and enable the 'LTI' authentication plugin. Follow Site administration ► Plugins ► Enrolments ► Manage enrol plugins and enable 'Publish as LTI tool'. Register the tool and platform Log in to the tool site as an admin user Follow Site administration ► Plugins ► Enrolments ► Publish as LTI tool ► Tool registration Click "Register a platform" Enter "Moodle LMS" when prompted for a name and click "Continue" When you see the tool details on the next screen, copy the registration URL to clipboard using the icon next to the URL Now, in a separate browser tab, log in to the platform site as an administrator Follow Site administration ► Plugins ► Activity modules ► External tool ► Manage tools Paste the registration URL into the "Tool URL..." field and press "Add LTI Advantage" When the page reloads and you see the tool card in the list of tools, click to edit the settings of the tool Make sure the following are set: Set "Tool configuration usage" to "Show in activity chooser and as a preconfigured tool" Expand "Privacy" and set "Share launcher's name with tool" to "Delegate to teacher" Again in "Privacy", set "Share launcher's email with tool" to "Delegate to teacher" Set the name of the tool to "QA test tool" and save the tool configuration Click "Activate" on the tool card. Publish a course, activity and resource on the tool site Log in to the tool site as the teacher t1 Visit the course Follow Course administration ► Published as LTI tools (you can access this page using the secondary navigation menu in Boost) Make sure you're on the LTI Advantage tab Add a new instance, setting 'Tool to be published' to the course. Add a new instance, setting 'Tool to be published' to the assignment Add a new instance, setting 'Tool to be published' selected to the file resource. Verify you now have 3 published items Log out of the tool site now. On the platform site Log in as teacher t1 and visit the course. Click to add an activity or resource Select "QA test tool" from the activity chooser On the activity edit view, click "Select content" Verify you're presented with a popup containing a message asking you to first sign in to the tool site in another tab. Follow the instructions, signing in to the tool site as teacher t1 in another tab. In the platform view, close the popup and click "Select content" again Verify you're prompted to link the account you just signed in to the tool with Click to link the account and continue when you see the success message Verify you now see a list of published resources/activities including the 3 items you published earlier Check the "Add to course" box for the course Verify the "Add to gradebook" checkbox is automatically ticked. Click "Add content" Save the activity Now simulate a platform which omits client_id We need to modify the code in the tool site to test this next part. 1. Edit enrol/lti/login.php and change this part: global $_REQUEST; to this: global $_REQUEST; unset($_REQUEST['client_id']); and save the file. 2. Now, go to the platform site and try to launch the activity again. 3. Verify you can launch into the activity Upgrade test 1. Checkout 34ce1463ccc65 and install a site using this weekly hash. On a new, uninstalled clone of integration_master: git checkout 34ce1463ccc65 Then install the site 2. Go to Site admin > Plugins > Enrolments > Manage enrol plugins and enable "Publish as LTI tool" 3. Go to Site admin > Plugins > Auth > Manage auth and enable auth_lti 4. Go to Site admin > Plugins > Enrolments > Publish as LTI tool > Tool registration 5. Create a new platform registration, entering dummy data for the name, clientid, and various URLs. Make sure this is saved and you can see the registration in the table. 6. Click to generate a new dynamic registration URL 7. Now, checkout master git checkout master 8. Run the site upgrade 9. Verify you see no errors 10. Go to Site admin > Plugins > Enrolments > Publish as LTI tool > Tool registration 11. Verify : You see a single 'active' registration (your prior registration, upgraded) You don't see any dynamic registration URL 12. Click 'Edit' on the registration 13. Verify : You see the various name, clientid, url values you entered before 14. Click the "Tool details" tab 15. Verify : You see two sections: Dynamic registration and Manual registration, one below the other You see a 'token' param in the dynamic registration URL You see an 'id' param in the initiate login URL the value of 'token' matches that of 'id' Icon fallback test This just confirms we see the correct icons in tool registration when the fontawesome icon system is disabled. 1. Edit theme/boost/config.php and comment out the following line like so. // $THEME->iconsystem = \core\output\icon_system::FONTAWESOME; 2. Go to Site admin > Plugins > Enrolments > Publish as LTI tool > Tool registration 3. Make sure you're using the boost theme 4. Verify the icons next to the registration look like this: