Rating box + UI/UX improvements in the LearningSequence (LSO) kiosk player

[kevenClausenKPG]

Rating box + UI/UX improvements in the LearningSequence (LSO) kiosk player

This PR improves the LearningSequence player in kiosk layout in several places. The main focus is a core-aligned integration of the rating feature directly on the currently opened object. In addition, navigation/orientation at the end of the sequence as well as the visibility of sequence and object information are improved.

1) Rating box in the LSO player

Context

The LearningSequence player previously lacked the ability to rate the currently opened object directly, even though ILIAS provides a core rating feature for many object types. The goal is to provide a core-conform rating box in the player header.

Implementation

• A rating widget is shown in the player header for the current object.
• The widget is displayed only if rating is available in core for the respective object type and is enabled for the object.
• The existing ILIAS component ilRatingGUI is used (popover “Your Rating”, stars, “Remove Rating”).

Technical notes

• The rating HTML is rendered as a ListGUI property and encapsulated in a dedicated template container snippet to avoid manual HTML concatenation in PHP.
• For the kiosk layout, the popover/overlay interaction is wired via delegated event handlers, because the rating snippets are replaced after an AJAX redraw.
• After saving a rating, the affected ListGUI snippets are redrawn via AJAX.

2) UI placement

Implementation

• The rating box was moved into the actions area in the player header (matching the usual core header pattern).
• This keeps the integration consistent with other object headers in core (view modes/actions grouped in the header).

3) Further improvements in the kiosk player

3.1 Finish the sequence (Finish instead of a disabled Next)

Context

On the last page (last object), it is not clear that the sequence ends here: the Next button is simply disabled.

Implementation

• On the last step, an explicit “Finish” button is shown instead of “Next”. This ends the sequence.

3.2 Show the learning sequence title

Context

The title of the Learning Sequence is not visible in the kiosk player, although it is important for orientation.

Implementation

• The title of the Learning Sequence is shown at the relevant places in the player (e.g. in the slate title and in the header area).

3.3 Show the object description directly in the header

Context

To see an object’s description, users previously always had to switch to the slate. This is unnecessarily cumbersome in the kiosk flow.

Implementation

• The description of the current object is displayed directly below the title in the header (if available).

References / tickets

• Mantis: TODO https://mantis.ilias.de/view.php?id=46242
• Mantis: TODO https://mantis.ilias.de/view.php?id=34620
• FW: https://docu.ilias.de/go/wiki/wpage_5927_1357

Summary

Overall, these changes make the kiosk player easier to understand and handle for learners.

[oliversamoila]

Hello @kevenClausenKPG.

Perhaps you and @fhelfer could have a discussion about the comprehensive JavaScript in components/ILIAS/LearningSequence/resources/js/lso_kiosk_rating.js and whether there are any lighter-weight solutions for the use of ilRatingGUI.
Fabian is away for just a few more days, but it might be worth discussing this before the integration.

Best regards,
@oliversamoila (as Concept Authority of Rating Component)