Moodle Integration
This guide shows you how to configure a Criterial LTI tool in Moodle.
Prerequisites
- Teacher or Administrator role in the course
- Moodle 3.9+ (for LTI 1.3) or Moodle 2.2+ (for LTI 1.1)
- An app created in Criterial
Option A: As a course activity (recommended)
Step 1: Add activity
- Enable editing mode in your course
- Click Add an activity or resource
- Select External tool
Step 2: Configure the tool
| Field | Value |
|---|---|
| Activity name | The name students will see |
| Tool URL | https://lti.criterial.cc/lti/launch/YOUR-APP-ID |
| Launch type | Open in new window (recommended) |
Step 3: Privacy settings
Under Privacy:
- ☑ Share launcher's name with the tool
- ☑ Share launcher's email
- ☑ Accept grades from the tool
Step 4: Save and test
- Click Save and display
- The tool will open — verify it loads correctly
- Complete a test and verify the grade appears in the gradebook
Option B: Site-level configuration (Administrator)
For LTI 1.3:
- Go to Site administration → Plugins → External tools → Manage tools
- Click Configure a tool manually
- Fill in:
| Field | Value |
|---|---|
| Name | Criterial LTI |
| Tool URL | https://lti.criterial.cc/lti/launch13 |
| LTI Version | LTI 1.3 |
| Public key type | Keyset URL |
| Keyset URL | https://lti.criterial.cc/api/auth/jwks |
| Login URL | https://lti.criterial.cc/lti/login |
| Redirect URL | https://lti.criterial.cc/lti/launch13 |
- Under Services: enable IMS LTI Assignment and Grade Services
- Under Privacy: enable sharing name and email
- Save — Moodle will generate a Client ID and Platform ID
- Send these IDs to your Criterial admin to complete registration
Custom parameters
To launch a specific app, add in Custom parameters:
app_id=YOUR-APP-UUID
Troubleshooting
- "This tool is not configured": Admin needs to register the tool at site level
- Grades not appearing: Verify the activity has "Accept grades" enabled
- Blank screen: Verify the browser allows third-party cookies (needed for iframes)