This is a set of examples built to show off the integration points available within canvas using LTI. This is an example of writing an LTI tool provider that offers a number of additional features, including padding grades back to the LMS and adding a custom button to a Canvas rich editor field.

To run this tool, download the git repository, then open a console prompt in the repo directory.

First, if you don't already have Bundler installed, do that.

$ gem install bundler

You may need to run this command as root depending on your ruby configuration.

Next you'll want to install the necessary gems:

$ bundle install

Now, just start it up:

$ ruby -rubygems lti_example.rb

You will see some output like this:

Sinatra/1.3.1 has taken the stage on 4567 for development with backup from WEBrick

That number is the port that the tool is running on (4567 is the default).

This is a simple example of writing an LTI tool provider that utilizes the outcome service support in Canvas to post a grade back to Canvas when the user finishes using the tool. Rather than presenting a real assessment, this tool will just present the user with an HTML form text field where they can enter their desired score.

The tool is written in Ruby using the Sinatra web framework and the OAuth gem. You'll need to have ruby installed, with rubygems.

Next, you'll need to configure a course in Canvas to point to your now-running LTI tool. The first step is to add the tool to the course settings, external tools tab. The consumer key is "test", the secret is "secret". The URL will likely be "http:https://localhost:4567/assessment/start", though the hostname and port may change if you are not running the tool on the same computer as your web browser.

Here is what your configuration should look like:

Now that the tool is configured, you'll need to set up an Assignment that points to the tool. This step is what lets you define how many points the tool is worth, and links the tool into the course gradebook in Canvas.

On the Assignments tab in the same course, create a new assignment of type "External Tool". Click the "more options" link, and you'll see a dialog asking you which tool to use:

Select your newly-configured tool and save the assignment. Now when you go to the assignment page as a student, the tool will launch, and you can take the external tool assessment! Once you've stepped through the assessment, you can look at the grades tab in Canvas and verify that the grade from the tool was saved into Canvas.

This server also includes support for adding custom buttons to rich editor fields inside of Canvas. External tool configuration is available at "http:https://localhost:4567/config/editor_button", though the hostname and port may be different depending on your config. Create a new external tool that pulls its configuration from this URL.

Once the tool is configured either on a course or account, click "Pages" to get to a wiki page, and then click "Edit this Page". You should see a new icon appear in the rich editor toolbar representing the newly configured tool:

Clicking the button will load the tool URL in a modal dialog. Settings for this dialog including URL, width and height are configured when the external tool is originally created.