Moodle LMS Integration

Integrate Qriib Virtual Classrooms seamlessly into your Moodle Learning Management System using the LTI 1.3 Advantage protocol. This integration enables automatic student roster synchronization (NRPS), single sign-on (SSO), Deep Linking activity creation, and full lecture lifecycle control — all directly inside Moodle.

Key Capabilities

Step 1: Obtain Qriib Outbound Credentials

1. Log in to your Qriib DevKit Portal.
2. Navigate to LMS Integration from the sidebar.
3. Locate the Qriib Outbound Credentials section and copy the three URLs dynamically generated for your environment:

Keep this tab open — you will paste these into Moodle in the next step.

Step 2: Configure External Tool in Moodle (Phase 1)

1. Log in to Moodle as a Site Administrator.
2. Navigate to: Site Administration → Plugins → Manage tools.
3. Click Configure a tool manually.

4. Fill in the configuration form with the following values:

5. Expand Services and Privacy sections and set:

6. Click Save Changes.

Optional: Set Your Institution's Workspace Logo

To display your institution's logo in the Qriib workspace header, add a custom parameter to the external tool. This requires a Qriib environment with client-logo support deployed on both the backend and frontend.

1. Go to Site administration > Plugins > Activity modules > External tool > Manage tools. Navigation labels may vary by Moodle version.
2. Find your Qriib Virtual Classrooms tool and open its edit/settings form.
3. Find Custom parameters, expanding Show more if necessary.
4. Add the following on a separate line, preserving any existing parameters:

logo_url=https://your-university.edu/assets/logo.png

5. Click Save Changes.
6. Close the existing workspace and launch the activity again from your course. Refreshing an existing workspace keeps the logo from that session's original launch.

Use a direct image URL, not a webpage containing an image. For example, a Wikipedia /wiki/ file page returns HTML and cannot be displayed as the logo. Open Original file on that page to obtain the direct image URL instead.

The image must be publicly accessible over HTTPS, without login or authorization headers. Open it in a private browser window to check that it loads. Use a stable URL without temporary access tokens; PNG, JPEG, WebP, and SVG images are suitable. The header preserves aspect ratio within a 96px-wide by 32px-high area.

Icon URL and Secure icon URL change the icon displayed inside Moodle. They do not automatically set the Qriib workspace logo; use the explicit logo_url custom parameter above.

If the logo is missing, invalid, or fails to load, the workspace displays a neutral school icon and remains usable. The external image host receives the browser's image request and network metadata; the workspace sends no referrer or LTI authorization header.

Troubleshooting the Logo

In browser Developer Tools, open Network and inspect the authenticated /lti/v1/workspace response. Check only its branding object; do not share authorization tokens or launch JWTs.

Step 3: Register Moodle Credentials in Qriib (Phase 2)

After saving, Moodle generates platform credentials you must register back into Qriib:

1. In Moodle Manage Tools, find your Qriib Virtual Classrooms tool card.
2. Click View Tool Details.
3. Copy the following parameters:

4. Return to Qriib DevKit Portal → LMS Integration.
5. Paste the values into the LMS Inbound Configuration form.
6. Click Register LMS Integration.

Step 4: Add Virtual Classrooms to Courses (Instructor Workflow)

Instructors add Virtual Classrooms directly inside their respective Moodle courses (not in Site Administration):

1. Go to My courses from the Moodle navigation bar and open your course (e.g., CS501 Computer Science).
2. Toggle Edit mode ON in the top-right corner of the course page.
3. Click Create course (or select an existing course).
4. Click Participants in the course menu and click Enrol users.
5. Select users, set Assign role to Teacher (or Student), and click Enrol users.
6. Click More in the course top navigation bar.
7. Select LTI External Tools.
8. Find Qriib Virtual Classrooms and toggle Show in activity chooser to ON (active).
9. Return to your course section, click + Add an activity or resource, and select Qriib Virtual Classrooms.
10. Provide an Activity Name (e.g., CS501 Live Lecture).
11. Expand the Privacy section and ensure Accept grades from the tool is checked.
12. Expand the Grade section and set Type to Point and Maximum Grade to your desired value (e.g., 100).
13. Click Save and return to course. When students or instructors click the link, a Deep Linking confirmation page is shown inside Moodle, then the Virtual Classroom workspace launches:

Workspace Roles & Capabilities

The workspace renders differently based on the user's LTI role:

Instructor View

When launched by an Admin or Instructor (Teacher), the workspace allows them to create and start a meeting immediately via the Create Quick Meeting button:

Learner (Student) View