Articles in this section

Sakai Course Integration

Avatar
Customer Success Team
  • Updated
× CAUTION: Do not create multiple graded assignment links. This will create significant grade passback problems for your Community that could be difficult or impossible to reverse. For more information, see our LTI FAQ.
× NOTE: If Yellowdig has already been configured for your entire institution, you probably do not need an LMS key and secret, and your setup process is likely to be simpler than the process outlined below, depending on institutional configurations. If you are in this situation and require additional assistance, please reach out to us at clientsuccess@yellowdig.com.

How to install Yellowdig and configure grading

1. Request your LMS Key and Secret from a Network Administrator who belongs to your Network. If you do not know who to contact, please reach out to support@yellowdig.com. Do not accept Keys and Secrets from Administrators who do not belong to your Network, and make sure that the Key and Secret you received belongs to the Network in which you want to create your Community. If you use a Key and Secret from a different Network—even if it's a parent Network—your Community will appear in the wrong Network, and your students may have trouble accessing your Community. In addition, your institutional and departmental usage data will be less accurate. 

2. In your Course page, navigate to Site Info → Manage Tools. Then check the External Tool box, scroll down, and click Continue.

3. In the Title field on the next screen, enter "Yellowdig". Then click Continue.

4. On the next screen, click Finish.

5. Finally, click the Submit button. (These steps are demonstrated in the GIF below. To see it clearly, you may need to zoom in on your browser.)

sakai1.gif

6. Click on the new Yellowdig link in the left-hand navigation. This will take you to a screen that says "This tool has not yet been configured."

7. Click on the Edit button in the upper-right hand corner of the screen. This will take you to a tool configuration form.

sakai2.gif

8. We recommend filling out the form as follows. Items marked with an asterisk must be filled out in accordance with our recommendations in order for Yellowdig to install properly. In order to pass back grades from Yellowdig to Sakai, you must fill out the Routing Grades to the Gradebook section at this stage of the process.

Required Information
   *Remote Tool URL: https://api.yellowdig.app/launch
   *Remote Tool Key: [your network LTI key]
   *Remote Tool Secret: [your network LTI secret]
Display Information
   Set Button Text: Yellowdig
   Set Tool Title: Yellowdig
   Choose an Icon for this Tool: [leave blank]
Routing Grades to the Gradebook
   Create Gradebook Item: Yellowdig
   Select Gradebook Item: [keep default]
Optional Launch Information
   Open in a New Window: [uncheck]
   iFrame Height: [leave blank]
   Enable SHA-256 Signatures: [leave blank]
   Debug Launch: [leave blank]
Releasing Roster Information
   *Send Names to External Tool: [check]
   *Send Email Addresses to the External Tool: [check]
   Allow the External Tool to Retrieve the Course Roster: [uncheck]
Storing Tool Settings
   Allow the External Tool to Store and Retrieve its Settings: [uncheck]
Splash Screen
   This text will be displayed...: [leave blank]
   You can add a series...: [leave blank]

 9. Scroll to the bottom of the page and click Update Options.

10. To include Yellowdig points in students' final grade calculations, go to the Gradebook, select the small down arrow in the corner of the "Yellowdig" box, select "Edit Item Details" in the pop-up menu, check the box next to "Include item in course grade calculations?", and click "Save Changes". 

How to LTI-create your Yellowdig Community

1. Click the left-hand navigation link that you just created, which will launch Yellowdig and prompt you to create your Community for the class. Since the first user to click the link is automatically made the Community Owner, it is important that you click the assignment link and set up your Community before your students can access it.

2. When you click the link, your Community will be created automatically. You can now adjust Community settings and set up points within the platform.

3. To establish grade passback, you and each of your students must launch into Yellowdig through the graded Assignment link that you created. Be sure to communicate this to your students directly and/or direct them to this help article.

Related articles