|
|
| (11 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| {{External tool}} | | {{LTI External tools}} |
| This page explores how to use [[LTI External tools]] in your course as activities or resources. It also covers how to add LTI External tools to your course, and the Site administration settings. | | This page explores how to use [[LTI External tools]] in your course as activities. |
| | |
| ==How is it set up?== | | ==How is it set up?== |
| To create an activity using an LTI External tool, go to the Course page and turn on Edit mode. Click either the link ‘Add an activity or resource’ at the bottom of each section, or click anywhere on the course page where you want to add your item. The Activity chooser will show; then, select the tool you want to create an activity with. | | To create an activity using an LTI External tool, go to the Course page and turn on Edit mode. Click either the link ‘Add an activity or resource’ at the bottom of each section, or click anywhere on the course page where you want to add your item. The Activity chooser will show; then, select the tool you want to create an activity with. |
|
| |
|
| If the tool you want to use is not in the Activity chooser, you need to toggle the 'Show in activity chooser' option in the table in Course page > More > LTI External tools. This page is also where you can see all LTI External tools available in your course. | | If the tool you want to use is not in the Activity chooser, you need to toggle the 'Show in activity chooser' option in the table in Course page > More > LTI External tools. This page is also where you can see all LTI External tools available in your course. For more information, see [[Managing LTI External tools]]. |
|
| |
|
| Once you select the tool in the Activity chooser, you can continue with activity creation and select the settings you'd like. | | Once you select the tool in the Activity chooser, you can continue with activity creation and select the settings you'd like. |
|
| |
| === General === | | === General === |
|
| |
| ===== Content ===== | | ===== Content ===== |
| If you're using a tool that supports deep linking, you will see a 'Select content' button on top of the activity form. Use this button to select which specific content from the tool you want to use in your activity. | | If you're using a tool that supports deep linking, you will see a 'Select content' button on top of the activity form. Use this button to select which specific content from the tool you want to use in your activity. |
| Line 16: |
Line 15: |
|
| |
|
| If not, give your activity a name and, optionally, a description. | | If not, give your activity a name and, optionally, a description. |
|
| |
| ===== Display activity name when students access the tool ===== | | ===== Display activity name when students access the tool ===== |
| You will only see this setting if your site uses the Classic theme and, in the tool settings, the tool’s content display has been configured as ‘Embed’ or ‘Embed, without blocks’. | | You will only see this setting if your site uses the Classic theme and, in the tool settings, the tool’s content display has been configured as ‘Embed’ or ‘Embed, without blocks’. |
|
| |
|
| This setting determines whether the activity name is displayed on the screen once your students access it. | | This setting determines whether the activity name is displayed on the screen once your students access it. |
|
| |
| ===== Display activity description when students access the tool ===== | | ===== Display activity description when students access the tool ===== |
| You will only see this setting if, in the tool settings, the tool’s content display has been configured as ‘Embed’ or ‘Embed, without blocks’. | | You will only see this setting if, in the tool settings, the tool’s content display has been configured as ‘Embed’ or ‘Embed, without blocks’. |
|
| |
|
| This setting determines whether the activity description is displayed on the screen once your students access it. | | This setting determines whether the activity description is displayed on the screen once your students access it. |
|
| |
| ==== Grade ==== | | ==== Grade ==== |
| Your activity will only have a Grade section if the tool it is using has been given permission to write grades in the gradebook. | | Your activity will only have a Grade section if the tool it is using has been given permission to write grades in the gradebook. |
| Line 33: |
Line 29: |
|
| |
|
| If you see the Grade section, but there is no checkbox ‘Allow tool to add grades in the gradebook’, it means that your site administrator has configured the tool to always write grades in the gradebook. | | If you see the Grade section, but there is no checkbox ‘Allow tool to add grades in the gradebook’, it means that your site administrator has configured the tool to always write grades in the gradebook. |
|
| |
| ==== Other settings ==== | | ==== Other settings ==== |
| Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Restrict access]], [[Activity completion]], [[Tags]] and [[Competencies]]. | | Depending on what is enabled for your site and course, you may also need to explore [[Common module settings]], [[Restrict access]], [[Activity completion]], [[Tags]] and [[Competencies]]. |
|
| |
|
| ==Add an LTI External tool== | | ==Using an LTI External tool as an activity== |
| As a teacher in your course, to view the LTI External tools that are already available, go to Course navigation > More > LTI External tools.
| |
|
| |
|
| If your administrator has given you permission to manage LTI External tools, you can add new tools to your course using the ‘Add tool’ button on this page.
| | When students click the tool link they are automatically signed into the connecting site/tool provider (screenshot 1 below) and can take the quiz immediately. |
|
| |
|
| Tools that you add at course level will appear in your activity chooser by default. You can remove them from the activity chooser by going to Course page > More > LTI External Tools and toggling off the column ‘Show in activity chooser’.
| | When the student has completed the quiz, the tool provider displays their grade (screenshot 2 below) and when the student logs out of the tool provider, the grade is passed back into Moodle (screenshot 3 below). |
| ====Tool settings ====
| |
| In Tool settings, give your tool a name (and, optionally, a description). To fill in the rest of the fields in this section, including the LTI version, follow the instructions from your tool provider. If the tool doesn’t provide information about some of these settings, it’s ok to leave them blank.
| |
| * '''Tool URL''' - This is the URL for connecting to site. If your moodle site uses [https://en.wikipedia.org/wiki/Transport_Layer_Security SSL] (is on [[HTTPS]]) you will only be able to use a tool that also uses [https://en.wikipedia.org/wiki/Transport_Layer_Security SSL]. Make sure the tool URL has [[HTTPS]] before attempting to use it or you may get a blank page.
| |
| * '''LTI version''' - The LTI version of the tool you're adding.
| |
| * '''Consumer key''' -this tells the connecting LTI compliant site that your Moodle is allowed to connect. The "tool provider", i.e. the manger of the connecting LTI compliant site will issue you with this key. If you are merely linking to a tool with no secure access or gradebook sharing then you won't need a consumer key. If you are linking to a course or activity from another Moodle site, then you can add any consumer key.
| |
| * '''Shared secret''' - this is the "password" to connect to the tool - the LTI compliant site.
| |
| *'''Custom parameters''' - most times, you can leave this blank. The tool provider might use this to allow you to display a specific resource.
| |
| *'''Default launch container''' - this is how the external tool will be displayed.
| |
| ** Default - if in doubt; leave as default
| |
| **Embed - the external tool will be embedded in the Moodle course page with blocks and navigation bar
| |
| **Embed without blocks - the external tool will be embedded in the Moodle course page but without blocks
| |
| **New Window - the external tool will open in a new window. (A new window or tab will open with the External tool and the old browser window containing the course page will not change.)
| |
| *'''Content selection URL''' - The Content Selection URL will be used to launch the content selection page from the tool provider. If it is empty, the Tool URL will be used.
| |
|
| |
|
|
| |
| ''The following settings are available by clicking ""Show more":''
| |
| *'''Icon URL''' - you can display a different icon from the default External Tool icon by entering its URL here
| |
| *'''Secure Icon URL''' - enter the URL of a different icon here if your students are accessing Moodle securely via [https://en.wikipedia.org/wiki/Transport_Layer_Security SSL].
| |
| ===Services===
| |
| Choose which of the services you want to use with the tool.
| |
| ===Privacy===
| |
| *'''Share launcher's name with the tool''' - this means that the student's name will be displayed on the connected site [[Media:demoexternaltool.png|as in this example]]
| |
| *'''Share launcher's email with the tool''' - this means that the student's email will be displayed on the connected site [[Media:externaltoolfrontpage.png|as in this example]]
| |
| *'''Accept grades from the tool''' - if this is checked, the connecting site will send back grades to Moodle's gradebook. See [[Using External tool]] for more information on this.
| |
| Once you Save changes, the tool will be added to the list of tools in Course page > More > LTI External tools.
| |
| *
| |
| ==Site administration settings==
| |
| ===Adding a tool site-wide===
| |
| An administrator can manually configure external tools in ''Site administration > Plugins > Activity modules > External tool> Manage tools'' so that they are available across the site.
| |
| [[File:moodle310__external_tool_registration.png|thumb|center|450px|Adding an external tool]]
| |
| A tool may be configured by an administrator so that it is shown in the activity chooser (in addition to the external tool activity) for a teacher to select to add to a course. Its description, if one is present, will appear in the activity chooser.
| |
| === Registering an LTI Advantage tool===
| |
| Moodle allows a simple way to deploy an LTI Advantage tool. If the tool provider supports that flow, you should have received a registration URL. Simply enter that url to a tool in the 'Tool URL' and press 'Add LTI Advantage'.
| |
|
| |
| The tool registration UI will open and guide you to the steps for registration. Once completed, the registration panel will close and the list of tools will refresh. If the registration was successful, the newly added tool should be visible in a pending state.
| |
|
| |
| The pending state allows you to review the tool configuration, the privacy and services granted, apply possible modifications (for example how the tool appears in the activity chooser), then activate the tool to make it available.
| |
|
| |
| In case of errors when trying to start the registration, validate the registration URL with the tool's vendor the registration URL is for an LTI Advantage registration and not for the deprecated LTI 2 registration.
| |
| {| class="wikitable" border="1"
| |
| |-
| |
| |For Tool Developers looking to support the automated registration of LTI Advantage tool, there is an [https://moodlelti.theedtech.dev/dynreg/ implementation guide] available. The registration process is also being standardized by [https://imsglobal.org IMS Global] LTI Working Group. There is also a [https://youtu.be/6tcEwiOs5qU Youtube video] demo-ing and explaining the flow.
| |
| |}
| |
| ===Registering an LTI 1.1 tool using a cartridge===
| |
| You can register an LTI 1.1 tool type using a cartridge. A cartridge will configure all the information such as launch url, tool name & description and icons for you.
| |
|
| |
| To do this, simply enter the url to a tool's cartridge in the 'Tool URL' and press 'Add Legacy LTI'. You will be asked to enter a key and secret. If you don't have them, you can leave them blank and press save changes.
| |
| [[File:LTIKeyAndSecret.png|thumb|center|450px|Entering a consumer key and secret]]
| |
| ===Registering an external LTI 2.0 external tool===
| |
| <big>The LTI 2 specifications have been deprecated by [https://www.imsglobal.org/lti-security-announcement-and-deprecation-schedule IMS Global] and are no more the preferred way to integrate an external tool in Moodle.</big>
| |
|
| |
| To register an LTI 2 external tool, simply enter the url to a tool in the 'Tool URL' and press 'Add Legacy LTI'.
| |
|
| |
| This will open the tool, which may in turn ask you to decide on some settings.
| |
| [[File:LTIConfirmCapabilities.png|thumb|center|450px|Viewing and confirming capabilities]]
| |
| Then you will be shown the capabilities the tool wants to use and you can decide if you want to allow the tool or not.
| |
| ===Viewing more details===
| |
| On the 'Manage tools' page you can also visit 'Manage preconfigured tools' to view the preconfigured tools in a tabular format.
| |
|
| |
| There are tabs to add an external tool, to view those which are pending and to view those which have been rejected:
| |
| {| | | {| |
| |[[File:LTItype.png|thumb|450px|Setting up a new external tool]] | | | [[File:mark3.png|thumb|1.Student logged directly into tool provider]] |
| | | [[File:markscore1.png|thumb|2. Tool provider displays score]] |
| | | [[File:markscore2.png|thumb|3. Score passed to Moodle's gradebook]] |
| |} | | |} |
| You can also visit 'Manage external tool registrations' to view the tool registrations in a tabular format, or to add an external registration with limited capabilities.
| |
|
| |
| To add a tool with limited capabilities.
| |
| 1. Click 'Configure a new external tool registration'
| |
| [[File:LTIreg.png|thumb|450px|center|Registering an external tool]]
| |
| 2. Configure the details on the settings page:
| |
| [[File:LTIregdetails1.png|450px|center|Registration settings page]]
| |
| 'Memberships', allow the external tool to request a list of users with a certain role in a specified context e.g. users enrolled in a course.
| |
|
| |
| 3. Click the tick/checkmark to register:
| |
| [[File:ticktoreg.png|center|thumb|450px|Activating]]
| |
| 4. After obtaining a success message, click to complete the process:
| |
| [[File:reqmet.png|450|thumb|center|Completing the registration]]
| |
| 5. If all requirements are met then you will be able to register automatically.
| |
|
| |
| 6. Now go to ''Site administration > Plugins > Activity modules > External tool > Manage external tool types'' and click the 'Pending tab'
| |
|
| |
|
| 7. Click the tick/checkmark to activate it:
| | [[es:Actividad herramienta externa LTI]] |
| [[File:pendingactivate.png|thumb|center|450px|Activating from the Pending tab]] | | [[de:Aktivität Externes Tool]] |
| ==External tool capabilities==
| |
| *[[Capabilities/mod/lti:addcoursetool|Add course-specific tool configurations]]
| |
| *[[Capabilities/mod/lti:addinstance|Add a new external tool]]
| |
| *[[Capabilities/mod/lti:addmanualinstance|Add a manually-configured tool]]
| |
| *[[Capabilities/mod/lti:addpreconfiguredinstance|Add a preconfigured tool]]
| |
| *[[Capabilities/mod/lti:requesttooladd|Submit a tool to admins for configuration]]
| |
| *[[Capabilities/mod/lti:admin|Be an admin when the tool is launched]]
| |
| *[[Capabilities/mod/lti:manage|Edit external tool activities]] i.e. be an Instructor when the tool is launched
| |
| *[[Capabilities/mod/lti:view|View external tool activities]] i.e. launch external tool activities
| |
| [[https://docs.moodle.org/es/Configuraciones de herramienta externa]]
| |
| [[https://docs.moodle.org/de/Externes Tool konfigurieren]] | |
| [[https://docs.moodle.org/fr/Paramètres d'outil externe]]
| |
This page explores how to use LTI External tools in your course as activities.
How is it set up?
To create an activity using an LTI External tool, go to the Course page and turn on Edit mode. Click either the link ‘Add an activity or resource’ at the bottom of each section, or click anywhere on the course page where you want to add your item. The Activity chooser will show; then, select the tool you want to create an activity with.
If the tool you want to use is not in the Activity chooser, you need to toggle the 'Show in activity chooser' option in the table in Course page > More > LTI External tools. This page is also where you can see all LTI External tools available in your course. For more information, see Managing LTI External tools.
Once you select the tool in the Activity chooser, you can continue with activity creation and select the settings you'd like.
General
Content
If you're using a tool that supports deep linking, you will see a 'Select content' button on top of the activity form. Use this button to select which specific content from the tool you want to use in your activity.
Once you select content, the Activity name and Activity description might be automatically populated by the tool.
If not, give your activity a name and, optionally, a description.
Display activity name when students access the tool
You will only see this setting if your site uses the Classic theme and, in the tool settings, the tool’s content display has been configured as ‘Embed’ or ‘Embed, without blocks’.
This setting determines whether the activity name is displayed on the screen once your students access it.
Display activity description when students access the tool
You will only see this setting if, in the tool settings, the tool’s content display has been configured as ‘Embed’ or ‘Embed, without blocks’.
This setting determines whether the activity description is displayed on the screen once your students access it.
Grade
Your activity will only have a Grade section if the tool it is using has been given permission to write grades in the gradebook.
In activities created using LTI External Tools, the grade will always be given by the tool. You might have the option to completely deactivate grading for your activity if the checkbox ‘Allow tool to add grades in the gradebook’ is displayed.
If you see the Grade section, but there is no checkbox ‘Allow tool to add grades in the gradebook’, it means that your site administrator has configured the tool to always write grades in the gradebook.
Other settings
Depending on what is enabled for your site and course, you may also need to explore Common module settings, Restrict access, Activity completion, Tags and Competencies.
Using an LTI External tool as an activity
When students click the tool link they are automatically signed into the connecting site/tool provider (screenshot 1 below) and can take the quiz immediately.
When the student has completed the quiz, the tool provider displays their grade (screenshot 2 below) and when the student logs out of the tool provider, the grade is passed back into Moodle (screenshot 3 below).
 1.Student logged directly into tool provider |
 2. Tool provider displays score |
 3. Score passed to Moodle's gradebook |
