You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
* **Documentation**
* Reworked Moodle integration guide with reorganized, streamlined setup
and onboarding steps for clarity
* Emphasized LTI 1.3 Dynamic Registration and simplified
activation/usage flows in Moodle
* Removed legacy/out-of-scope subsections and replaced with concise,
focused guidance
* Updated and added visuals (screenshots, captions, alignment/size) and
clarified deep-linking/configuration steps
* Added Brightspace to the list of supported LMS references and updated
navigation pointers in integration docs
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Copy file name to clipboardExpand all lines: source/instructors/admin/integration/intro.rst
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,11 +20,13 @@ Integrating with your LMS system (Canvas etc.)
20
20
lti-keys-and-urls-information
21
21
lti-course-copy
22
22
commoncartridge
23
+
moodle
23
24
lti1-3
24
25
lti1-3Blackboard
25
26
lti1-3BS-D2L
26
27
lti1-3Canvas
27
28
lti1-3DynReg
29
+
28
30
29
31
Learning Tools Interoperability (LTI) is a standard for passing user, organization, and course information between learning management systems (tool consumers) and learning tools and tool providers, such as Codio.
Please be sure to check out the :ref:`Codio LTI App <lti-app>` which allows for an easy way to integrate and to map Codio course assignments to your LMS system. Moodle added support for LTI™ apps in version 2.2. The `following page <https://docs.moodle.org/32/en/External_tool_settings>`__ explains how to set up external apps in Moodle.
10
-
11
-
Setup and Configuration
12
-
------------------------
13
-
14
9
15
10
.. important::
16
11
Codio needs the User Role, Email Address and Name of the Moodle user in order to work. It is important that you access the LTI security settings and ensure that these three fields are enabled. If they are not available, contact Moodle support who can help you enable this. If enabled after you have mapped Codio content to Moodle, you may need to re publish for the changes to be implemented.
17
12
18
-
**Video: Connect Moodle to Codio using the LTI Integration URL**
If using the Common Cartridge file you should first set up an External Tool in Moodle with the :ref:`LTI Key's and URL's <lti-keys-and-urls-information>` for your organization.
28
-
Then in the Moodle course you have created:
29
-
30
-
- Go to the course settings and **Restore**.
31
-
- Select the **.ismcc** to upload it and proceed to restore.
32
-
- **Restore into this Course**.
33
-
- Proceed through the steps.
34
-
35
-
36
-
.. note::
37
-
Restore is required as Moodle currently does not support importing of **.imscc** files.
38
-
39
-
40
-
41
-
To confirm your setup, just click on any assignment available in Moodle. If all configurations are correct, you will be redirected straight to the Teacher view of that assignment in Codio.
42
-
43
-
Authentication and Account Creation
44
-
------------------------------------
45
-
46
-
To add students/teachers see :ref:`Users account creation <lms-users>`
47
-
48
-
49
-
50
-
51
13
52
14
53
15
LTI 1.3 Dynamic Registration
@@ -59,99 +21,71 @@ Dynamic Registration simplifies the setup process by automatically sharing confi
59
21
Adding the Tool in Moodle
60
22
~~~~~~~~~~~~~~~~~~~~~~~~~
61
23
62
-
.. image:: /img/lti/moodlepastedynreg.png
24
+
.. image:: /img/moodlepastedynreg.png
63
25
:alt:Where you paste your Dynamic Registration URL in Moodle
64
-
:align:right
65
26
:width:500px
66
-
:class:img-responsive
67
-
68
-
1. Navigate to the **Manage Tools** section of your Site Administration and select the Plugins tab.
69
-
2. Paste the value you copied in the Tool URL field and click **Add LTI Advantage**.
70
-
3. It will present you with the Codio Organizations you are associated with, likely just one choice, but if there is more than one, select the organization you want to associate this tool with and click continue. It should be the organization that contains the courses you want to connect to the LMS system.
71
-
4. It will ask you to confirm that you want to register Codio as an external tool in the organization you selected. Click **Yes**. You will receive a confirmation from Codio that the action was completed.
72
-
5. The tool will appear at the bottom of the screen, click the Activate button.
27
+
28
+
1. Log in to your Codio account and follow the steps on this page to retrieve your :ref:`Dynamic Registration <lti1-3DynReg>` URL.
29
+
2. In a new tab go to Moodle.
30
+
3. Navigate to the **Manage Tools** section of your Site Administration and select the Plugins tab.
31
+
4. Paste the Dynamic Registration URL and click **Add LTI Advantage**.
32
+
5. It will present you with the Codio Organizations you are associated with, likely just one choice, but if there is more than one, select the organization you want to associate this tool with and click continue. It should be the organization that contains the courses you want to connect to the LMS system.
33
+
6. It will ask you to confirm that you want to register Codio as an external tool in the organization you selected. Click **Yes**. You will receive a confirmation from Codio that the action was completed.
34
+
7. The tool will appear at the bottom of the screen, click the Activate button.
73
35
74
36
37
+
.. image:: /img/LTI13dynregactivate.png
38
+
:alt:Where you activate the tool
39
+
:width:500px
75
40
76
-
Activating the Tool You are Creating
77
-
78
-
.. image:: /img/lti/LTI13dynregactivate.png
79
-
:alt:Where you activate the tool
80
-
81
-
Return to Codio and refresh the **Integrations** page, you will see the integration you created in the bottom section if everything has been set up properly.
41
+
Return to Codio and refresh the **Integrations** page. You will see the integration you created in the bottom section of **LTI 1.3 Configurations** if everything has been set up properly.
82
42
83
43
Using the Tool in Moodle
84
44
~~~~~~~~~~~~~~~~~~~~~~~~
85
45
86
-
.. image:: /img/lti/LTI13dynregshow.png
87
-
:alt:Toggling on show in activity chooser for the Codio tool.
88
-
:align:right
89
-
:width:500px
90
-
:class:img-responsive
91
-
92
46
1. Navigate to your **My Courses** page and select the course you want to use.
93
-
2. Turn on **Edit Mode**.
47
+
2. Click the **More** tab.
94
48
3. From the **More** dropdown select **LTI External Tools**.
95
49
4. You will see the Codio tool, toggle **Show in activity chooser** on.
96
-
5. Go to your course and click on **Add an activity or resource**.
97
-
6. Click on the **All** tab to show all the tools and select Codio.
98
-
7. Click **Select Content** and that will bring up your list of Codio courses, select the course and assignment you want to connect.
99
-
100
-
101
-
102
-
LTI Version 1.3
103
-
----------------
104
-
105
-
LTI version 1.3 improves upon version [LTI-1.1] by moving away from the use of OAuth 1.0a-style signing for authentication and towards a new security model, using OpenID Connect, signed JWTs, and OAuth2.0 workflows for authentication.
106
-
107
-
108
-
For more information, see `Learning Tools Interoperability Core Specification <https://www.imsglobal.org/spec/lti/v1p3/>`__
109
-
110
-
The deep linking url is : ``https://apollo.codio.com/lti/resource_selection``
If you are using a Common Cartridge file, you’ll first need to configure an External Tool in Moodle using your organization’s :ref:`LTI Keys and URLs <lti-keys-and-urls-information>`.
Once the External Tool is set up, you can proceed with importing your :ref:`Common Cartridge <common-cartridge>` file by following the instructions provided on that same page.
142
75
143
-
How to Connect Assignment by Endpoint url
144
-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
76
+
Then in the Moodle course you have created:
145
77
146
-
.. raw:: html
78
+
1. Go to your course and click the **More** tab.
79
+
2. From the **More** dropdown select **Course reuse**.
80
+
3. Click **Restore**.
81
+
4. Select the **.imscc** to upload it and proceed to restore.
Restore is required as Moodle currently does not support importing of **.imscc** files.
152
88
153
-
.. raw:: html
89
+
To confirm your setup, click on any assignment available in Moodle. If all configurations are correct, you will be redirected straight to the Teacher view of that assignment in Codio.
Copy file name to clipboardExpand all lines: source/instructors/admin/integration/lti1-3DynReg.rst
+2-4Lines changed: 2 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,6 @@ LTI 1.3 Dynamic Registration
8
8
9
9
10
10
Dynamic Registration simplifies the setup process by automatically sharing configuration information between Tools and LMS systems. For LMS platforms that are compatible with this standard, you can enable it by following these steps. Please refer to the appropriate LMS page for detailed platform-specific steps.
11
-
12
11
- :ref:`Moodle <moodle>`
13
12
- :ref:`Canvas <lti1-3Canvas>`
14
13
- :ref:`Blackboard <lti1-3Blackboard>`
@@ -20,10 +19,9 @@ Access LTI Integration Settings in Codio
0 commit comments