Feature Wiki
Tabs
Rating Box for Learning Sequence Player
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
The rating system in ILIAS allows learners to rate objects (e.g., files, learning modules, wiki content, depending on the specific object type). These ratings provide instructors with direct feedback on the quality and relevance of learning materials.
Previously, the Learning Sequence Player (kiosk/player view) lacked a way to directly rate the currently open learning sequence object.
2 Conceptual Summary
A rating widget is displayed in the header of the Learning Sequence Player, below the object description. The widget is rendered only for objects where rating is supported and enabled in the ILIAS core:
A) Technical support in the core: The object type supports rating in principle.
B) Activation in object settings: Rating is enabled for this specific object (in accordance with core logic/object settings).
The rating process itself utilizes the existing ILIAS rating workflow** (including saving via asynchronous request, display updates, and the "Remove Rating" option) without introducing a new functional concept.
3 User Interface Modifications
3.1 List of Affected Views
- learning sequence → Content → View → Start Learning Sequence (Player/Kiosk view)
3.2 User Interface Details
- Position: Player header area, directly below the object description and above the navigation/exit buttons.
- Display: Rating widget featuring the familiar ILIAS look and feel.
- Interaction:
- Clicking the rating display opens the popover ("Your Rating").
- Assigning or changing the star rating within the popover.
- Optional: "Remove Rating" to delete the rating.
- After saving or removing, the display updates without requiring a page reload.
3.3 New User Interface Concepts
No new UI concepts.
The standard rating component from the ILIAS core is used (popover + stars). The Learning Sequence integrates the widget into the player header structure and ensures that the standard behavior works in the kiosk layout as well.
3.4 Accessibility Implications
No new accessibility concepts or additional barriers.
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], Clausen, Keven [keven.clausen], Auerbach, Jeanine [jeanine.auerbach]
4.2 Technical Aspects
- The rating is rendered specifically for the object currently displayed in the player.
- It is displayed only if the rating is recognized as available/active for the object within the Core.
- Saving occurs asynchronously (standard mechanism of the rating component).
- After saving or removing, the rating display in the player is updated without exiting the player.
- The implementation follows the Core pattern (rating popover and "Remove Rating" based on Core templates/JS), adapted for the player/kiosk context.
4.3 Privacy
No additional personal data is collected or transferred to third parties. The existing ILIAS rating rules apply.
4.4 Security
No new endpoints with elevated privileges are being introduced; the existing rating workflow is being used.
4.5 Contact
Person to be contacted in case of questions about the feature or for funding offers: Auerbach, Jeanine [jeanine.auerbach], Clausen, Keven [keven.clausen]
4.6 Funding
Funding status and funding parties are listed in the block 'Status of Feature' in the right column of this page.
The implementation is funded by the Advisory Board‘s budget.
5 Discussion
Kunkel, Matthias [mkunkel], 09 JUL 2026: Two questions to the suggested feature:
The presentation of the rating on the screenshot above is different from the current presentation of ratings in the file object (which is used as example), see following screenshot.
Is this because of the mockup? Or are you planning to place the rating under the description text?
Will the rating be stored with the embeded object (in this case the file object) and kept once the file is moved out of the learning sequence into another context? Or will it be no longer available for the file because the rating information is stored in the learning sequence?
JourFixe, ILIAS [jourfixe], 13 JUL 2026: We highly appreciate this suggestion and schedule the feature for trunk. The position of the rating box should be at the known place on the right side (as shown on the screenshot above made by Matthias). And the rating information is kept by the rated object and won't get lost when moving a rated object outside a LSO. Please consider to use the tpl.adm_content.html instead of the kiosk mode template if possible – but at least when refactoring the current LSO player in the next step. This will allow us to get rid of a specific template and to reduce unwanted side-effects when doing CSS changes in ILIAS.
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
Expanding the test cases is recommended for evaluating objects in the Learning Sequence Player:
1. Object without rating support
- Open player → no rating widget visible.
2. Object with rating support, but disabled
- Disable rating in object settings → player does not display a widget.
3. Set/change rating
- Click stars in the popover → display updates immediately.
4. Remove rating
- "Remove Rating" → display updates immediately.
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: 13. Jul 2026, 14:37, Kunkel, Matthias [mkunkel]