LTI External tool activity: Difference between revisions

From MoodleDocs
Main page ► Managing content ► LTI External tools ► LTI External tool activity
LTI External tools
(rewording)
 
(45 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{External tool}}
{{LTI External tools}}
==Adding a new external tool to a course==
This page explores how to use [[LTI External tools]] in your course as activities.  
[[File:preconfigured tool in activity chooser.png|frame|right|A preconfigured tool 'Chemistry quiz' shown in the activity chooser]]


#With the editing turned on, in the section you wish to add your external tool, click the "Add an activity or resource" link and choose either 'External tool' or a preconfigured tool ''(new in 3.1)''.
==How is it set up?==
#This will take you to the settings page titled "Adding a new external tool". All settings may expanded by clicking the "Expand all" link top right.
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 external tool has not been configured by the administrator, you will need to have in advance the correct URL, consumer key and secret. These should have been provided to you by the managers of the LTI-compliant website you are going to be connecting to. Click "Show more" to access the consumer key and secret fields.


==General settings==
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]].
{|
 
|[[File:externaltool26.png|thumb|400px|General settings before expanding. When expanded, [https://docs.moodle.org/en/File:externaltoolexpanded.png extra options are available.]]]
Once you select the tool in the Activity chooser, you can continue with activity creation and select the settings you'd like.
|}
=== General ===
*'''Activity name''' -  give the title you wish the students to see on the course page
===== Content =====
*'''External tool type''' -this is how Moodle communicates with the tool provider. If in doubt, leave as default. If your administrator has made a tool available sitewide, you will be able to select it here:
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.
{|
 
| [[File:sitewidetool.png|Selecting a preconfigured tool]]
Once you select content, the Activity name and Activity description might be automatically populated by the tool.  
|}


*'''Launch URL''' - This is the URL for connecting to site.  
If not, give your activity a name and, optionally, a description.
*'''Launch container'''- this is how the external tool will be displayed.
===== Display activity name when students access the tool =====
**Default -if in doubt; leave as default
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’.
**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.)


''The following settings are available by clicking ""Show more":''
This setting determines whether the activity name is displayed on the screen once your students access it.
*'''Activity description''' - give a short description here
===== Display activity description when students access the tool =====
*'''Display description on course page''' - choose to show the description along with the activity name
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’.
*'''Display activity name when launched''' - have this appear when the student clicks the link.
*'''Display activity description when launched''' - have this appear when the student clicks the link.
*'''Secure launch URL''' -
*'''Consumer key''' -this tells the connecting LTI compliant site that your Moodle is allowed to connect. The "tool provider", ie 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.
*'''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.
*'''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 SSL.


==Privacy settings==
This setting determines whether the activity description is displayed on the screen once your students access it.
(These settings are collapsed by default)
==== 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.  
|[[File:externaltoolprivacy25.png|Privacy settings expanded]]
|}


*'''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]]
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.
*'''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.


==Site administration settings==
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]].


===Adding a tool site-wide===
==Using an LTI External tool as an activity==


An administrator can manually configure external tools in ''Site administration > Plugins > Activity modules > LTI > Manage external tool types'' so that they are available across the site.  
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.


{{New features}}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.
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).


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]]
|}
|}


===Registering an external tool===
[[es:Actividad herramienta externa LTI]]
 
[[de:Aktivität Externes Tool]]
An external tool can be registered by an admin as follows:
 
1. Go to ''Site administration > Plugins > Activity modules > LTI > Manage external tool registrations''
[[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 > LTI > Manage external tool types'' and click the 'Pending tab'
 
7. Click the tick/checkmark to activate it:
[[File:pendingactivate.png|thumb|center|450px|Activating from the Pending tab]]
 
See the screencast [http://www.spvsoftwareproducts.com/temp/lti2-moodle/ External tool registration] for a demonstration of the above steps.
 
==External tool capabilities==
 
*[[Capabilities/mod/lti:addcoursetool|Add external tool]]
*[[Capabilities/mod/lti:requesttooladd|Submit a tool to admins for configuration]]
*[[Capabilities/mod/lti:grade|Grade external tool activities]]
*[[Capabilities/mod/lti:manage|Edit external tool activities]]
*[[Capabilities/mod/lti:view|View external tool activities]]
*[[Capabilities/mod/lti:addinstance|Add a new external tool activity]]
 
[[es:Configuraciones de herramienta externa]]

Latest revision as of 13:41, 14 December 2023

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
Retrieved from "https://docs.moodle.org/403/en/index.php?title=LTI_External_tool_activity&oldid=147542"
Powered by MediaWiki