LTI and DynReg Update (#406)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Added an "Open Student Assignments Directly from LMS" page describing
LMS-passed custom parameters and fallback behavior.

* **Documentation**
* Clarified and corrected LMS integration steps and wording across
platforms (Blackboard, D2L, Schoology, DynReg).
* Added Canvas assignment-mapping methods with videos and walkthroughs;
removed legacy LTI 1.x/dynamic registration content.
* Introduced Mentor role mapping in D2L; updated Getting Started videos
and Added Additional Video Resources; fixed typos/formatting.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Lola Valente <lvalente@codio.com>

Author: LolaValente

source/instructors/admin/integration/intro.rst

@@ -14,6 +14,7 @@ Integrating with your LMS system (Canvas etc.)
    lms-systems/system-specific-directions
    lms-students
    lti-enrol
+   open-student-assignments-lms
    grading
    lti-app
    lti-keys-and-urls-information

source/instructors/admin/integration/lms-systems/blackboard.rst

@@ -6,7 +6,7 @@
 Blackboard LTI 1.x
 ==================
 
-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. The `following page <http://library.blackboard.com/ref/df5b20ed-ce8d-4428-a595-a0091b23dda3/Content/_admin_app_system/admin_app_basic_lti_tool_providers.htm>`_ explains how to set up external apps in Blackboard Learn.
+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. The `following page <https://library.blackboard.com/ref/df5b20ed-ce8d-4428-a595-a0091b23dda3/Content/_admin_app_system/admin_app_basic_lti_tool_providers.htm>`_ explains how to set up external apps in Blackboard Learn.
 
 In Codio:
 
@@ -26,8 +26,8 @@ Enable LTI for Your Course
 Bring up the LTI Integration Information
 ----------------------------------------
 
-6. Click your user name in the bottom left of your dashboard
-7. Choose your Organization 
+6. Click your username in the top-right corner of your dashboard.
+7. Choose your Organization. 
 8. Click the **LTI Integrations** tab to bring up the following settings.
 
   .. image:: /img/lti/LTIintegrationinfo.png
@@ -81,7 +81,7 @@ In Codio
 24.  On the main course screen, make sure the **Edit Assignments** tab is selected.
 25.  Click the **Add Assignment** button and select **Project Based**.
 26.  Select a project that has some autograded assessments. The **My First Project** that you created earlier in the Onboarding Guide has some auto-graded assessments. You can also assign another project but you will need to manually grade the assignment so there are some scores to pass back to the Blackboard gradebook.
-27.  Once the assignment has been added to the course, you should click the icon with 3 blue dots and select **LTI Integration URL**.
+27.  Once the assignment has been added to the course, you should click the three dots to the right of that assignment and select **LTI Integration URL**.
 28.  You should copy the LTI integration url to the clipboard by clicking on the field (it will auto copy).
 
 .. figure:: /img/lti/LMS-Unit-URL.png
@@ -99,12 +99,12 @@ We now return to Blackboard complete the mapping.
 33.  In the **Web Link Information** section ...
 34.  Enter a name for the content
 35.  Paste in the **LTI Integration URL** that you just copied to the clipboard from Codio
-36.  Check the box **Ths is a link to a tool provider**
+36.  Check the box **This is a link to a tool provider**
 37.  Select **Yes** for the field **Enable Evaluation** after which more fields will appear
 38.  Set the points you want to award for this content (Codio will automatically scale the percentage value it uses to the points you specify here)
 39.  Save the content settings.
 
 Authentication and account creation
 -----------------------------------
 
-To add students/teachers see :ref:`Users account creation <lms-users>`
+To add students/teachers, see :ref:`User account creation <lms-users>`.

source/instructors/admin/integration/lms-systems/d2l.rst

@@ -61,7 +61,7 @@ Enable LTI for Your Course
 Bring up the LTI Integration Information
 ****************************************
 
-1. Click your user name in the bottom left of your dashboard.
+1. Click your username in the top-right corner of the dashboard, then select **Organizations**.
 2. Choose your Organization. 
 3. Click the **LTI Integrations** tab to bring up the following settings.
 
@@ -144,3 +144,5 @@ Based on the LMS role, if teachers join Codio via the LMS, the following will ap
 +----------------------+-----------------------------------------------------------------------------------------------------+
 | Mentor               | TEACHER (with :ref:`read only <add-teachers>` access to the course}                                 |
 +----------------------+-----------------------------------------------------------------------------------------------------+
+
+

source/instructors/admin/integration/lms-systems/google-classroom.rst

@@ -64,3 +64,5 @@ Removing
 .. Note:: Removing the integration link will mean students will not be able to access any of their assignments any longer from Google Classroom
 
 .. |Connect to Codio| image:: /img/google_classlist.png
+
+

source/instructors/admin/integration/lms-systems/schoology.rst

@@ -112,4 +112,6 @@ In Schoology
 23. Go back to Schoology and paste the **LTI Integration URL** into the URL field of the Add External Tool form from step 20. 
 24. You can enable grading on external tool items which adds the material to your Gradebook so that you can assign a grade for each student who completes the assignment launched via the external tool.
 
-   .. Note:: LTI and external tool materials that have grading enabled in Schoology do not trigger submission notifications, grading reminders, or overdue notifications because Schoology does not automatically detect submissions from external tools. 
+   .. Note:: LTI and external tool materials that have grading enabled in Schoology do not trigger submission notifications, grading reminders, or overdue notifications because Schoology does not automatically detect submissions from external tools. 
+
+

source/instructors/admin/integration/lti-app.rst

@@ -201,43 +201,6 @@ LTI 1.1
 
 
 
-LTI 1.3
-"""""""
-
-**Custom parameters claim object**
-specified in https://purl.imsglobal.org/spec/lti/claim/custom
-
-**actual_user**
-
-
-+------------------+---------------------------------------------------------------+--------------------------------------------------+
-| Parameter        | Description                                                   | Example                                          |
-+==================+===============================================================+==================================================+
-| id               | id= lms user identification                                   | "actual_user_id": "123"                          |
-|                  |                                                               |                                                  |
-|                  | This is equivalent of sub when the request is executed        |                                                  | 
-|                  | without changing the current user.                            |                                                  |
-+------------------+---------------------------------------------------------------+--------------------------------------------------+
-| email            | email= actual user email                                      |                                                  |
-|                  |                                                               |                                                  |
-|                  | This will be used for registration if                         | "actual_user_email": "lms-admin@email.com"       |
-|                  | custom_actual_user_id is not matched to an existed user.      |                                                  |
-+------------------+---------------------------------------------------------------+--------------------------------------------------+
-| role             | role= actual user role                                        |                                                  |
-|                  |                                                               |                                                  |
-|                  | This should not be Student-like role.                         | "actual_user_role": "Instructor"                 |
-+------------------+---------------------------------------------------------------+--------------------------------------------------+
-| given_name       | given_name= actual user given name                            | "actual_user_given_name": "Name"                 |
-+------------------+---------------------------------------------------------------+--------------------------------------------------+
-| family_name      | family_name= actual user family name                          | "actual_user_family_name": "Family"              |
-+------------------+---------------------------------------------------------------+--------------------------------------------------+
-| full_name        | full_name= actual user full name                              |                                                  |
-|                  |                                                               |                                                  |
-|                  | This could be omitted if                                      | "actual_user_full_name": "Name Family"           |
-|                  | custom_actual_user_name_family and                            |                                                  |
-|                  | custom_actual_user_name_given passed.                         |                                                  |
-+------------------+---------------------------------------------------------------+--------------------------------------------------+
-
 .. Note:: The parameters should be set by LMS dynamically based on current user, not statically. If you need assistance contact help@codio.com
 
 .. important:: Canvas/Moodle/Blackboard do not support this feature.

source/instructors/admin/integration/lti1-3BS-D2L.rst

@@ -23,6 +23,12 @@ Access LTI Integration settings in Codio
 Copy fields from Codio to Brightspace/D2L
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+ .. important::
+    When copying links, please use the copy button adjacent to each link to ensure accuracy and prevent linking errors.
+
+
+
+
 .. figure:: /img/lti/codiolti13settings.png
      :alt: LTI 1.3 settings in Codio
      :width: 350px
@@ -122,28 +128,3 @@ First enable :ref:`LTI Constant URLs <lti-keys-and-urls-information>` for your c
 
 
 
-LTI 1.3 Dynamic Registration
------------------------------
-
-
-Dynamic Registration simplifies the setup process by automatically sharing configuration information between Tools and LMS systems. 
-
-
-Access LTI Integration Settings in Codio
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-.. image:: /img/lti/codiolti13settings.png
-    :alt: LTI 1.3 settings in Codio
-    :align: right
-    :width: 350px
-    :class: img-responsive
-
-
-1. Click your username in the top-right corner, then select **Organizations** from the menu.
-2. In the **Organizations** area, click the name of your organization.
-3. Select the **LTI Integrations** tab.
-4. Scroll down to the **LTI Integration 1.3** section.
-5. The **Dynamic Registration URL** is at the bottom of the list, you can copy it by clicking on the **Dynamic Registration URL** button.
-
-

source/instructors/admin/integration/lti1-3Blackboard.rst

@@ -77,142 +77,3 @@ In Blackboard:
 - Paste the **LTI Integration URL** you copied in the last step into the **Configuration URL** field for your assignments.
 
 
-Blackboard LTI 1.x
--------------------
-
-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. The `following page <https://library.blackboard.com/ref/df5b20ed-ce8d-4428-a595-a0091b23dda3/Content/_admin_app_system/admin_app_basic_lti_tool_providers.htm>`_ explains how to set up external apps in Blackboard Learn.
-
-In Codio:
-
-Enable LTI for Your Course
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-1. Open the course you would like to connect or create a new course.
-2. Make sure you have at least one published assignment or add a new one. (see :ref:`Add and Remove Course Assignments <add-remove-assignment>`)
-3. Select the **LTI/LMS** tab.
-4. Select the **ENABLE LTI** option.  
-
-  .. image:: /img/lti/enable-lti.png
-     :alt: enable lti
-     
-5. Click **Save Changes**.
-
-Bring up the LTI Integration Information
-----------------------------------------
-
-6. Click your user name in the bottom left of your dashboard
-7. Choose your Organization 
-8. Click the **LTI Integrations** tab to bring up the following settings.
-
-  .. image:: /img/lti/LTIintegrationinfo.png
-     :alt: Org LTI info
-
-
-In Blackboard
-~~~~~~~~~~~~~
-
-The Blackboard user who carries out these steps must be a Blackboard system administrator.
-
-9.  Create a new Course in Blackboard. We suggest you create a test course called **Codio Blackboard** before you do it with a production course.
-10.  Look for the **System Admin** tab near the top right of the page and select it.
-11.  Look for the **Building Blocks** section and select it.
-12.  Click on **LTI tool providers**.
-13.  Click on **Register Provider Domain** in the menu bar.
-14.  In the **Provider Domain** field, enter ``apollo.codio.com``.
-15.  In the **Default Configuration** section, set **Default Configuration** to be **Set globally**.
-16.  In the **Organization Policies** section you should
-17.  set **Send User Data** to **Send user data only over SSL**.
-18.  in **User Fields to Send** you should set all 3 fields (Constituency in Course, Name, Email Address).
-
-In Codio and Blackboard
-~~~~~~~~~~~~~~~~~~~~~~~
-
-19. Now return to the **Default Configuration** section in Blackboard. We will now copy the following global integration fields from Codio to Blackboard.
-
--  LTI Consumer -> Tool Provider Key
--  LTI Secret -> Tool Provider Secret
-
-Codio course setup
-------------------
-
-You need to perform the following actions one time only for a course. The Blackboard user who carries out these steps does not need to be a system administrator but must have suitable privileges to edit courses and assignments.
-
-20.  In Codio, go to your course and click on the **LTI/LMS** tab.
-21.  Go to the **LTI/LMS Settings** area.
-22.  At the top is a switch **Enable LTI** which you should check is enabled.
-23.  Below this is an empty field **Course LMS URL**. Switch back to Blackboard and make sure you are on the main the Codio Blackboard course you created earlier. Copy the url in the address bar of your browser to the clipboard and paste it into the above mentioned field in Codio.
-
-This URL ensures that Codio knows how to redirect students back to the correct Blackboard course should they attempt to access the course through their dashboard.
-
-Mapping an assignment to Blackboard Content
--------------------------------------------
-
-The final mapping step needs to be taken for each individual assignment within Codio. It maps a piece of Blackboard content to a Codio assignment.
-
-In Codio
-~~~~~~~~
-
-24.  On the main course screen, make sure the **Edit Assignments** tab is selected.
-25.  Click the **Add Assignment** button and select **Project Based**.
-26.  Select a project that has some autograded assessments. The **My First Project** that you created earlier in the Onboarding Guide has some auto-graded assessments. You can also assign another project but you will need to manually grade the assignment so there are some scores to pass back to the Blackboard gradebook.
-27.  Once the assignment has been added to the course, you should click the 3 dots to the right of that assignment and select **LTI Integration URL**.
-28.  You should copy the LTI integration url to the clipboard by clicking on the field (it will auto copy).
-
-.. figure:: /img/lti/LMS-Unit-URL.png
-   :alt: Unit URL
-
-In Blackboard
-~~~~~~~~~~~~~
-
-We now return to Blackboard complete the mapping.
-
-29.  Make sure you have selected the Blackboard course.
-30.  Click **Content** in the left hand menu.
-31.  Select or hover over **Build Content** in the menu bar
-32.  Select **Web Link**.
-33.  In the **Web Link Information** section ...
-34.  Enter a name for the content
-35.  Paste in the **LTI Integration URL** that you just copied to the clipboard from Codio
-36.  Check the box **This is a link to a tool provider**
-37.  Select **Yes** for the field **Enable Evaluation** after which more fields will appear
-38.  Set the points you want to award for this content (Codio will automatically scale the percentage value it uses to the points you specify here)
-39.  Save the content settings.
-
-Authentication and account creation
------------------------------------
-
-To add students/teachers see :ref:`Users account creation <lms-users>`
-
-LTI 1.3 Dynamic Registration
------------------------------
-
-
-Dynamic Registration simplifies the setup process by automatically sharing configuration information between Tools and LMS systems. 
-
-
-Access LTI Integration Settings in Codio
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-
-.. image:: /img/lti/codiolti13settings.png
-    :alt: LTI 1.3 settings in Codio
-    :align: right
-    :width: 350px
-    :class: img-responsive
-
-
-1. Click your username in the top-right corner, then select **Organizations** from the menu.
-2. In the **Organizations** area, click the name of your organization.
-3. Select the **LTI Integrations** tab.
-4. Scroll down to the **LTI Integration 1.3** section.
-5. The **Dynamic Registration URL** is at the bottom of the list, you can copy it by clicking on the **Dynamic Registration URL** button.
-
-
-
-
-
-
-
-
-
-