diff --git a/source/img/Blackboardweblink.png b/source/img/Blackboardweblink.png new file mode 100644 index 00000000..3558735d Binary files /dev/null and b/source/img/Blackboardweblink.png differ diff --git a/source/img/Release-grades.png b/source/img/Release-grades.png index ec01109f..61dcd516 100644 Binary files a/source/img/Release-grades.png and b/source/img/Release-grades.png differ diff --git a/source/img/actionarea.png b/source/img/actionarea.png index 20ca11d4..c7d46398 100644 Binary files a/source/img/actionarea.png and b/source/img/actionarea.png differ diff --git a/source/img/addlti13app.png b/source/img/addlti13app.png new file mode 100644 index 00000000..55a20315 Binary files /dev/null and b/source/img/addlti13app.png differ diff --git a/source/img/canvasadvantagesample.png b/source/img/canvasadvantagesample.png new file mode 100644 index 00000000..3225afd1 Binary files /dev/null and b/source/img/canvasadvantagesample.png differ diff --git a/source/img/canvascourseeditortselect.png b/source/img/canvascourseeditortselect.png new file mode 100644 index 00000000..9cf125e9 Binary files /dev/null and b/source/img/canvascourseeditortselect.png differ diff --git a/source/img/canvasdeployment.png b/source/img/canvasdeployment.png new file mode 100644 index 00000000..b8ea0fe9 Binary files /dev/null and b/source/img/canvasdeployment.png differ diff --git a/source/img/canvasdeveloperkeysample.png b/source/img/canvasdeveloperkeysample.png new file mode 100644 index 00000000..4c069c50 Binary files /dev/null and b/source/img/canvasdeveloperkeysample.png differ diff --git a/source/img/canvaslinkassignmentselect.png b/source/img/canvaslinkassignmentselect.png new file mode 100644 index 00000000..f9554315 Binary files /dev/null and b/source/img/canvaslinkassignmentselect.png differ diff --git a/source/img/canvaslinkselect.png b/source/img/canvaslinkselect.png new file mode 100644 index 00000000..f9554315 Binary files /dev/null and b/source/img/canvaslinkselect.png differ diff --git a/source/img/canvasplacementssample.png b/source/img/canvasplacementssample.png new file mode 100644 index 00000000..165bf8df Binary files /dev/null and b/source/img/canvasplacementssample.png differ diff --git a/source/img/canvasplatform25.png b/source/img/canvasplatform25.png new file mode 100644 index 00000000..fd2a3133 Binary files /dev/null and b/source/img/canvasplatform25.png differ diff --git a/source/img/changereleasegrades.png b/source/img/changereleasegrades.png index d765506a..d998da3c 100644 Binary files a/source/img/changereleasegrades.png and b/source/img/changereleasegrades.png differ diff --git a/source/img/createassignment.png b/source/img/createassignment.png new file mode 100644 index 00000000..ba9542fa Binary files /dev/null and b/source/img/createassignment.png differ diff --git a/source/img/developerkeyvaluessample1.png b/source/img/developerkeyvaluessample1.png new file mode 100644 index 00000000..122f1517 Binary files /dev/null and b/source/img/developerkeyvaluessample1.png differ diff --git a/source/img/developerkeyvaluessample2.png b/source/img/developerkeyvaluessample2.png new file mode 100644 index 00000000..dc06d751 Binary files /dev/null and b/source/img/developerkeyvaluessample2.png differ diff --git a/source/img/developerkeyvaluessample3.png b/source/img/developerkeyvaluessample3.png new file mode 100644 index 00000000..a9a2b71b Binary files /dev/null and b/source/img/developerkeyvaluessample3.png differ diff --git a/source/img/grading-release2.png b/source/img/grading-release2.png index 749d065a..0c215080 100644 Binary files a/source/img/grading-release2.png and b/source/img/grading-release2.png differ diff --git a/source/img/groupwork.png b/source/img/groupwork.png index a08200ae..a38cce90 100644 Binary files a/source/img/groupwork.png and b/source/img/groupwork.png differ diff --git a/source/img/managegroups.png b/source/img/managegroups.png index e7454eb0..3b216e53 100644 Binary files a/source/img/managegroups.png and b/source/img/managegroups.png differ diff --git a/source/img/reset-student.png b/source/img/reset-student.png index 1d3a691a..54396d66 100644 Binary files a/source/img/reset-student.png and b/source/img/reset-student.png differ diff --git a/source/img/resetunit.png b/source/img/resetunit.png index 9c4fc609..1a6f86f2 100644 Binary files a/source/img/resetunit.png and b/source/img/resetunit.png differ diff --git a/source/img/what_students_do/expandedcourse.png b/source/img/what_students_do/expandedcourse.png index f06cf9cd..d7800789 100644 Binary files a/source/img/what_students_do/expandedcourse.png and b/source/img/what_students_do/expandedcourse.png differ diff --git a/source/img/what_students_do/newstudentdashboard.png b/source/img/what_students_do/newstudentdashboard.png index be384e40..cb05f1fc 100644 Binary files a/source/img/what_students_do/newstudentdashboard.png and b/source/img/what_students_do/newstudentdashboard.png differ diff --git a/source/img/what_students_do/newstudentdashboard1.png b/source/img/what_students_do/newstudentdashboard1.png index 3e8037bd..0490083b 100644 Binary files a/source/img/what_students_do/newstudentdashboard1.png and b/source/img/what_students_do/newstudentdashboard1.png differ diff --git a/source/img/what_students_do/studentdashboard.png b/source/img/what_students_do/studentdashboard.png deleted file mode 100644 index f83aa2c8..00000000 Binary files a/source/img/what_students_do/studentdashboard.png and /dev/null differ diff --git a/source/instructors/admin/integration/CodioLTI1.3Integrationsample2.png b/source/instructors/admin/integration/CodioLTI1.3Integrationsample2.png new file mode 100644 index 00000000..475a9c33 Binary files /dev/null and b/source/instructors/admin/integration/CodioLTI1.3Integrationsample2.png differ diff --git a/source/instructors/admin/integration/intro.rst b/source/instructors/admin/integration/intro.rst index 2c2bf28d..0b190f80 100644 --- a/source/instructors/admin/integration/intro.rst +++ b/source/instructors/admin/integration/intro.rst @@ -52,5 +52,6 @@ Students who initially accessed Codio through an LMS/LTI system, can set up dire - :ref:`LTI Course Copy ` - :ref:`Exporting Common Cartridge ` - :ref:`LTI 1.3 integration ` -- :ref:`LTI 1.3 integration for Blackboard/D2L ` -- :ref:`LTI 1.3 integration for Canvas ` \ No newline at end of file +- :ref:`LTI 1.3 integration for Brightspace/D2L ` +- :ref:`LTI 1.3 integration for Canvas ` +- :ref:`LTI 1.3 integration for Blackboard ` \ No newline at end of file diff --git a/source/instructors/admin/integration/lti1-3BS-D2L.rst b/source/instructors/admin/integration/lti1-3BS-D2L.rst index 629e9ea0..8074d8ef 100644 --- a/source/instructors/admin/integration/lti1-3BS-D2L.rst +++ b/source/instructors/admin/integration/lti1-3BS-D2L.rst @@ -14,6 +14,11 @@ The following is created in Manage Extensibility, LTI Advantage - Register a Too Access LTI Integration settings in Codio ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. image:: /img/lti/codiolti13settings.png + :alt: LTI 1.3 settings in Codio + :width: 500px + 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. @@ -27,16 +32,6 @@ Copy fields from Codio to Brightspace/D2L 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 - :figwidth: 415px - :align: right - - LTI 1.3 settings in your organization's LTI Integrations. - 1. Copy **Initiate Login URL** to the **OpenID Connect Login URL** field. 2. Copy **Redirect URL** to the **Redirect URL** field. 3. Copy **Keyset URL** to the **Keyset URL** field. @@ -65,7 +60,7 @@ Copy fields from Brightspace/D2L pop-up to Codio .. image:: /img/lti/codioplatformlti1-3.png :alt: LTI 1.3 Platform information in Codio :width: 325px - :align: right + :align: center 1. Copy the **Client ID** to the **Client ID** field in Codio. @@ -112,10 +107,10 @@ In Brightspace/D2L LTI Course copy for Brightspace/D2L ----------------------------------- -.. figure:: /img/lti/enable_class_fork.png +.. image:: /img/lti/enable_class_fork.png :alt: Enable course copy field :width: 375px - :align: right + :align: center Enabling this setting allows existing Codio course content used in your LMS to be copied into a new Codio course and a new course in your LMS. This should be enabled for the courses connected with the "Master" course in your LMS. The parameter will be disabled by default for all copied courses. diff --git a/source/instructors/admin/integration/lti1-3Blackboard.rst b/source/instructors/admin/integration/lti1-3Blackboard.rst index b5917d28..2c449b97 100644 --- a/source/instructors/admin/integration/lti1-3Blackboard.rst +++ b/source/instructors/admin/integration/lti1-3Blackboard.rst @@ -15,23 +15,41 @@ The Blackboard user who carries out these steps must be a system administrator. In Blackboard: ~~~~~~~~~~~~~~ -- On the administrator tools page select the **Register LTI1.3/Advantage Tool** tab. +- On the administrator tools page select **LTI Tool Providers** under the **Integrations** section. +- Select **Register LTI1.3/Advantage Tool** tab. - In the **Client ID** section enter: - For codio.com - ``0128e3c6-67a1-4bfb-9881-747baf0c7105`` - For codio.co.uk - ``20d13eaa-8d29-4763-87ab-8137aa94129f`` +.. tabs:: + + + .. code-tab:: text + :caption: For codio.com + + + 0128e3c6-67a1-4bfb-9881-747baf0c7105 + + + .. code-tab:: text + :caption: For codio.co.uk + + + 20d13eaa-8d29-4763-87ab-8137aa94129f + + + .. Note:: If you get a message saying you are migrating your tool from LTI 1.1 to LTI 1.3 click **Ok**. -- At the bottom: +- Click **Submit**. +- At the bottom of the new page: +- Click **Yes** for **Allow Grade Service Access** +- Click **Yes** for **Allow Membership Service Access** - - Click **Yes** for **Allow Grade Service Access** - - Click **Yes** for **Allow Membership Service Access** +- Copy the **Default Deployment ID** value from this page. - Click **Submit** and the tool will be created. -- Copy the **Default Deployment ID** value from this page. Part 2: In Codio - Create the configuration @@ -74,6 +92,12 @@ In Codio enable LTI for Your Course In Blackboard: ~~~~~~~~~~~~~~ -- Paste the **LTI Integration URL** you copied in the last step into the **Configuration URL** field for your assignments. +- Paste the **LTI Integration URL** you copied in the last step into the **URL** field for your assignments. + + .. image:: /img/Blackboardweblink.png + :alt: Blackboard Configuration URL field for LTI Integration URL + :width: 750px + + diff --git a/source/instructors/admin/integration/lti1-3Canvas.rst b/source/instructors/admin/integration/lti1-3Canvas.rst index 6dcf9f4b..027b868c 100644 --- a/source/instructors/admin/integration/lti1-3Canvas.rst +++ b/source/instructors/admin/integration/lti1-3Canvas.rst @@ -8,7 +8,6 @@ LTI 1.3 for Canvas On this page, you will find detailed step-by-step guidelines to help you integrate your Canvas and Codio accounts and connect assignments between the two applications. - LTI version 1.3 improves upon version 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 @@ -19,277 +18,157 @@ Part 1: In Canvas - Create a Developer Key ------------------------------------------ The Canvas user who carries out these steps must be a system administrator. - .. important:: - When copying links, please use the copy button adjacent to each link to ensure accuracy and prevent linking errors. - - - -+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| In Codio:
| |image1| | -| 1. Click your username in the | | -| top-right corner, then select Organization from the menu. | | -| In the Organizations area, click the name of your organization.

| | -| | | -| 2. Select the LTI Integrations tab.

| | -| 3. Scroll down to the LTI Integration 1.3 section; you should | | -| see the following fields. Keep this page open. | | -|
| | -+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| In Canvas:
| |image2| | -| 4. Select Admin -> Developer Keys

| | -| 5. Click on Developer Key and select +LTI key. | | -| | | -|
| | -+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| | |image3| | -| 6. Complete the Key Name, Title and Description | | -| fields. Make sure to set the method to Manual Entry | | -|

| | -| 7. From Codio, under LTI 1.3 Integration, copy the LTI URL | | -| and paste it into the Target Link URI field in Canvas.

| | -| 8. From Codio copy the Initiate Login URL and paste it into the | | -| OpenID Connect Initiation URL.

| | -| 9. Copy the Redirect URL and paste it into the | | -| Canvas Redirect URI field. | | -| | | -|
| | -+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| | |image4| | -| 10. In Canvas, change JWK Method to | | -| Public JWK URL.

| | -| 11. From Codio, copy the Keyset URL and paste it into | | -| the Public JWK URL field. | | -|
| | -+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| | |image5| | -| 12. Expand the LTI Advantage Services section and toggle | | -| each field on.

| | -| 13. Expand the Additional Settings section

| | -| | | -| 14. Type "codio.com" in both the Domain and | | -| Tool Id fields.

| | -| 15. Select the Privacy level as Public. | | -| | | -| | | -|
| | -+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| | |image6| | -| 16. Scroll down to the Placements field. You can add a placement | | -| by starting to type the name and then selecting it when it appears. | | -| Placements that should be included (remove any others): | | -| Link Selection, Editor Button, Assignment Selection and Course Navigation. | | -|
| | -+-----------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ - - -+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| |image7| | -| | -| | -| .. raw:: html | -| | -|
| -| 17. Expand each of the following fields, and copy the static links below:

| -| | -| Link Selection
| -| Select LtiDeepLinkingRequest
| -| | -| Target Link URI:
| -| https://apollo.codio.com/lti/resource_selection | -|
| -| | -| Icon URL:
| -| https://static-assets.codio.com/dashboard/images/icons/favicon-16x16.da14ae918fd9bc3b.png | -|
| -| | -| | -|
| -+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - - - -+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| |image8| | -| | -| .. raw:: html | -| | -|
| -| Editor button
| -| | -| Target Link URI:
| -| https://apollo.codio.com/lti/editor_button | -|
| -| | -| Icon URL:
| -| https://static-assets.codio.com/dashboard/images/icons/favicon-16x16.da14ae918fd9bc3b.png | -|
| -|
| -+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| |image9| | -| | -| .. raw:: html | -| | -|
| -| Assignment Selection
| -| Select LtiDeepLinkingRequest
| -| | -| Target Link URI:
| -| https://apollo.codio.com/lti/resource_selection | -|
| -| | -| Icon URL:
| -| https://static-assets.codio.com/dashboard/images/icons/favicon-16x16.da14ae918fd9bc3b.png | -|
| -|
| -+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| |image10| | -| | -| .. raw:: html | -| | -|
| -| Course Navigation
| -| | -| Target Link URI:
| -| https://apollo.codio.com/lti/course_navigation | -|
| -| | -| Icon URL:
| -| https://static-assets.codio.com/dashboard/images/icons/favicon-16x16.da14ae918fd9bc3b.png | -|
| -|
| -+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | -| | -| | -+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ - - - - -+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| | |image11| | -| 18. Click Save in bottom-right corner

| | -| 19. You will be back at the list of developer keys.

| | -| 20. Update State to: on

| | -| 21. Copy the number in the Details column (for use in Parts 2 and 3) | | -|
| | -+-------------------------------------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------+ - - - .. |image1| image:: /instructors/admin/integration/CodioLTI1.3Integration.png - :alt: LTI 1.3 integration fields in Codio - :width: 1500px - - .. |image2| image:: /img/lti/canvasdeveloperkey.png - :alt: Canvas Developer Keys page - :width: 1500px +.. important:: + When copying links, please use the copy button adjacent to each link to ensure accuracy and prevent linking errors. - .. |image3| image:: /img/lti/developerkeyvalues.png - :alt: Canvas LTI key configuration fields - :width: 1500px - .. |image4| image:: /img/lti/canvasJWK.png - :alt: Canvas JWK settings - :width: 1500px - .. |image5| image:: /img/lti/canvasadvantage.png - :alt: LTI Advantage Services toggles in Canvas - :width: 1500px +**In Codio:** - .. |image6| image:: /img/lti/canvasplacements.png - :alt: Canvas placements configuration - :width: 1500px +1. Click your username in the top-right corner, then select **Organization** from the menu. In the Organizations area, click the name of your organization. + +2. Select the **LTI Integrations** tab. + +3. Scroll down to the **LTI Integration 1.3** section; you should see the following fields. Keep this page open. + + +**In Canvas:** + +|image1| + + +4. Select **Admin -> Developer Keys** + +5. Click on **Developer Key** and select **+LTI key**. + +6. Complete the **Key Name, Title** and **Description** fields. Make sure to set the **method** to **Manual Entry**. - .. |image7| image:: /img/lti/canvaslinkselect.png +|image2| + + ++------+--------------------------------------------------------+-----------------------------------------------------------------------+ +| | **Copy** | **Paste** | ++======+========================================================+=======================================================================+ +| 7 | From Codio, under **LTI 1.3 Integration, copy the** | Paste it into the **Canvas Redirect URI** field. | +| | **Redirect URL** | | ++------+--------------------------------------------------------+-----------------------------------------------------------------------+ +| 8 | Copy the **LTI URL** | Paste it into the **Target Link URI field** in Canvas. | ++------+--------------------------------------------------------+-----------------------------------------------------------------------+ +| 9 | Copy the **Initiate Login URL** | Paste it into the **OpenID Connect Initiation URL**. | ++------+--------------------------------------------------------+-----------------------------------------------------------------------+ +| 10 | In Canvas, change **JWK Method** to **Public JWK URL**.| | ++------+--------------------------------------------------------+-----------------------------------------------------------------------+ +| 11 | From Codio, copy the **Keyset URL** | Paste it into the **Public JWK URL** field. | ++------+--------------------------------------------------------+-----------------------------------------------------------------------+ + + +|image3| + +12. Expand the **LTI Advantage Services** section and enable the desired fields. Ensure all gradebook-related services are enabled for grades to pass back to Canvas. + +13. Expand the **Additional Settings** section. + +14. Type "codio.com" in both the **Domain** and **Tool Id** fields. + +15. Select the **Privacy level** as **Public**. + +16. Scroll down to the **Placements** field. You can add a placement by starting to type the name and then selecting it when it appears. Placements that should be included (remove any others): Link Selection, Editor Button, Assignment Selection and Course Navigation. + +|image4| + +17. Expand each of the following fields, and copy the static links below: + +.. image:: /img/canvaslinkassignmentselect.png :alt: Canvas Link Selection placement - :width: 1500px + :width: 750px - .. |image8| image:: /img/lti/canvaseditorbutton.png - :alt: Canvas Editor Button placement - :width: 1500px - .. |image9| image:: /img/lti/canvasassignment.png - :alt: Canvas Assignment Selection placement - :width: 1500px +.. list-table:: **Link Selection and Assignment Selection** + :widths: 30 70 + :header-rows: 0 + + * - **Select Message Type** + - **LtiDeepLinkingRequest** + +.. tabs:: + + .. code-tab:: text + :caption: Target Link URI + + https://apollo.codio.com/lti/resource_selection + +.. tabs:: + + .. code-tab:: text + :caption: Icon URL + + https://static-assets.codio.com/dashboard/images/icons/favicon-16x16.da14ae918fd9bc3b.png + + +.. image:: /img/canvascourseeditortselect.png + :alt: Canvas Link Selection placement + :width: 750px + + +.. list-table:: **Course Navigation and Editor Button** + :widths: 30 70 + :header-rows: 0 + + * - **Select Message Type** + - **LtiDeepLinkingRequest** + + +.. tabs:: + + .. code-tab:: text + :caption: Target Link URI + + https://apollo.codio.com/lti/resource_selection + +.. tabs:: + + .. code-tab:: text + :caption: Icon URL + + https://static-assets.codio.com/dashboard/images/icons/favicon-16x16.da14ae918fd9bc3b.png + + + + +18. Click **Save** in bottom-right corner + +19. You will be back at the list of developer keys. + +|image5| + +20. Update **State** to: on + +21. Copy the number in the **Details** column (for use in Parts 2 and 3) + + + .. |image1| image:: /img/lti/canvasdeveloperkey.png + :alt: Canvas Developer Keys page + :width: 750px + + .. |image2| image:: /img/developerkeyvaluessample1.png + :alt: Canvas LTI key configuration fields + :width: 500px - .. |image10| image:: /img/lti/canvasnavigation.png - :alt: Canvas Course Navigation placement - :width: 1500px + .. |image3| image:: /img/canvasadvantagesample.png + :alt: LTI Advantage Services toggles in Canvas + :width: 750px + + .. |image4| image:: /img/canvasplacementssample.png + :alt: Canvas placements configuration + :width: 500px - .. |image11| image:: /img/lti/canvasdetails.png + .. |image5| image:: /img/lti/canvasdetails.png :alt: Canvas Developer Key list with details :width: 1500px + + Part 2: Create an application in your course in Canvas ------------------------------------------------------ @@ -297,28 +176,28 @@ Part 2: Create an application in your course in Canvas In Canvas: ~~~~~~~~~~ -+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | .. image:: /img/lti/addlti13app.png | -|
| | -| 1. Select an existing course or create a new course.
| | -| Optional: create a test course called Codio Test Course before | | -| you do it with a production course.

| | -| 2. In your course, go to Settings → Apps → + App

| | -| 3. In Configuration Type, select: By Client ID

| | -| 4. Paste number you copied in Part 1 into Client ID field

| | -| 5. Submit → Install

| | -|
| | -+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | .. image:: /img/lti/canvasdeployment.png | -|
| | -| 6. After you click install, click the gear icon by the tool you just created

| | -| 7. Select Deployment ID

| | -| | | -| 8. Copy the ID displayed, it will be used in Part 3 | | -|
| | -+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + +1. Select an existing course or create a new course. **Optional**: create a test course called Codio Test Course before you do it with a production course. + +2. In your course, go to **Settings → Apps → + App** + +.. image:: /img/addlti13app.png + :width: 450px + +3. In Configuration Type, select: **By Client ID** + +4. Paste the number you copied in Part 1 into **Client ID** field + +5. **Submit → Install** + +.. image:: /img/canvasdeployment.png + :width: 450px + +6. After you click install, click the gear icon by the tool you just created + +7. Select **Deployment ID** + +8. Copy the ID displayed, it will be used in Part 3 @@ -328,116 +207,101 @@ Part 3: Create an LTI configuration in Codio In Codio: ~~~~~~~~~ +.. image:: /img/lti/addlti13integration.png + :width: 750px + +1. In your org → **LTI Integrations** + + - Scroll down to **LTI 1.3 Configurations** + - Click **Add Integration** + +Updating the fields in Platform Information + +.. note:: + Replace [CANVAS DOMAIN] with your institution's domain in steps 5–7. Remove the brackets. Example: https://yourinstitution.instructure.com/api/lti/security/jwks + + +.. image:: /img/canvasplatform25.png + :width: 500px + + +2. **Platform ID:** + +.. tabs:: + + .. code-tab:: text + :caption: Platform ID + + https://canvas.instructure.com + + + + + +3. **Client ID:** copied from Developer Keys at end of Part 1 + +4. **Deployment ID:** copied in Part 2 + +5. **Public Keyset URL:** + +.. tabs:: -+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| 1. In your org → LTI Integrations
| .. image:: /img/lti/addlti13integration.png | -| - Scroll down to LTI 1.3 Configurations
| | -| - Click Add Integration

| | -|
| | -+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ -| .. raw:: html | | -| | | -|
| | -| Updating the fields in Platform Information

| | -| Note: replace [CANVAS DOMAIN] with your institution's | | -| domain in steps 5–7. Remove the brackets. Example: | | -| https://yourinstitution.instructure.com/api/lti/security/jwks

| .. image:: /img/lti/canvasplatform25.png | -| 2. Platform ID:
| | -| https://canvas.instructure.com | | -| | | -| | | -|

| | -| 3. Client ID: copied from Developer Keys at end of Part 1

| | -| 4. Deployment ID: copied in Part 2

| | -| | | -| 5. Public Keyset URL:
| | -| https://[CANVAS DOMAIN]/api/lti/security/jwks | | -| | | -|

| | -| 6. Access Token URL:
| | -| https://[CANVAS DOMAIN]/login/oauth2/token | | -| | | -|

| | -| 7. Authentication Request URL:
| | -| https://[CANVAS DOMAIN]/api/lti/authorize_redirect | | -| | | -|

| | -| 8. Click Create | | -| | | -|
| | -+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ -| .. raw:: html | -| | -| | -+-------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------+ + .. code-tab:: text + :caption: Public Keyset URL + https://[CANVAS DOMAIN]/api/lti/security/jwks +6. **Access Token URL:** + +.. tabs:: + + .. code-tab:: text + :caption: Access Token URL + + https://[CANVAS DOMAIN]/login/oauth2/token + +7. **Authentication Request URL:** + +.. tabs:: + + .. code-tab:: text + :caption: Authentication Request URL + + https://[CANVAS DOMAIN]/api/lti/authorize_redirect + +8. Click **Create** Part 4: Adding a resource ------------------------- In Canvas: ~~~~~~~~~~ -+-------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ -| .. raw:: html | .. image:: /img/lti/createassignment.png | -| | | -|
| | -| 1. Go to Assignments in your course, then click | | -| Assignment.

| | -| 2. Give your assignment a name.

| | -| 3. Select a number of points.

| | -| 4. Under Submission Type, select External Tool.

| | -| 5. Select Find.

| | -| | | -| Note: Do not paste the LTI Integration URL directly into the Canvas | | -| External Tool URL field when creating an assignment. Instead, use the deep link | | -| “Find” flow (recommended) or follow the “Connect by LTI Integration URL” method | | -| described below.

| | -| | | -| | | -| 6. Select the tool created in Part 1.
| | -|
  • Choose the Course and Assignment to connect to
    • | | -|
  • Recommended: Select Load in a new tab

| | -| | | -| 7. Select Save at bottom of the page | | -|
| | -+-------------------------------------------------------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------+ - - .. note:: - These settings are not final and can be edited in Canvas at a later time. + +1. Go to **Assignments** in your course, then click **Assignment**. + +.. image:: /img/createassignment.png + :width: 500px + +2. Give your assignment a name. + +3. Select a number of points. + +4. Under **Submission Type**, select **External Tool**. + +5. Select Find. + +.. note:: + Do not paste the LTI Integration URL directly into the Canvas External Tool URL field when creating an assignment. Instead, use the deep link "Find" flow (recommended) or follow the "Connect by LTI Integration URL" method described below. + +6. Select the tool created in Part 1. + + - Choose the Course and Assignment to connect to + - Recommended: Select Load in a new tab + +7. Select **Save** at bottom of the page. + + +.. note:: + These settings are not final and can be edited in Canvas at a later time. Part 5: Customizing Iframe Width/Height @@ -466,32 +330,3 @@ Connecting/mapping assignments in Canvas There are also a number of ways you can connect/map assignments. Check out the following videos to see the option that best suits you. -How to Connect an Assignment by LTI Integration URL -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. raw:: html - -
- -How to Connect an Assignment via Resource Selection Preview -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. raw:: html - -
- -How to Connect an Assignment by Endpoint URL -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. raw:: html - -
- -How to Connect an Assignment with a Custom Parameter -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. raw:: html - -
- - diff --git a/source/instructors/authoring/assessments/standard-code-test.rst b/source/instructors/authoring/assessments/standard-code-test.rst index c399fec7..145af1b4 100644 --- a/source/instructors/authoring/assessments/standard-code-test.rst +++ b/source/instructors/authoring/assessments/standard-code-test.rst @@ -16,9 +16,8 @@ For more information about adding a Standard Code Test, view this video .. raw:: html -
- - +
+ Assessment Auto-Generation ++++++++++++++++++++++++++ diff --git a/source/instructors/setupcourses/assignment-settings/assignment-actions.rst b/source/instructors/setupcourses/assignment-settings/assignment-actions.rst index 33119ef0..2567810a 100644 --- a/source/instructors/setupcourses/assignment-settings/assignment-actions.rst +++ b/source/instructors/setupcourses/assignment-settings/assignment-actions.rst @@ -6,12 +6,18 @@ Assignment Action Buttons ========================= -Additional options are available from the **Actions** button in the assignment. Access assignment **Actions** by selecting the **Settings** icon in the assignment. +Additional options are available from the **Actions** section, accessed via the **Settings** icon in the assignment. .. image:: /img/class_administration/assignmentsettings.png :alt: Settings -Open the **Actions** menu to see additional buttons that allow you to run a plagiarism check, mark and unmark all assignments as completed, download the assignment grade data, reset student's work on assignments, re-run an auto-grade script, and release the grades for the assignment. +Open the **Progress** tab to see additional buttons that allow you to: + - Run a plagiarism check + - Mark and unmark all assignments as completed + - Download the assignment grade data + - Reset students' work on assignments + - Re-run an auto-grade script + - Release grades for the assignment .. image:: /img/actionarea.png :alt: Actions Button @@ -27,10 +33,11 @@ Open the **Actions** menu to see additional buttons that allow you to run a plag - **Download CSV** - Click this button to download a CSV file with student grade data for the assignment. For more information on the data included see :ref:`Export Assignment Data ` -- **Reset** - Click this button to clear all student work. This option is used when you have updated an assignment in your course and you need to reset it so all student assignments are updated with the new assignment. You can reset assignments using the **Action > Reset** button, or the menu in the assignment: +- **Reset** - You can reset assignments using the **Reset** button in the Progress tab. This will erase all student work and progress for the entire class. To reset an assignment for a single student without affecting others, use the three-dot menu next to their name. + .. image:: /img/resetunit.png - :alt: Action > Reset + :alt: Progress tab > Reset .. image:: /img/reset-student.png :alt: Reset Assignment diff --git a/source/instructors/teaching/grading/release-grades.rst b/source/instructors/teaching/grading/release-grades.rst index 33935a99..6546bd85 100644 --- a/source/instructors/teaching/grading/release-grades.rst +++ b/source/instructors/teaching/grading/release-grades.rst @@ -15,7 +15,7 @@ By default students are not shown the grades until you decide to release them to If you want to release the grades as the assignments are graded, follow these steps: -1. Open the course and click the **Grading Basics** tab. +1. Open the course and click the **Basic Settings** tab under **Grading**. 2. Toggle the **Release Grades Automatically** setting to enable it. .. image:: /img/changereleasegrades.png diff --git a/student-source/courses.rst b/student-source/courses.rst index a0d361de..79272fab 100644 --- a/student-source/courses.rst +++ b/student-source/courses.rst @@ -26,11 +26,15 @@ Dashboard: Navigation menu --------------- -Use left navigation menu to access the different areas of the UI: +Use top navigation menu to access the different areas of the UI: + +- **Courses** - Opens your **Courses** page to view all available courses. +- **Join a Course**- Opens a window to enroll in a new course by entering your course token. +- **BUILD** - Opens access to project tools and our professional IDE. +- **HELP** - Opens resources for customer service and help documentation. + + -- **STUDY** - Provides a link to access your **Courses**. -- **BUILD** - Provides links to access project tools and our professional IDE. -- **HELP** - Provides links to our customer service team and our help documentation. Courses ------- @@ -39,19 +43,18 @@ The student courses are displayed in the right pane, as shown below with the def .. image:: /img/what_students_do/newstudentdashboard1.png :alt: Student Dashboard -**1** - Toggle between list view or tile view to see your courses. -**2** - **To Do** panel shows your assignments, including due dates (if set by your instructor/teacher). +**1** - **To Do** panel shows your assignments, including due dates (if set by your instructor/teacher). - Click the arrow to expand or collapse the panel. - Click the assignment pane open it. -**3** - **Feedback** panel shows a list of recent feedback for your assignments when grades have been released by your instructor. +**2** - **Feedback** panel shows a list of recent feedback for your assignments when grades have been released by your instructor. - Click the arrow to expand or collapse the panel. - Click the feedback panel to open it and review your assessments, grading comments, and any code comments from your instructor. -**4** - **Courses** panel is the main panel on the page and is where you can see the courses, modules and assignments that have been assigned to you, and the end date for the assignment. If your teacher/instructor has enabled the feature, you will also see a progress bar displaying your overall progress. Up to five pinned assignments can be displayed more prominently at the top of the page. From this area, you can easily re-open the assignment you were last working on, or start any of the other assignments that have been assigned to you. You start or open an assignment using the navigation buttons. +**3** - **Courses** panel is the main panel on the page where you can see your courses, modules, and assignments. Up to five pinned assignments appear at the top of the page for quick access. You can restart a previous assignment or start any newly assigned work. If progress bars are enabled by your teacher, you will also see your progress. - Click the course pane to open and view the modules and assignments in the course. @@ -60,13 +63,15 @@ The student courses are displayed in the right pane, as shown below with the def .. image:: /img/what_students_do/expandedcourse.png :alt: Expanded Course on Default Dashboard +**4** - **Leaderboard** panel (if enabled by your teacher) is where you can see your overall progress in comparison to other students in the course for mandatory assignments. + +.. Note:: You can also create your own projects using the links under **BUILD** in the top navigation pane. See :ref:`Creating or Importing a Project ` for more information. -.. Note:: You can also create your own projects using the links under **BUILD** in the left navigation pane. See :ref:`Creating or Importing a Project ` for more information. Projects -------- -You can create your own projects using the web-based IDE in Codio. To access the project area, use the BUILD links in the left navigation pane. See :ref:`Projects ` for more information. +You can create your own projects using the web-based IDE in Codio. To access the project area, use the BUILD links in the top navigation pane. See :ref:`Projects ` for more information. **See Also:** diff --git a/student-source/students/courses/accessing.rst b/student-source/students/courses/accessing.rst index 3280901c..02e1895f 100644 --- a/student-source/students/courses/accessing.rst +++ b/student-source/students/courses/accessing.rst @@ -10,7 +10,7 @@ You access your courses from the **Courses** page and drill down to view the ass 1. Select **Courses** in the navigation pane to display all of the courses assigned to you in the right pane. Your current courses are displayed on the **Active** page and previous courses are displayed on the **Archived** page. - .. image:: /img/what_students_do/studentdashboard.png + .. image:: /img/what_students_do/newstudentdashboard.png :alt: Student Dashboard Up to 5 pinned assignments are displayed more prominently at the top of the page and includes the end date for the assignment, which was set by your instructor. diff --git a/student-source/students/courses/navigate-student-dashboard.rst b/student-source/students/courses/navigate-student-dashboard.rst index 2ff5c93b..6b2e9f0d 100644 --- a/student-source/students/courses/navigate-student-dashboard.rst +++ b/student-source/students/courses/navigate-student-dashboard.rst @@ -14,11 +14,13 @@ The Student dashboard is the main page students use to navigate Codio. Navigation menu --------------- -Use left navigation menu to access the different areas of the UI: +Use top navigation menu to access the different areas of the UI: + +- **Courses** - Opens your **Courses** page to view all available courses. +- **Join a Course**- Opens a window to enroll in a new course by entering your course token. +- **BUILD** - Opens access to project tools and our professional IDE. +- **HELP** - Opens resources for customer service and help documentation. -- **STUDY** - Provides a link to access your **Courses**. -- **BUILD** - Provides links to access project tools and our professional IDE. -- **HELP** - Provides links to our customer service team and our help documentation. Courses ------- @@ -27,19 +29,18 @@ The student courses are displayed in the right pane, as shown below with the def .. image:: /img/what_students_do/newstudentdashboard1.png :alt: Student Dashboard -**1** - Toggle between list view or tile view to see your courses. -**2** - **To Do** panel shows your assignments, including due dates (if set by your instructor/teacher). +**1** - **To Do** panel shows your assignments, including due dates (if set by your instructor/teacher). - Click the arrow to expand or collapse the panel. - Click the assignment pane open it. -**3** - **Feedback** panel shows a list of recent feedback for your assignments when grades have been released by your instructor. +**2** - **Feedback** panel shows a list of recent feedback for your assignments when grades have been released by your instructor. - Click the arrow to expand or collapse the panel. - Click the feedback panel to open it and review your assessments, grading comments, and any code comments from your instructor. -**4** - **Courses** panel is the main panel on the page and is where you can see the courses, modules, and assignments that have been assigned to you, and the end date for the assignment. Up to five pinned assignments can be displayed more prominently at the top of the page. From this area, you can easily re-open the assignment you were last working on, or start any of the other assignments that have been assigned to you. You start or open an assignment using the navigation buttons. If course/module progress bars are enabled by your teacher, you will also see your progress. +**3** - **Courses** panel is the main panel on the page where you can see your courses, modules, and assignments. Up to five pinned assignments appear at the top of the page for quick access. You can restart a previous assignment or start any newly assigned work. If progress bars are enabled by your teacher, you will also see your progress. - Click the course pane to open and view the modules and assignments in the course. @@ -48,14 +49,14 @@ The student courses are displayed in the right pane, as shown below with the def .. image:: /img/what_students_do/expandedcourse.png :alt: Expanded Course on Default Dashboard -**5** - **Leaderboard** panel (if enabled by your teacher) is where you can see your overall progress in comparison to other students in the course for mandatory assignments. +**4** - **Leaderboard** panel (if enabled by your teacher) is where you can see your overall progress in comparison to other students in the course for mandatory assignments. -.. Note:: You can also create your own projects using the links under **BUILD** in the left navigation pane. See :ref:`Creating or Importing a Project ` for more information. +.. Note:: You can also create your own projects using the links under **BUILD** in the top navigation pane. See :ref:`Creating or Importing a Project ` for more information. Projects -------- -You can create your own projects using the web-based IDE in Codio. To access the project area, use the BUILD links in the left navigation pane. +You can create your own projects using the web-based IDE in Codio. To access the project area, use the BUILD links in the top navigation pane. **See Also:**