meta data for this page
  •  

Differences

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

Link to this comparison view

educator:keyring [2026/05/18 06:19] – Initial content claudeeducator:keyring [2026/06/02 06:46] (current) – Update: all 27 display modes documented (was 8) claude
Line 3: Line 3:
 ===== What is a KeyRing? ===== ===== What is a KeyRing? =====
  
-A **KeyRing** is a curated collection of links — lessons, materials, external URLs, badges — presented to learners in a specific visual layout. KeyRings are used for resource libraries, quick-reference hubs, and featured content areas.+A **KeyRing** is a curated collection of links — lessons, materials, external URLs, badges — presented to learners in a specific visual layout. KeyRings are used for resource libraries, quick-reference hubs, featured content areas, interactive games, and learning maps.
  
 ===== Creating a KeyRing ===== ===== Creating a KeyRing =====
  
   - Navigate to your class or organisation → **KeyRing → New KeyRing**   - Navigate to your class or organisation → **KeyRing → New KeyRing**
-  - Enter a name and description +  - Enter a name, description, and choose a display mode 
-  - Add items (lessons, materials, external links)+  - Add items (lessons, materials, external links, badges) 
 +  - Save and publish to learners
  
-===== Display Modes ===== +===== Display Modes (27 available) =====
- +
-KeyRings support multiple display layouts to suit different content types and screen sizes:+
  
 ^ Mode ^ Layout ^ Best for ^ ^ Mode ^ Layout ^ Best for ^
-| Grid | Card grid with thumbnails | Image-heavy resource libraries | +| **Circle** | Items arranged in a circular ring | Small curated sets, visual navigation hubs | 
-| List | Vertical list with descriptions | Long text-based resources | +| **List** | Vertical list with title and description | Long text-based resource sets | 
-| Carousel | Horizontal scroll with featured image | Featured content, highlights | +| **ImageMap** | Clickable regions on a background image | Geography, anatomy, labelled diagrams | 
-| Tiles | Large tiles with icons | Navigation hubs | +| **LCARS** | Star Trek-style panel interface | Tech / sci-fi themed content | 
-| Compact | Dense list, no images | Reference documents, quick links | +| **Swiper** | Full-screen swipe cards | Mobile-first flashcard-style browsing | 
-| Table | Tabular layout with metadata columns | Structured data, reports | +| **ShowCase** | Spotlight card with thumbnail grid | Featured content, portfolios | 
-| Mosaic | Variable-size card grid | Mixed media content | +| **Bookshelf** | Spine-on-shelf book layout | Reading lists, course textbooks | 
-| Spotlight | Single featured item, full-width | Featured lesson of the week | +| **HexTall** | Tall hexagon grid | STEM topics, visual classification | 
-| Timeline | Chronological sequence | Learning journeys, dated content | +| **HexWide** | Wide hexagon grid | Large taxonomies, skill maps | 
-| Accordion | Expandable sections | FAQ, grouped content | +| **Boxed** | Square card grid with borders | Even-weight resource libraries | 
-| Kanban | Status-based column view | Progress tracking | +| **Carousel** | Horizontal auto-scrolling strip | Featured highlights, recent additions | 
-| Map | Geolocation pins (where supported) | Location-based content | +| **Pitch** | Sports pitch with positioned players | Tactical analysis, team roles | 
-| Comparison | Side-by-side item comparison | Multiple options |+| **BlankCanvas** | Free-position drag layout | Custom visual arrangements | 
 +| **LogicList** | Stepped list with branching logic | Decision trees, troubleshooting guides | 
 +| **LeadingQuestions** | Question-first reveal layout | Socratic method, inquiry-based learning | 
 +| **GoogleMap** | Embedded map with pinned items | Geography, field trips, local resources | 
 +| **Tiles** | Large icon tiles with labels | Navigation hubs, landing pages | 
 +| **SpinWheel** | Spinning prize-wheel selector | Random topic selection, gamified review | 
 +| **BubbleCloud** | Tag-cloud of linked bubbles | Topic exploration, keyword discovery | 
 +| **Timeline** | Horizontal or vertical timeline | History, project phases, biographies | 
 +| **SubwayMap** | Tube-map style connected nodes | Learning pathways, curriculum maps | 
 +| **FamilyTree** | Branching tree structure | Taxonomy, hierarchical relationships | 
 +| **MemoryGame** | Flip-card memory matching game | Vocabulary and terminology practice | 
 +| **MindMap** | Radial mind-map layout | Brainstorming, concept mapping | 
 +| **PageSwiper** | Full-page swipe with rich content | Long-form lesson walkthroughs | 
 +| **MasonryTiles** | Pinterest-style variable-height grid | Mixed media, visual content libraries | 
 +| **ConstellationMap** | Star-pattern connected nodes | Abstract concept networks | 
 + 
 +===== Choosing a Mode ===== 
 + 
 +  * **For learner navigation:** Tiles, Circle, Boxed 
 +  * **For reading lists:** Bookshelf, List 
 +  * **For gamification:** MemoryGame, SpinWheel 
 +  * **For pathways:** SubwayMap, Timeline, MindMap 
 +  * **For featured content:** ShowCase, Carousel, Swiper 
 +  * **For interactive diagrams:** ImageMap, GoogleMap, BlankCanvas, Pitch 
 +  * **For exploration:** BubbleCloud, ConstellationMap 
 + 
 +===== KeyRing Items ===== 
 + 
 +Each item can link to: 
 + 
 +  * A lesson (''lesson.php?ref=...'') 
 +  * A material (''material.php?ref=...'') 
 +  * An external URL 
 +  * Another KeyRing (nested) 
 +  * A badge award page
  
-===== Switching Display Mode =====+===== SpinWheel Mode =====
  
-  - Open the KeyRing → **Settings → Display Mode** +Learners or educators spin a wheel and randomly land on a lesson or topic. Useful for random review sessions, "lesson of the day" features, and ice-breaker activities.
-  - Select the mode from the dropdown +
-  - Preview updates immediately +
-  - Save to apply+
  
-===== Embedding a KeyRing =====+===== MemoryGame Mode =====
  
-KeyRings can be embedded in course pages and workflow canvas nodes: +KeyRing items are presented as face-down cards. Learners flip pairs to match lesson titles with images or descriptions. Useful for vocabulary review, term-definition matching, and revision activities.
-  - Copy the KeyRing embed code from **KeyRing → Share** +
-  - Paste into the target page's embed field+
  
-===== Updating Links =====+===== Analytics =====
  
-When a linked lesson or material changes, the KeyRing automatically reflects the updated title and description. For external URLs, the link is stored as-is — update it manually if the external resource moves.+KeyRing link clicks are tracked in the Audit log when learners navigate from a KeyRing to a lesson. Dedicated click analytics are planned (D5: P14-F4).