Moodle Integration

VivaEdu integrates with Moodle using LTI 1.3, with optional plugin support for enhanced features.

Integration Features

Core LTI 1.3 Features

• Single sign-on from Moodle courses
• Automatic user and course provisioning
• Secure authentication
• Grade passback to Moodle gradebook
• Deep linking support

Enhanced Moodle Features

• Activity Creation: Create LTI External Tool activities with due dates
• Calendar Integration: Due dates appear on Moodle timeline/calendar
• Message Notifications: Students receive Moodle messages when vivas are published
• Assignment Integration: Link vivas to Moodle Assignment (mod_assign) submissions

Initial Setup

Step 1: Register VivaEdu in Moodle (Administrator)

1. Log into Moodle as administrator
2. Navigate to Site administration → Plugins → Activity modules → External tool → Manage tools
3. Click "Configure a tool manually"
4. Enter VivaEdu configuration:
   • Tool name: VivaEdu
   • Tool URL: Your VivaEdu instance + /lti/launch
   • LTI version: LTI 1.3
   • Public key type: Keyset URL
   • Public keyset: Provided by VivaEdu
   • Initiate login URL: Provided by VivaEdu
   • Redirection URI(s): Provided by VivaEdu
5. Enable Services:
   • IMS LTI Names and Role Provisioning
   • IMS LTI Assignment and Grade Services
   • Tool Settings
6. Set Privacy:
   • Share launcher's name with tool: Always
   • Share launcher's email with tool: Always
7. Save changes

Step 2: Optional Moodle Plugins

VivaEdu provides optional Moodle plugins for enhanced features:

• assignfeedback_vivaedu: Assignment feedback plugin
  • Adds "Assign VivaEdu Verification" button in grading interface
  • Quick access to verification workflow
  • Inline decision panel
• local_vivaedu: Helper plugin
  • Admin settings for VivaEdu configuration
  • Automatic activity creation helper
  • Secure callback endpoint

Step 3: Add VivaEdu to a Course (Instructor)

1. Enter your Moodle course
2. Turn editing on
3. Click "Add an activity or resource"
4. Select "External tool"
5. Choose "VivaEdu" from preconfigured tools dropdown
6. Name it (e.g., "VivaEdu Oral Assessments")
7. Set availability and completion settings
8. Save and display
9. Link appears in your course

Creating Vivas with Moodle Integration

Auto-Create Moodle Activity

When you publish a viva:

• VivaEdu creates a new External Tool activity in Moodle
• Title includes viva name and due date
• Due date set so it appears on Moodle timeline/calendar
• Students see it in course feed and calendar
• Message notification sent to all students

Link to Moodle Assignment

Connect viva to existing Moodle Assignment:

• Useful for sequential workflow (essay submission → viva Q&A)
• Viva unlocks when student submits Moodle assignment
• Both grades tracked separately

Grade Passback to Moodle

How It Works

1. Review and grade student viva in VivaEdu
2. Click "Push Grade to Moodle" (individual or batch)
3. VivaEdu uses AGS to send grade
4. Moodle gradebook updates automatically
5. Student sees grade in Moodle

Grade Format

• Rubric total score out of max points
• Percentage calculated by Moodle
• Text feedback included in Moodle feedback area
• Video feedback links (not embedded directly)

Moodle Calendar Integration

Viva due dates appear in:

• Moodle course calendar
• Student's personal Moodle timeline
• Course page upcoming events
• Helps students track deadlines

Anonymous Marking (Verification Mode)

For verification vivas (post-grading oral assessments):

• Per-student deep links can be created
• Only visible to assigned student
• Instructor doesn't see student identity until verification complete
• Supports anonymous marking workflows

Best Practices