Skip to content

Commit 87e38d3

Browse files
bnmnetpbnmnetp
committed
add detail to custom parameters
1 parent 1b5ece8 commit 87e38d3

File tree

1 file changed

+45
-39
lines changed

1 file changed

+45
-39
lines changed

‎pretext/Registration/lti.ptx‎

Lines changed: 45 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,19 @@
1111
<p>
1212
Generate a shared/secret key pair for use with Canvas:
1313

14-
<ol>
15-
<li> Browse to the
16-
<url href="https://runestone.academy" visual="Runestone Academy" /> and log in, then select your course (you must be the Instructor).
17-
</li>
18-
<li> <p>Browse to the
19-
<url href="https://runestone.academy/runestone/admin/admin" visual="Instructor's Page" />, then click on “LTI Integration” in the Admin tab.</p>
20-
<image source="Figures/lti_config.png" description="LTI configuration panel" />
21-
</li>
22-
<li> Click on the “Create LTI Key and Secret” button. Click the “Show Secret” button. You will use these in the next phase.</li>
23-
</ol>
14+
<ol>
15+
<li> Browse to the
16+
<url href="https://runestone.academy" visual="Runestone Academy" />
17+
and log in, then select your course (you must be the Instructor).
18+
</li>
19+
<li>
20+
<p>Browse to the
21+
<url href="https://runestone.academy/runestone/admin/admin" visual="Instructor's Page" />
22+
, then click on “LTI Integration” in the Admin tab.</p>
23+
<image source="Figures/lti_config.png" description="LTI configuration panel" />
24+
</li>
25+
<li> Click on the “Create LTI Key and Secret” button. Click the “Show Secret” button. You will use these in the next phase.</li>
26+
</ol>
2427
</p>
2528
</subsection>
2629

@@ -36,7 +39,8 @@
3639
<title>Canvas</title>
3740
<ol>
3841
<li> Follow the
39-
<url href="https://community.canvaslms.com/t5/Instructor-Guide/How-do-I-configure-a-manual-entry-external-app-for-a-course/ta-p/1137" visual="Canvas instructions" /> to add an external app:
42+
<url href="https://community.canvaslms.com/t5/Instructor-Guide/How-do-I-configure-a-manual-entry-external-app-for-a-course/ta-p/1137" visual="Canvas instructions" />
43+
to add an external app:
4044

4145
<pre>
4246
:Name: Runestone
@@ -50,45 +54,47 @@
5054
- For a site-wide installation, or for installing the Runestone external app for use across multiple courses, leave this blank.
5155
- 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).
5256
:Description: Interactive textbooks from Runestone Academy
53-
</pre>
57+
</pre>
5458
</li>
55-
<li> <p>Add an assignment in Canvas that uses the Runestone external tool:
56-
<ol>
57-
<li> At `Runestone Academy`_, create an assignment; be sure you’ve checked the “Visible to Students” box and saved that change.</li>
58-
<li> Still on the assignments page, copy the LTI link.</li>
59-
<li> 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.</li>
60-
</ol></p>
61-
<li> Students can now click on this assignment and work it. **If they don’t click on the assignment, they won’t receive a grade.**</li>
62-
<li> When the assignment is due, go to Runestone directly from your Canvas course by using an assignment link. Otherwise, grade reporting won’t work.</li>
63-
<li> 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.</li>
59+
<li>
60+
<p>Add an assignment in Canvas that uses the Runestone external tool:
61+
<ol>
62+
<li> At `Runestone Academy`_, create an assignment; be sure you’ve checked the “Visible to Students” box and saved that change.</li>
63+
<li> Still on the assignments page, copy the LTI link.</li>
64+
<li> 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.</li>
65+
</ol>
66+
</p>
67+
<li> Students can now click on this assignment and work it. **If they don’t click on the assignment, they won’t receive a grade.**</li>
68+
<li> When the assignment is due, go to Runestone directly from your Canvas course by using an assignment link. Otherwise, grade reporting won’t work.</li>
69+
<li> 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.</li>
6470
</li>
6571
</ol>
6672
</subsubsection>
6773

6874
<subsubsection>
6975
<title>Moodle</title>
7076
<p>
71-
<ol>
72-
<li> The following instructions are for Moodle, but should work for any LMS with LTI Support. Please note that certain items may have naming variations (ie. Moodle External Tool / Canvas External App).</li>
77+
<ol>
78+
<li> The following instructions are for Moodle, but should work for any LMS with LTI Support. Please note that certain items may have naming variations (ie. Moodle External Tool / Canvas External App).</li>
7379

74-
<li>
75-
<p>In Moodle, create a new external tool called "LTI Login Link".</p>
76-
<pre>
80+
<li>
81+
<p>In Moodle, create a new external tool called "LTI Login Link".</p>
82+
<pre>
7783
:Name: Login to Runestone
7884
:Tool URL: https://yourHost.blahblah.edu/runestone/lti
7985
:Consumer key: Enter the key you copied for `consumer` from Phase 1
8086
:Shared secret: Enter the key you copied for `secret` from Phase 1
8187
:Icon URL: https://yourHost.blahblah.edu/runestone/static/images/logo_small.png
8288
:Share Email: True
8389
:Share Name: True
84-
:Custom params:
85-
</pre>
86-
</li>
87-
<li> Login to your Runestone instance with the tool just created, and create your class as well as your assignments.</li>
90+
:Custom params: 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).
91+
</pre>
92+
</li>
93+
<li> Login to your Runestone instance with the tool just created, and create your class as well as your assignments.</li>
8894

89-
<li>
90-
<p> In Moodle, create a new enrollment external app directly to your course and assignment. You will need to repeat this for each assignment. You will also need the database values for your course ID, and assignment ID. Get these from step 2.2. Please note that in order to receive roles and grades, "Accept Grades" must be checked in Moodle. In other LMS's this may be referenced by a "Share IMS Names and Roles" or similar.</p>
91-
<pre>
95+
<li>
96+
<p> In Moodle, create a new enrollment external app directly to your course and assignment. You will need to repeat this for each assignment. You will also need the database values for your course ID, and assignment ID. Get these from step 2.2. Please note that in order to receive roles and grades, "Accept Grades" must be checked in Moodle. In other LMS's this may be referenced by a "Share IMS Names and Roles" or similar.</p>
97+
<pre>
9298
:Name: Assignment 1
9399
:Tool URL: https://runestone.colorado.edu/runestone/lti?assignment_id=&amp;custom_course_id
94100
:Consumer key: Enter the key you copied for `consumer` from Phase 1
@@ -98,14 +104,14 @@
98104
:Share Name: True
99105
:Custom params:
100106
:Accept Grades: True
101-
</pre>
102-
</li>
103-
<li> Copy the tool as many times as you need within your Moodle Course, updating the Name and Tool URL each time.</li>
107+
</pre>
108+
</li>
109+
<li> Copy the tool as many times as you need within your Moodle Course, updating the Name and Tool URL each time.</li>
104110

105-
<li> Students can now click on these external tool assignments to be enrolled/logged directly into your Runestone course and assignment. The grades should appear in Moodle once they are released in Runestone through the Instructor interface.</li>
111+
<li> Students can now click on these external tool assignments to be enrolled/logged directly into your Runestone course and assignment. The grades should appear in Moodle once they are released in Runestone through the Instructor interface.</li>
106112

107-
<li> The course instructor must also be an LTI sourced user, so use the "LTI Login Link" URL. This can be hidden for users.</li>
108-
</ol>
113+
<li> The course instructor must also be an LTI sourced user, so use the "LTI Login Link" URL. This can be hidden for users.</li>
114+
</ol>
109115
</p>
110116
</subsubsection>
111117
</subsection>

0 commit comments

Comments
 (0)