Moodle Integration Features

Roster Sync

Each time you launch Perusall from Moodle, a roster sync is run in the background.  Any students that have added to your LMS course will be added to your Perusall course roster (under the Students tab), and any that have unenrolled will be removed from the course.

Grade Sync

If you'd like to sync scores from Perusall to your Moodle, in your Perusall course, navigate to Settings > Scoring > LMS grade sync.  Learn more about grade sync in LTI 1.3.

• A student’s average score is each individual assignment score summed and then divided by the total number of assignments, while the total score simply takes the sum of across all assignments.

  Syncing the average or total score rather than individual assignment scores saves time because  Perusall will automatically create a grade book column in your LMS course that matches the summary column in your Perusall course, and send the scores for all assignments that have been released and are passed their due date.  To set up average or total grade sync:

  • Launch into your Perusall course > Click Settings > Scoring > scroll to Grade sync to LMS > select Automatically sync students' average or total scores back to the LMS > save.

  Students will click the Perusall link you created in Moodle Instructor Set Up, and Perusall will pass their average or total scores back to Moodle as you release assignment scores in Perusall.

• Our LTI 1.3 integration gives instructors the opportunity to manage how gradebook columns in your LMS are created. Instructors can allow Perusall to automatically create LMS gradebook columns for each Perusall assignment, or they can manually create deep links to individual assignments in the LMS.  Released scores can then be sent back to your LMS.

  • If you select to sync students’ individual assignment scores, by default, each time you create an assignment in your Perusall course, a corresponding grade item will automatically be created in your LMS gradebook.  As a result, student scores that have been released in the Perusall gradebook will automatically sync (unless using manual sync). Follow the step below to set this up:

    • Launch into your Perusall course: Click Settings > Scoring > LMS grade sync:
    • Set Grade sync to LMS to Automatically sync individual assignments scores back to the LMS
    • Set LMS gradebook column management to Perusall creates gradebook columns in LMS for each Perusall assignment automatically.
      
    • Click Save.
      

    Students will click the Perusall link you created in Moodle Instructor Set Up, and Perusall will pass their individual assignment scores back to Moodle as you release assignment scores in Perusall.

  • If you would like to create deep links to each individual assignment, Perusall will not automatically create the gradebook columns. Follow the steps below to set up deep links:

    • Launch into your Perusall course: Click Settings > Scoring > LMS grade sync:
    • Set Grade sync to LMS to Automatically sync individual assignments scores back to the LMS
    • Set LMS gradebook column management to Instructor creates deep links in LMS; no Perusall gradebook columns will appear in LMS until deep links have been created.
    • Click Save.
    • Return to your Moodle course, and you can create deep links.

Creating Deep Links in your Moodle Course

Moodle’s LTI 1.3 integration does not support the LTI 1.3 launch workflow that avoids cookies. This can cause issues when Perusall is opened in an iframe in browsers that block third-party cookies, particularly during the deep link content selection process. To avoid this, instructors using Moodle should either enable third-party cookies or use a browser like Firefox that allows them. Moodle has been aware of this issue, and it does not appear to be in progress..

1. Create your assignments in Perusall first.
2. In your Moodle course, enter edit mode, and add an activity or resource > Perusall 1.3 > select content.
3. In the next screen, select Perusall. A window will pop up that will allow you to select a Perusall assignment to link.
   1. Under Assignments, click on the dropdown to select an assignment.
   2. Ensure that Import grading information to LMS is enabled, and click Link to this assignment.
4. Under Grade, ensure that the Maximum grade is correct.
5. Click Save and display, and then click Open in a new window to open the deep link, taking you directly into the Perusall assignment.

If you do not see Perusall 1.3 in the Activity Chooser, select External tool.  On the next page, enter "Perusall" (or anything else) for the activity name and select Perusall from the Preconfigured tool dropdown.  Click Save and display, and launch Perusall to create your Moodle-linked Perusall course.

Please whitelist messages coming from @perusall.com and @mg.perusall.com to ensure users are able to receive our emails.