Institution-wide Canvas integration is similar to course-by-course Canvas integration. The biggest difference is customizability. While we strongly recommend that instructors follow our course-by-course integration instructions to the letter, we understand that LMS administrators and instructional designers may require more flexibility in their institution-wide setups. To that end, we support a few different LTI configurations for the most common use cases.
A word of caution: While you are welcome to customize our Canvas XMLs as you see fit, we cannot support all possible customizations. We are not responsible if a customization that you designed breaks your Canvas instance, and our ability to support your integration preferences may be limited by your institution's prior customizations, by updates to Canvas' software (which we cannot control), and by our own software updates. Unless you are adept at customizing XMLs and prepared to debug as necessary, we recommend that you stick with one of our boiler plate XMLs.
How to Integrate with Canvas via XML
1. Make sure you have your LMS Key and Secret for your Institutional Network. Your Institutional Network is the broadest Network that belongs to your institution. For example, if you are an Administrator at Yellowdig University, your Institutional Network is probably called "Yellowdig University". If you do not know your Institutional Network's Key and Secret, please reach out to email@example.com.
2. In your Admin page, navigate to Settings → Apps. Then click on the View App Configurations button, followed by the +App button. Do not select the Yellowdig app from the Canvas App Center.
3a. In the Add App pop-up window, choose "By URL" as your configuration type, and copy-paste one of the following URLs into the "Config URL" field unless you are using a custom XML:
The first URL hides the "Yellowdig Engage" sidebar link by default. Your instructors can always set up Yellowdig for their course via the Assignments page (see instructor documentation), and they can enable the sidebar link by navigating to Settings → Navigation, enabling the "Yellowdig Engage" item, and clicking the Save button:
Since it's unlikely that all instructors in your institution will use Yellowdig—and since clicking the "Yellowdig Engage" sidebar link automatically creates a Yellowdig Community—we strongly recommend that you use the first URL to configure Yellowdig for your institution.
Alternatively, you can use the second URL to automatically add a "Yellowdig Engage" link to every instructor's Canvas sidebar. If you choose this option, and if any of your instructors are using Yellowdig to pass back a grade, make sure they know that their students must enter their Yellowdig Community through the Assignments link at least once during the life of their Community in order to establish grade passback.
Finally, fill in the rest of the fields as follows using your Config URL of choice and click the Submit button:
3b. If you are using a custom XML, follow all the steps in (3a) with one exception: instead of "By URL", choose "Paste XML" as your Configuration Type. Then copy-paste your custom XML into the "XML Configuration" field and proceed as usual.