Back to site
Home · Resources · Setup Guide
Documentation

Moodle & Totara Setup Guide

Install the LogicStream plugin, connect your account, and add your first video activity — typically in well under an afternoon.

Native plugin · not embed code Moodle 4.0+ / Totara 17+ ~5-minute install

Overview

LogicStream connects to your LMS through a native plugin — not an embed code or iframe. The difference matters: a native activity respects your course structure, enforces completion rules, and writes grades back to your gradebook automatically. Embed codes can't do any of that. Once installed, every video in your LogicStream library is available to add as a first-class course activity.

Prerequisites

Before you begin

  • A LogicStream account (Starter tier or above)
  • Moodle 4.0+ or Totara 17+
  • Admin access to your LMS
  • Your LogicStream API key (generated in portal → Settings → API)

1 · Installing the Moodle plugin

  1. Download the LogicStream plugin from the Moodle Plugin Directory or your direct download URL.
  2. In Moodle, go to Site administration → Plugins → Install plugins.
  3. Upload the .zip file.
  4. Click Install plugin from the ZIP file.
  5. Complete the installation wizard.
  6. Navigate to Site administration → Plugins → Activity modules → LogicStream Video.
  7. Enter your LogicStream API key.
  8. Save changes.
Site administration › Plugins › LogicStream Video
LogicStream API Key
ls_live_••••••••••••••8f2aVerified ✓
Default storage region
Europe — Ireland (eu-west-1)
Enable anti-skip globally
Real-time webhook sync
Save changes
MOODLE PLUGIN SETTINGS PAGE

2 · Installing the Totara plugin

The Totara installation follows the same structure as Moodle, using Totara-specific administration paths. Because Totara is built on the Moodle codebase, the plugin behaves identically once connected.

  1. Download the LogicStream plugin package for Totara.
  2. Go to Site administration → Plugins → Install plugins and upload the .zip.
  3. Complete the installation wizard and enable the LogicStream Video activity module.
  4. Enter your LogicStream API key and save.
Totara › Plugins › LogicStream Video
LogicStream API Key
ls_live_••••••••••••••3c7d
Connection statusConnected
Library sync1,248 videos
Multi-tenancy support
Save changes
TOTARA PLUGIN SETTINGS PAGE

3 · Configuring SSO (optional)

LogicStream supports single sign-on for your team portal on Business and above.

  • SAML 2.0 setup — register LogicStream as a service provider and map identity attributes.
  • OIDC setup — configure OpenID Connect client credentials and redirect URIs.
  • Auto-provisioning rules — automatically create and assign team members based on directory groups.

4 · Adding a video to a course

  1. In your course, click Turn editing on.
  2. Click Add an activity or resource.
  3. Select LogicStream Video.
  4. Choose a video from your LogicStream library or upload a new one.
  5. Configure completion criteria: view duration (e.g. "watch 80%"), anti-skip enforcement (yes/no), and an optional quiz at the end.
  6. Save and return to course.
Add an activity › LogicStream Video
Selected video
Compliance_Induction_2026.mp4
12:40 · 1080p · transcribed
Completion — learner must watch
80% of total duration
Anti-skip enforcement
Quiz at end
Save and return to course
ACTIVITY CONFIGURATION

5 · Completion tracking & gradebook

  • How completion conditions map to Moodle/Totara grades.
  • Real-time sync vs scheduled sync.
  • Troubleshooting partial completions.

6 · Engagement analytics

  • Where to find learner analytics in the LogicStream portal.
  • Interpreting the 100-segment engagement heatmap.
  • Exporting reports (CSV, JSON, API).

7 · Troubleshooting

SymptomResolution
Plugin not appearing in activity listPermission fix — verify the activity module is enabled and roles allow it.
Videos not loadingCheck CloudFront signed-URL configuration.
Completion not syncingInspect the webhook log for delivery failures.
API key rotationFollow the key rotation procedure in portal → Settings → API.

8 · API & webhooks reference

LogicStream exposes a full REST API and webhook system for automated uploads, metadata management, analytics retrieval, and CI/CD integration. See the full API documentation →

Need a hand?

Our team has been deploying Moodle and Totara since 2005. Email support@human-logic.com and we'll help.

Contact Support