Feature Wiki
Tabs
Adaptive Learning Paths: Learning Map
Page Overview
[Hide]- 1 Initial Problem
- 2 Conceptual Summary
- 3 User Interface Modifications
- 4 Additional Information
- 4.1 Involved Authorities
- 4.2 Technical Aspects
- 4.3 Privacy
- 4.4 Security
- 4.5 Contact
- 4.6 Funding
- 5 Discussion
- 6 Implementation
- 6.1 Description and Screenshots
- 6.2 Test Cases
- 6.3 Privacy
- 6.4 Approval
1 Initial Problem
Adaptive Learning Paths are difficult to understand if learners and teachers only see a linear list. Especially with branching paths, it is important to be able to understand relationships between objects, the current position, completed objects and possible next steps visually.
The previous Curriculum page element is no longer sufficient for this display. It is replaced by a Learning Map.
2 Conceptual Summary
The Learning Map visualizes the structure of a Learning Sequence as a map. It shows objects as nodes and relationships or possible paths as connections. Depending on mode and data situation, it can display complete routes, paths already taken or reachable areas.
Important: The migration replaces existing Curriculum elements on intro and extro pages of Learning Sequences with the new Learning Map element. This keeps existing pages functional in the same place, but they will use the new map in the future.
The Learning Map is important for adaptive paths because it makes more complex navigation visible. It should help users understand paths not only as tables, but also as a structure.
3 User Interface Modifications
3.1 List of Affected Views
- Learning Sequence intro page content
- Learning Sequence extro page content
- Page editor content elements for Learning Sequence pages
3.2 User Interface Details
The Learning Map is rendered as a content element. If no data is available, an informative message is displayed. If data is available, the map is shown in a panel.

Objects are displayed as nodes. Connections show the direction or relationship between objects. Status information is displayed textually and visually, for example for completed objects.

For the migration:
- Existing Curriculum elements on LSO intro and LSO extro pages are replaced.
- The new element is inserted at the same position.
- Other page types are not changed.
Below is the old intro page:

3.3 New User Interface Concepts
The Learning Map introduces a graphical path overview. It combines object information, learning path structure and status information in a map. Existing ILIAS page areas and UI components continue to be used.
3.4 Accessibility Implications
Accessibility is especially important for the Learning Map because graphical maps can quickly convey information only visually. The implementation must therefore ensure that:
- nodes have understandable labels,
- status information is not conveyed exclusively through color,
- icons and glyphs have meaningful alternatives or textual additions,
- contrasts are inherited from the skin,
- the map remains understandable even with limited perception.
For testing, it is relevant that the Learning Map has its own accessibility tests and that colors and states are not explained exclusively through visual markings.
4 Additional Information
4.1 Involved Authorities
- Authority to Sign off on Conceptual Changes: Großkopf, Katrin [katrin.grosskopf]
- Authority to Sign off Code Changes: Großkopf, Katrin [katrin.grosskopf], Auerbach, Jeanine [jeanine.auerbach], Clausen, Keven [keven.clausen]
4.2 Technical Aspects
The Learning Map consists of data preparation and rendering. The Data Builder creates a map structure with nodes and connections from navigator, position, objects and selected view mode. The Renderer creates the HTML output from this and includes CSS and JavaScript of the Learning Sequence.
For the migration, there is a setup step that searches for Curriculum elements in page_object on LSO intro and LSO extro pages and replaces them with LearningMap. Rendered content is invalidated so that the page is rebuilt.
4.3 Privacy
The Learning Map can display learner-specific states such as current position or completed objects. No new categories of personal data are introduced.
4.4 Security
No special security-relevant changes. The map works with existing Learning Sequence objects, references and navigation data.
4.5 Contact
Person to be contacted in case of questions about the feature or for funding offers: Auerbach, Jeanine [jeanine.auerbach]
4.6 Funding
Funding status and funding parties are listed in the block 'Status of Feature' in the right column of this page.
If you are interested to give funding for this feature, please get into contact with the person mentioned above as 'Contact'.
5 Discussion
6 Implementation
Feature has been implemented by {Please add related profile link of this person}
6.1 Description and Screenshots
{ Description of the final implementation and screenshots if possible. }
6.2 Test Cases
Test cases completed at {date} by {user}
- {Test case number linked to Testrail} : {test case title}
6.3 Privacy
Information in privacy.md of component: updated at {date} by {user} | no change required
6.4 Approval
Approved at {date} by {user}.
Last edited: Yesterday, 08:14, Auerbach, Jeanine [jeanine.auerbach]