Initial administrative setup
Check with your D2L administrator as they may have already completed this step for your institution. If they have set up Perusall as a global tool, you may be able to skip to the next section.
First set up Perusall as an External Learning Tool by selecting External Learning Tools > Manage Tool Providers > New Tool Provider. In the resulting screen:
- Launch Point: https://app.perusall.com/lti/launch
- LTI version: 1.1
- OAuth Signature Method: HMAC-SHA1
- Secret: (provided by Perusall Support)
- Use custom tool consumer information instead of default: Yes
- Key: (provided by Perusall Support)
- Name: Perusall
- Description: The Perusall social learning platform.
- Contact Email: support@perusall.com
- Allow users to use this tool provider: Yes
- Send tool consumer information to tool provider: Yes
- Send context information to tool provider: Yes
- Send course information to tool provider: Yes
- Send LTI user ID and LTI role list to tool provider: Yes
- Send user name to tool provider: Yes
- Send user email to tool provider: Yes
- Send system username to tool provider: Yes
- Send system Org Defined ID to tool provider: No
- Send system role to tool provider: Yes
- Send link title to tool provider: Yes
- Send link description to tool provider: Yes
If you do not have your key and secret, request it from Perusall Support (for security verification purposes, provide a link to an institutional web page that shows your name, title, email address).
Setting up your course
- Create a link in your course that points to Perusall: within one of your content modules, select Add Existing Activities > External Learning Tools > Create New LTI Link. (In some versions of D2L this is labeled Add Link To > External Learning Tools > Create New LTI Link.)
- Enter Perusall for the name and https://app.perusall.com/lti/launch for the launch point.
- Select Edit properties in place in the dropdown next to the newly-created link, and check Open as external resource.
- Reload the page.
- Click on the new Perusall link. Perusall will launch and a course will be created that is connected to your D2L course.
- Set up your readings and assignments within Perusall.
Video tutorial
Setting up grade sync
For grades in Perusall to sync back to D2L, students must access each assignment in Perusall through an external tool link in D2L that has the same name as the assignment in Perusall.
For each assignment in Perusall:
- Click on an assignment under Assignments on your course home page, and click the Copy full title for LMS button. (This will copy the name of the assignment to the clipboard.)
- In D2L, within one of your content modules, select Add Existing Activities > External Learning Tools > Create New LTI Link.
- For the name, paste in the Perusall assignment name from the clipboard, and enter https://app.perusall.com/lti/launch for the launch point.
- Select Edit properties in place in the dropdown next to the newly-created link, and check Open as external resource.
- Reload the page.
- Test out the link by clicking on it. You should be taken directly into the corresponding assignment in Perusall, bypassing the course home page in Perusall. If you are instead taken to the course home page in Perusall, check that the name of your link in D2L matches exactly with the name of the assignment in Perusall.
Note: To ensure that grade sync works throughout the semester, make sure that students access each Perusall assignment by clicking through the corresponding link in D2L. If a student accesses an assignment in Perusall without clicking through the corresponding D2L assignment link at least once, then Perusall will not be able to send that student's score back to D2L. As a result, you may want to hide or delete the generic Perusall link you created in D2L to force students to access assignments through the corresponding assignment-specific links.