====== Open Badges ======

===== Overview =====

LEAST supports **IMS Global Open Badges v2.0** — digitally verifiable credentials that learners can add to LinkedIn, email signatures, or CVs. Badges are cryptographically signed and publicly verifiable via a hosted assertion endpoint.

===== Badge Anatomy =====

Every badge has:
  * **Name and description** — what the badge represents
  * **Criteria** — what the earner did to earn it
  * **Image** — the badge artwork (PNG, 512x512 recommended)
  * **Issuer** — the organisation issuing the badge

===== Creating a Badge Class =====

  - Navigate to **Admin → Badges → New Badge**
  - Enter name, description, and criteria text
  - Upload badge image
  - Set the issuer organisation
  - Save — the badge class is now available for issuance

===== Issuing Badges =====

==== 1. Manual Issuance ====

  - Navigate to **Admin → Badges → Issue Badge**
  - Select the badge class and the learner
  - Add an optional note
  - Click Issue

==== 2. Automatic Trigger — Quiz Pass ====

Set a badge to auto-issue when a learner passes a specific quiz:

  - Open the badge class → **Triggers**
  - Add a **Quiz Pass** trigger
  - Select the quiz
  - Set the pass threshold (e.g. 80%)
  - Save — LEAST issues the badge automatically when any learner passes

==== 3. Batch Issuance ====

Issue a badge to multiple learners at once:

  - Navigate to **Admin → Badges → Batch Issue**
  - Select a badge class
  - Upload a CSV of learner email addresses or select a cohort
  - Preview and confirm

===== Email Notification =====

When a badge is issued, the learner automatically receives an email containing:

  * Badge name and description
  * Criteria met
  * Link to the public badge assertion (verifiable by third parties)
  * Instructions for adding to LinkedIn

===== xAPI Statement on Badge Issue =====

When a badge is issued, LEAST dispatches an xAPI statement to your configured LRS:

  * **Verb:** ''earned''
  * **Object:** the badge class IRI
  * **Result:** includes the badge assertion URL

Configure your LRS endpoint at **Admin → xAPI Settings**.

===== Public Verification =====

Each badge assertion is publicly verifiable at:
''/openbadge/assertion.php?id={assertionId}''

The assertion JSON follows Open Badges v2.0 and can be verified by Credly, Badgr, LinkedIn, and any OBv2-compatible platform.

===== Revoking a Badge =====

  - Navigate to **Admin → Badges → Issued Badges**
  - Find the learner and badge
  - Click **Revoke** and provide a reason
  - The assertion is marked as revoked — verification endpoints return revocation status

===== Badge Display =====

Earned badges appear on:
  * The learner's public profile page
  * The learner's "My Badges" dashboard panel
  * The organisation's member roster (with badge count)