LTI Documentation
=================

Please note this is the older Moodle LTI instructions and not part of the newer TSUGI/LTI developments made availavle from XOT v3.6.

Very quick & brief documentation.

adds 4 new tables lti_context, lti_keys, lti_resource & lti_user

The LTI Provider Library is from The University Of Nottingham which extends upon the sample LTI Library from IMS, under an MIT Licence.

Setup
-----


The destination URL is

<XOTurl>/LTI/

replace <XOTurl> with the full url to Xerte Online Toolkit.

You then need to add an LTI key from the management interface from LTI Settings under site menu.  The secret and the key is then entered into the LTI Consumer along with the destination URL.  Context is currently not handled by this as there doesnt seem any logic for it wit XOT.


On launching a link
-------------------

On first login (& every 15 weeks) it will require authenticating with xerte authentication, this then associates the LTI user ID and the xerte username together.

if staff it will show existing projects and let you select one for the link to associate with (once set it cannot be changed/deleted [ you would need to delete the link from the LTI Consumer]).  From then on the project linked is launched 

if student then launches to project, if not setup display quick error message.


Using Moodle
------------

The easiest way to use this is to set up an external tool under the site administrator.  Give the tool a sensible name eg Xerte Online Toolkits.  The base URL should be the url to the toolkits with /LTI/ appended, enter the consumer key & shared key that you will enter into Xerte.  Under the custom Parameters box there is a tick box with just a help icon next to it (which when help is clicked it starts "Show tool type when creating tool instances tick this box as the lti extension provides a specific landing page than then redirects to where its been configured.  On adding a new external tool to a page this allows you to select it from a drop down menu.





