Skip to main content

This Xblock adds configurability over the original lti_consumer XBlock from edx

Project description

Configurable LTI Consumer XBlock

This XBlock is built on top of edX LTI consumer Xblock to ease its configuration by Instructors.

Here are a few examples of what this module brings to Open edX:

  • Pre-configure LTI services that can be added in one-click from the Advanced component button,
  • Enforced configuration for some LTI Services by targetting a launch url pattern,
  • Enforced default configuration for all LTI Services for better control, security or ergonomy,
  • Platform-level LTI credentials configuration available to all courses. courses.

Installation

This package can be installed with pip:

$ pip install [--process-dependency-links] configurable_lti_consumer-xblock

Note that the --process-dependency-links pip option is only required to install or test this XBlock as a standalone package. If you plan to install it in a base Open edX installation, then you can safely miss this option as the only package dependency should already have been resolved.

Getting started

First things first, if you plan to work on the project itself, you will need to clone this repository:

$ git clone git@github.com:openfun/xblock-configurable-lti-consumer.git

Once the project has been cloned on your machine, you will need to build a custom edx-platform docker image that includes the configurable LTI consumer XBlock and setup a development environment that includes all required services up and running (more on this later):

$ cd xblock-configurable-lti-consumer
$ make bootstrap

If everything went well, you should now be able to access the following services:

with the following credentials:

email: admin@example.com
password: admin

Configuration examples

A typical LTI configuration looks like this:

LTI_XBLOCK_CONFIGURATIONS = [
    {
        "display_name": "Marsha Video",
        "oauth_consumer_key": "InsecureOauthConsumerKey",
        "shared_secret": "InsecureSharedSecret",
        "hidden_fields": [
            "lti_id",
            "description",
            "launch_target",
            "custom_parameters",
            "button_text",
            "modal_height",
            "modal_width",
            "has_score",
            "weight",
            "hide_launch",
            "accept_grades_past_due",
            "ask_to_send_username",
            "ask_to_send_email",
        ],
        "defaults": {
            "custom_parameters": [],
            "ask_to_send_username": True,
            "weight": 0,
            "modal_height": 400,
            "ask_to_send_email": True,
            "accept_grades_past_due": False,
            "button_text": "button",
            "has_score": False,
            "hide_launch": False,
            "launch_target": "iframe",
            "modal_width": 80,
            "launch_url": "https://marsha.education/lti-video/",
            "lti_id": "marsha",
        },
    },
    {
        "pattern": ".*ltiapps\\.net.*",
        "hidden_fields": ["launch_target"],
        "defaults": {"launch_target": "modal"},
    },
    {
        "display_name": "LTI consumer",
        "pattern": ".*",
        "hidden_fields": ["ask_to_send_username", "ask_to_send_email"],
        "defaults": {
            "ask_to_send_email": True,
            "launch_target": "new_window",
            "ask_to_send_username": True,
        },
    },
]

This configuration does several things:

  • it adds a "Marsha Video" link behind the Advanced component button in the Studio to add a video in one click. The video is automatically added to the Marsha instance pointed by the launch url,
  • it forces all LTI consumer XBlocks that are pointing to ltiapps.net to use a modal,
  • it proposes all other LTI consumer XBlocks to open in a new window as a default and forces to ask before sending the user's username and email.

The order of each configuration in this list is important because we will use, for a given XBlock, the first configuration pattern that matches its launch url.

Note that the workbench included in the present repository is running this configuration (see config/settings.yml.dist) on the official France Université Numérique Open edX extended Docker image.

Integration to Open edX Studio

For now, this project requires a small fork of edx/edx-platform if you want to add, for some of your configurations, preconfigured options in the Advanced component button of the Studio.

In our opinion, this small fork is worth applying because:

  • it will save you from installing many XBlocks and helps keep your Open edX installation manageable,
  • it allows you to automatically add a specific link for each LTI service you want to offer to your instructors. They don't need to activate LTI and provide the credentials for each course... they don't need to provide the launch url of the service for each XBlock they add...

For open-release/hawthorn.1, the patch to apply is available here: https://gist.github.com/sampaccoud/f15083325cec4f14a53bfb78fb4b4e42

Developer guide

Once the project has been bootstrapped (see "Getting started" section), to start working on the project, use:

$ make dev

You can stop running services via:

$ make stop

If for any reason, you need to drop databases and start with fresh ones, use the down target:

$ make down

License

This work is released under the AGPL 3.0 License (see LICENSE).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

configurable_lti_consumer_xblock-1.0.0rc3-py2.py3-none-any.whl (24.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page