====== Learning Materials ======

===== What is a Material? =====

A **Material** is a link to a piece of content attached to a lesson. LEAST does not host files — it links to content on external platforms. Each material has a URL, a type, and optional metadata.

===== Material Types =====

^ Type ^ Description ^ Example sources ^
| Video | Embedded video player | YouTube, Vimeo, Wistia |
| Article | External web page or PDF | Websites, Google Docs |
| SCORM | SCORM 1.2 / 2004 package | SCORM-compliant authoring tools |
| xAPI | xAPI / Tin Can activity | xAPI-enabled content |
| cmi5 | cmi5 AU (Assignable Unit) | cmi5 packages |
| Document | Downloadable file link | Google Drive, OneDrive |
| Interactive | Embedded interactive activity | H5P, Genially |

===== Adding a Material =====

  - Open a lesson → **Materials → Add Material**
  - Enter the URL (YouTube links are auto-detected and the player is embedded)
  - Select the material type
  - Enter a title and optional description
  - Set estimated duration
  - Save

===== iFrame Auto-Detection =====

When you save a material with a URL from a known embeddable platform (YouTube, Vimeo), LEAST automatically sets the display mode to embedded player. Other URLs default to an external link.

===== SCORM / xAPI Tracking =====

For SCORM and xAPI materials, LEAST registers completion and score:
  * Completion is recorded when the package returns ''completed'' or ''passed'' status
  * Scores are stored and visible in the educator analytics panel
  * xAPI statements are dispatched to your configured LRS (if set up)

See [[developer:xapi|xAPI & SCORM]] for technical details.

===== Dead Material Replacement =====

When a content URL becomes invalid (404, removed video), you can replace it:
  - Open the material → **Replace URL**
  - Enter the new URL
  - The replacement is logged for audit purposes
  - The **Dead Material** workflow tool can scan your materials for broken links and queue replacements