meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

admin:badges [2026/05/18 06:19] – Initial content claudeadmin:badges [2026/06/02 06:46] (current) – Update: auto-trigger on quiz pass, xAPI dispatch, email notification, batch issuance, revocation claude
Line 3: Line 3:
 ===== Overview ===== ===== Overview =====
  
-LEAST supports **IMS Global Open Badges v2.0** — digitally verifiable credentials that learners can add to their LinkedIn profile, email signature, or CV. Badges are cryptographically signed and publicly verifiable.+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 ===== ===== Badge Anatomy =====
Line 10: Line 10:
   * **Name and description** — what the badge represents   * **Name and description** — what the badge represents
   * **Criteria** — what the earner did to earn it   * **Criteria** — what the earner did to earn it
-  * **Image** — the badge artwork (PNG, 512×512 recommended)+  * **Image** — the badge artwork (PNG, 512x512 recommended)
   * **Issuer** — the organisation issuing the badge   * **Issuer** — the organisation issuing the badge
  
Line 16: Line 16:
  
   - Navigate to **Admin → Badges → New Badge**   - Navigate to **Admin → Badges → New Badge**
-  - Enter name, description, and criteria+  - Enter name, description, and criteria text
   - Upload badge image   - Upload badge image
   - Set the issuer organisation   - Set the issuer organisation
Line 23: Line 23:
 ===== Issuing Badges ===== ===== Issuing Badges =====
  
-Badges can be issued in three ways:+==== 1. Manual Issuance ====
  
-**Manually:** +  - Navigate to **Admin → Badges → Issue Badge** 
-  - Navigate to **Admin → Badges → Issue** +  - Select the badge class and the learner 
-  - Select the badge class and enter the recipient's email +  - Add an optional note 
-  - LEAST creates a signed assertion and emails the recipient+  - Click Issue
  
-**In bulk:** +==== 2. Automatic Trigger — Quiz Pass ====
-  - Prepare a list of email addresses +
-  - Navigate to **Admin → Badges → Bulk Issue** +
-  - Upload the list — LEAST issues to all valid emails+
  
-**Automatically (via cron):** +Set a badge to auto-issue when a learner passes a specific quiz:
-  - Configure automatic issuance rules on a badge class +
-  - LEAST's daily cron job checks eligibility and issues badges automatically+
  
-===== xAPI Integration =====+  - 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
  
-When a badge is issued, LEAST dispatches an **xAPI statement** (verb: ''earned'') to the configured Learning Record Store (LRS). This enables badge issuance to appear in learner activity streams and LRS dashboards.+==== 3. Batch Issuance ====
  
-===== Verification =====+Issue a badge to multiple learners at once:
  
-Each badge assertion has a unique public URL. Anyone can verify a badge by opening the assertion URL — LEAST returns a JSON-LD document confirming the earner, criteria, and issuer. Badge wallets (Badgr, Open Badge Passport) can import assertions via this URL.+  - 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 ===== ===== Revoking a Badge =====
  
   - Navigate to **Admin → Badges → Issued Badges**   - Navigate to **Admin → Badges → Issued Badges**
-  - Find the assertion and click **Revoke** +  - Find the learner and badge 
-  - The assertion is marked revoked; verification checks return revoked status +  - Click **Revoke** and provide a reason 
-  - The earner is not automatically notified — notify them manually if appropriate+  - 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)