Using eBooks with Runestone Academy: The PreTeXt Interactive Edition

Subsubsection Canvas

1. Follow the Canvas instructions to add an external app:

   :Name: Runestone
   :Consumer key: Enter this from Phase 1.
   :Shared Secret: Enter this from Phase 1.
   :Launch URL: ``https://runestone.academy/runestone/lti``
   :Domain: Leave blank.
   :Privacy: Select Public; otherwise, Runestone won’t work.
   :Custom Fields: Depends on the installation type:
   
       -   For a site-wide installation, or for installing the Runestone external app for use across multiple courses, leave this blank.
       -   If installing for a single course, add ``custom_course_id=xxx``, where ``xxx`` is the Runestone ID of the course (visible in the upper lefthand corner of each page in your Runestone course).
   :Description: Interactive textbooks from Runestone Academy
   

2. Add an assignment in Canvas that uses the Runestone external tool:

   1. At `Runestone Academy`_, create an assignment; be sure you’ve checked the “Visible to Students” box and saved that change.
   2. Still on the assignments page, copy the LTI link.
   3. In Canvas, add an assignment. For the submission type, select “External Tool.” For the External Tool URL, use the LTI link you just copied. You’ll have to manually enter the same due date/time and a similar assignment name; these aren’t copied automatically. You must be sure the Load This Tool In A New Tab checkbox is checked.
   Students can now click on this assignment and work it. **If they don’t click on the assignment, they won’t receive a grade.** When the assignment is due, go to Runestone directly from your Canvas course by using an assignment link. Otherwise, grade reporting won’t work. In the grading tab of the instructor interface, grade the assignment, then click the “Release Grades” button. Doing this will push all grades to Canvas. (If you need to regrade later, you can always click the “Hide Grades” button, and then do “Release Grades” again.)

Subsubsection Moodle

Subsubsection Brightspace D2L

1. To check, while in your class on D2L, you can go to Course Admin - External Learning Tools, then click the Manage Tool Links (Legacy). From there, click the New Link button.
2. If that is successful, then here are the settings. (Otherwise, talk to your LMS Admin to configure this for you)

   Title

   Enter either the Textbook Name or the assignment name on Runestone

   URL

   copy this from the LTI configuration panel for the textbook login https://runestone.academy/runestone/lti or from the individual assignment in the Assignments tab of the Instructor’s Page.

   Description

   Leave blank or add a description.

   Visibility

   Allow users to view the link should be checked.

   Key/Secret

   Signature

   check Sign messages with key/secret with

   select Link key/secret

   then fill in

   Key

   Enter this from Phase 1.

   Secret

   Enter this from Phase 1.

3. Click the Save button before adding custom parameters.

   Custom Parameters

   click the Add custom parameters link.

   Name

   custom_course_id

   Value

   the Runestone ID of the course (visible in the upper lefthand corner of each page in your Runestone course).

   Security Settings

   Select use link security settings

   Make sure at least the following settings are checked:

   • Send tool consumer information to tool provider
   • Send context information to tool provider
   • Send LTI user ID and LTI role list to tool provider
   • Send user name to tool provider
   • Send user email to tool provider
   • Send link title to tool provider
   • Send link description to tool provider

4. Once everything is selected, click Save and Close
5. Now, from anywhere in your course, you can select Existing Activities - External Learning Tools and then the link you created. After adding this link, make sure that you make sure the link is configured to Open as External Resource. That way the right information will be passed to the textbook.
6. Students will be able to click on this link when you make it available to them as long a the Visible to Students checkbox is checked on the assignment in runestone.
7. When the assignment is due, go to Runestone directly from your D2L course by using an assignment link. Otherwise, grade reporting won’t work.
8. In the grading tab of the instructor interface click the Release Grades button. Doing this will push all grades to D2L. (If you need to regrade later, you can always click the “Hide Grades” button, and then do “Release Grades” again.)