diff --git a/source/img/LTI13dynregactivate.png b/source/img/LTI13dynregactivate.png new file mode 100644 index 00000000..2882a99f Binary files /dev/null and b/source/img/LTI13dynregactivate.png differ diff --git a/source/img/LTI13dynregshow.png b/source/img/LTI13dynregshow.png new file mode 100644 index 00000000..a93463d1 Binary files /dev/null and b/source/img/LTI13dynregshow.png differ diff --git a/source/img/codiolti13settingsDyReg.png b/source/img/codiolti13settingsDyReg.png new file mode 100644 index 00000000..321bb846 Binary files /dev/null and b/source/img/codiolti13settingsDyReg.png differ diff --git a/source/img/editmodemoodle.png b/source/img/editmodemoodle.png new file mode 100644 index 00000000..75017d94 Binary files /dev/null and b/source/img/editmodemoodle.png differ diff --git a/source/img/moodlepastedynreg.png b/source/img/moodlepastedynreg.png new file mode 100644 index 00000000..8651119e Binary files /dev/null and b/source/img/moodlepastedynreg.png differ diff --git a/source/instructors/admin/integration/intro.rst b/source/instructors/admin/integration/intro.rst index 0b190f80..052af403 100644 --- a/source/instructors/admin/integration/intro.rst +++ b/source/instructors/admin/integration/intro.rst @@ -20,11 +20,13 @@ Integrating with your LMS system (Canvas etc.) lti-keys-and-urls-information lti-course-copy commoncartridge + moodle lti1-3 lti1-3Blackboard lti1-3BS-D2L lti1-3Canvas lti1-3DynReg + 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. diff --git a/source/instructors/admin/integration/lms-systems/moodle.rst b/source/instructors/admin/integration/lms-systems/moodle.rst index b5521992..38ed2bd5 100644 --- a/source/instructors/admin/integration/lms-systems/moodle.rst +++ b/source/instructors/admin/integration/lms-systems/moodle.rst @@ -6,48 +6,10 @@ Moodle ====== -Please be sure to check out the :ref:`Codio 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 `__ explains how to set up external apps in Moodle. - -Setup and Configuration ------------------------- - .. important:: 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. -**Video: Connect Moodle to Codio using the LTI Integration URL** - -.. raw:: html - -
- -Common Cartridge ----------------- - -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 ` for your organization. -Then in the Moodle course you have created: - -- Go to the course settings and **Restore**. -- Select the **.ismcc** to upload it and proceed to restore. -- **Restore into this Course**. -- Proceed through the steps. - - - .. note:: - Restore is required as Moodle currently does not support importing of **.imscc** files. - - - -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. - -Authentication and Account Creation ------------------------------------- - -To add students/teachers see :ref:`Users account creation ` - - - - LTI 1.3 Dynamic Registration @@ -59,99 +21,71 @@ Dynamic Registration simplifies the setup process by automatically sharing confi Adding the Tool in Moodle ~~~~~~~~~~~~~~~~~~~~~~~~~ -.. image:: /img/lti/moodlepastedynreg.png +.. image:: /img/moodlepastedynreg.png :alt: Where you paste your Dynamic Registration URL in Moodle - :align: right :width: 500px - :class: img-responsive - -1. Navigate to the **Manage Tools** section of your Site Administration and select the Plugins tab. -2. Paste the value you copied in the Tool URL field and click **Add LTI Advantage**. -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. -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. -5. The tool will appear at the bottom of the screen, click the Activate button. + +1. Log in to your Codio account and follow the steps on this page to retrieve your :ref:`Dynamic Registration ` URL. +2. In a new tab go to Moodle. +3. Navigate to the **Manage Tools** section of your Site Administration and select the Plugins tab. +4. Paste the Dynamic Registration URL and click **Add LTI Advantage**. +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. +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. +7. The tool will appear at the bottom of the screen, click the Activate button. +.. image:: /img/LTI13dynregactivate.png + :alt: Where you activate the tool + :width: 500px -Activating the Tool You are Creating - - .. image:: /img/lti/LTI13dynregactivate.png - :alt: Where you activate the tool - -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. +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. Using the Tool in Moodle ~~~~~~~~~~~~~~~~~~~~~~~~ -.. image:: /img/lti/LTI13dynregshow.png - :alt: Toggling on show in activity chooser for the Codio tool. - :align: right - :width: 500px - :class: img-responsive - 1. Navigate to your **My Courses** page and select the course you want to use. -2. Turn on **Edit Mode**. +2. Click the **More** tab. 3. From the **More** dropdown select **LTI External Tools**. 4. You will see the Codio tool, toggle **Show in activity chooser** on. -5. Go to your course and click on **Add an activity or resource**. -6. Click on the **All** tab to show all the tools and select Codio. -7. Click **Select Content** and that will bring up your list of Codio courses, select the course and assignment you want to connect. - - - -LTI Version 1.3 ----------------- - -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. - - -For more information, see `Learning Tools Interoperability Core Specification `__ - -The deep linking url is : ``https://apollo.codio.com/lti/resource_selection`` - - -How to Configure lti1.3 Tool in Moodle Manually -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. raw:: html - -
- - - - -Connecting/Mapping Assignments in Moodle -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. image:: /img/LTI13dynregshow.png + :alt: Toggling on show in activity chooser for the Codio tool. + :width: 600px + :class: img-responsive -There are a number of ways you can connect/map assignments. Check out the following videos to see the option that best suits you. +5. Go to your course and toggle **Edit Mode** on in the top-right corner of the screen. -How to Connect Assignment by lti Integration url -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. image:: /img/editmodemoodle.png + :alt: Toggling on edit mode. + :width: 200px -.. raw:: html +6. Navigate to the module where you want to add an activity, then click the plus icon. +7. Click **Add an activity or resource**. +8. Click on the **All** tab to show all the tools and select Codio. +9. Click **Add**. +10. Click **Select Content** to open your Codio courses, then choose the course and assignment you want to connect. -
-How to Connect Assignment by Resource Selection Preview -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Common Cartridge +---------------- -.. raw:: html +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 `. -
+Once the External Tool is set up, you can proceed with importing your :ref:`Common Cartridge ` file by following the instructions provided on that same page. -How to Connect Assignment by Endpoint url -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Then in the Moodle course you have created: -.. raw:: html +1. Go to your course and click the **More** tab. +2. From the **More** dropdown select **Course reuse**. +3. Click **Restore**. +4. Select the **.imscc** to upload it and proceed to restore. +5. Click **Restore**. +6. Proceed through the steps. -
-How to Connect Assignment with Custom Param -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. note:: + Restore is required as Moodle currently does not support importing of **.imscc** files. -.. raw:: html +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. -
-If you require any assistance, please don't hesitate to :ref:`contact us ` diff --git a/source/instructors/admin/integration/lti1-3DynReg.rst b/source/instructors/admin/integration/lti1-3DynReg.rst index a25965c3..d0570d80 100644 --- a/source/instructors/admin/integration/lti1-3DynReg.rst +++ b/source/instructors/admin/integration/lti1-3DynReg.rst @@ -8,7 +8,6 @@ LTI 1.3 Dynamic Registration 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. - - :ref:`Moodle ` - :ref:`Canvas ` - :ref:`Blackboard ` @@ -20,10 +19,9 @@ Access LTI Integration Settings in Codio ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. image:: /img/lti/codiolti13settings.png +.. image:: /img/codiolti13settingsDyReg.png :alt: LTI 1.3 settings in Codio - :align: right - :width: 350px + :width: 450px :class: img-responsive