LTI ContentItem Enhancements
| LTI Content-Item Enhancements | |
|---|---|
| Project state | Planning |
| Tracker issue | MDL-59402 |
| Discussion | Enhancing support for IMS Content-Item message |
| Assignee | Stephen Vickers |
Project goal
The goal of this project is to enhance the existing IMS Content-Item Message implementation in Moodle. IMS Content-Item Message is an extension of the IMS Learning Tool Interoperability (LTI) specification that allows for sharing of content, typically LTI links, between two systems. The enhancements developed as part of this project will provide a more streamlined link creation process and an improved user experience.
Specifically, these enhancements will:
- Allow instructors and course designers to add multiple LTI links at once; eliminating the need to access a content selector each time a link is to be added
- Support a more streamlined workflow where content items can optionally be added automatically without any manual intervention
The work is not intended for now to support other content item type (like static content) although it could be extended in the future to allow for it.
This work is being undertaken with the support of Cengage.
Direct Content Item flow from Activity Chooser
This is the most significant change being proposed: a new flow is added to skip the External Tool page when launching directly from the Activity Chooser (i.e. not using the External Tool option). The goal is to make the external tool feel more integrated and behave more like an Activity Module by diving directly into the tool's User Interface and not showing any Moodle configuration page. It also allows for the creation of multiple items in a single interaction.
The new flow is summarized is in this short screen cast: https://youtu.be/TvqKuJlGATw
We propose that: when a tool proxy is deployed, and the tool proxy supports Content Item Selection Request, the tool is by default selected to be visible in the Activity Chooser (it may be changed after to only be listed in External Tool in the config page of that tool).
Streamlined add flow
When a user selects the tool directly in the activity chooser, the user is sent directly to the Tool Provider using the ContentItemSelectionRequest launch. The parameters in the launch now include:
- auto_create: true indicating the links will be created directly on return - accept_multiple: true indicating it is ok to return more than one Content Item
The actual Tool UI will be in an IFrame, and the return URL would handle the Items, add them directly to the course and create the grade item if the content item defines a line item. Then it would redirect the user to the course page with those links added in (similar to a regular Activity Module flow). An empty content item return would act as a Cancel, no item would be added and the user would be returned to the course page.
Grade Item only if Line Item is present
Right now the creation of a Grade Item for Link is a tool configuration:
- Tool can be configured to Always accept grades, then each link will have its own gradebook item
- Tool can be configured to Never accept grades, then no gradebook column will ever be created for that tool
- Tool can be configured to Defer to instructor, in which, the instructor has a choice on a per link basis to add or not a grade book column
- Tool when configured with a Tool Proxy which treats the capability of Result.autocreate to decide whether the tool is Never Accept or Always Accept
Always creating a gradebook column for each and every link works fine for simpler tools always providing links to the same kind of assets, but it does not work well for heterogeneous resources (for example a link could go to a Reading activity, or a Quiz). The decision to create a Grade Item for a Link should ultimately be a Link level decision, driven by the Content Item definition inclusion or not of a Line Item definition (if Content Item Selection Request is used), even if the tool is configured to always accept grades or is a Tool Proxy deployment. This will be the direction taken by the new flow. The older flow, not mandating the usage of Content Item Selection Request, will keep its current behavior of relying purely on the tool definition.
As a result:
If a tool is configured to never receive grade (either manually or not part of the tool proxy)
- The option for Grade is never displayed in the External Tool page (existing functionality)
- Line Item definitions in Content Items are always ignored (External Tool Page, new Activity Chooser flow)
Otherwise:
When adding using this proposed new flow from from Activity Chooser (autocreate: true)
- A Gradebook Column will be created as part of the autocreate flow IF AND ONLY IF the content item contains a Line Item definition
- If the Content Item does not contain a Line Item, autocreate does not create an associated Grade Item even if the tool has required the capability or is set to ALWAYS
In the External Tool Page, the flow is mostly unchanged:
- If tool is set to always accept:
- Option to receive grades is checked in and not modifiable
- A grade item is always created, regardless the presence or absence of a Line Item in Content Item
- If tool is set to instructor choice:
- Option to receive grades is checked and is modifiable
- The instructor can override that choice
- if Tool Proxy deployment requires grading:
- grade is checked and cannot be unchecked
From the External Tool page, if a line item definition is present in the Content Item payload, it ideally should be used to pre-populate the max points for the Grade (although this value could be changed by the instructor).
Note that there is currently an issue on the handling of Result.autocreate that needs to be addressed on its own as pre-requisite: https://tracker.moodle.org/browse/MDL-59789
New default behavior
The proposed flow will become the new behavior i.e.: if a Tool Supports Content Item Selection Request AND it is launched directly from Activity Chooser, it will go directly to the Tool as highlighted above.
Initially the proposal included an opt-in flow where this behavior would have had to be turned on from the Tool Setting page; rationale was to not impact current deployments. The new option in the tool settings would make it optional to skip the External Tool page when adding an activity from the activity chooser. This option would only be available if the tool supports the Content Item flow; it also requires the tool to be listed in the activity chooser.
Here is an early mockup of how this option could be implemented:
Whether or not to make this an optional behavior is discussed in the forum.
