ilLSPlayer Class Reference

Implementation of KioskMode Player. More...

Collaboration diagram for ilLSPlayer:

Public Member Functions
	__construct (protected ilLSLearnerItemsQueries $ls_items, protected LSControlBuilder $control_builder, protected LSUrlBuilder $url_builder, protected ilLSCurriculumBuilder $curriculum_builder, protected ilLSViewFactory $view_factory, protected ilKioskPageRenderer $page_renderer, protected Factory $ui_factory, protected ScreenContext $current_context, protected Refinery\Factory $refinery)
	play (RequestWrapper $get)
	getCurrentItemLearningProgress ()

Data Fields
const	PARAM_LSO_COMMAND = 'lsocmd'
const	PARAM_LSO_PARAMETER = 'lsov'
const	LSO_CMD_NEXT = 'lsonext'
const	LSO_CMD_GOTO = 'lsogoto'
const	LSO_CMD_SUSPEND = 'lsosuspend'
const	LSO_CMD_FINISH = 'lsofinish'
const	GS_DATA_LS_KIOSK_MODE = 'ls_kiosk_mode'
const	GS_DATA_LS_CONTENT = 'ls_content'
const	GS_DATA_LS_MAINBARCONTROLS = 'ls_mainbar_controls'
const	GS_DATA_LS_METABARCONTROLS = 'ls_metabar_controls'

Protected Member Functions
	getCurrentItem (array $items)
	getNextAvailableItem (array $items, LSLearnerItem $current_item)
	updateViewState (ILIAS\KioskMode\State $state, ILIAS\KioskMode\View $view, RequestWrapper $get)
	getNextItem (array $items, LSLearnerItem $current_item, int $direction)
	$direction is either -1 or 1; More...
	findItemByRefId (array $items, int $ref_id)
	buildDefaultControls (LSControlBuilder $control_builder, LSLearnerItem $item, int $item_position, array $items)
	renderComponentView ($state, ILIAS\KioskMode\View $view)

Detailed Description

Implementation of KioskMode Player.

Definition at line 32 of file class.ilLSPlayer.php.

Constructor & Destructor Documentation

__construct()

ilLSPlayer::__construct	(	protected ilLSLearnerItemsQueries	$ls_items,
		protected LSControlBuilder	$control_builder,
		protected LSUrlBuilder	$url_builder,
		protected ilLSCurriculumBuilder	$curriculum_builder,
		protected ilLSViewFactory	$view_factory,
		protected ilKioskPageRenderer	$page_renderer,
		protected Factory	$ui_factory,
		protected ScreenContext	$current_context,
		protected Refinery\Factory	$refinery
	)

Definition at line 47 of file class.ilLSPlayer.php.

      {
    }

Member Function Documentation

buildDefaultControls()

ilLSPlayer::buildDefaultControls ( LSControlBuilder  $control_builder, LSLearnerItem  $item, int  $item_position, array  $items  )

protected

Definition at line 265 of file class.ilLSPlayer.php.

     : ControlBuilder {
        $is_first = $item_position === 0;
        $is_last = $item_position === count($items) - 1;
 
        if (!$control_builder->getExitControl()) {
            $cmd = self::LSO_CMD_SUSPEND;
            if ($is_last) {
                $cmd = self::LSO_CMD_FINISH;
            }
            $control_builder = $control_builder->exit($cmd);
        }
 
        if (!$control_builder->getPreviousControl()) {
            $direction_prev = -1;
            $cmd = ''; //disables control
 
            if (!$is_first) {
                $available = $this->getNextItem($items, $item, $direction_prev)
                    ->getAvailability() === Step::AVAILABLE;
 
                if ($available) {
                    $cmd = self::LSO_CMD_NEXT;
                }
            }
 
            $control_builder = $control_builder
                ->previous($cmd, $direction_prev);
        }
 
        if (!$control_builder->getNextControl()) {
            $direction_next = 1;
            $cmd = '';
            if (!$is_last) {
                $available = $this->getNextItem($items, $item, $direction_next)
                    ->getAvailability() === Step::AVAILABLE;
 
                if ($available) {
                    $cmd = self::LSO_CMD_NEXT;
                }
            }
 
            $control_builder = $control_builder
                ->next($cmd, $direction_next);
        }
 
        return $control_builder;
    }

References LSControlBuilder\exit().

Referenced by play().

Here is the call graph for this function:

Here is the caller graph for this function:

findItemByRefId()

ilLSPlayer::findItemByRefId ( array  $items, int  $ref_id  )

protected

Returns

array <int, LSLearnerItem> position=>item

Definition at line 255 of file class.ilLSPlayer.php.

                                                                 : array
    {
        foreach ($items as $index => $item) {
            if ($item->getRefId() === $ref_id) {
                return [$index, $item];
            }
        }
        throw new \Exception("This is not a valid item.", 1);
    }

References $ref_id.

Referenced by getCurrentItem(), and play().

Here is the caller graph for this function:

getCurrentItem()

ilLSPlayer::getCurrentItem ( array  $items )

protected

Parameters

array

LSLearnerItem[]

Definition at line 182 of file class.ilLSPlayer.php.

                                                   : LSLearnerItem
    {
        $current_item = $items[0];
        $current_item_ref_id = $this->ls_items->getCurrentItemRefId();
        if ($current_item_ref_id !== 0) {
            $valid_ref_ids = array_map(
                fn($item) => $item->getRefId(),
                array_values($this->ls_items->getItems())
            );
            if (in_array($current_item_ref_id, $valid_ref_ids)) {
                list(, $current_item) = $this->findItemByRefId($items, $current_item_ref_id);
            }
        }
        return $current_item;
    }

References findItemByRefId().

Referenced by play().

Here is the call graph for this function:

Here is the caller graph for this function:

getCurrentItemLearningProgress()

ilLSPlayer::getCurrentItemLearningProgress

(

)

Definition at line 328 of file class.ilLSPlayer.php.

                                                    : int
    {
        $item = $this->getCurrentItem($this->ls_items->getItems());
        return $item->getLearningProgressStatus();
    }

References LSLearnerItem\getLearningProgressStatus().

Here is the call graph for this function:

getNextAvailableItem()

ilLSPlayer::getNextAvailableItem ( array  $items, LSLearnerItem  $current_item  )

protected

Definition at line 198 of file class.ilLSPlayer.php.

     : ?LSLearnerItem {
        if ($current_item->getAvailability() === Step::AVAILABLE) {
            return $current_item;
        }
 
        $new_next_item = null;
        $idx = array_search($current_item, $items);
 
        for ($i = $idx - 1; $i >= 0; $i--) {
            if ($items[$i]->getAvailability() === Step::AVAILABLE) {
                $new_next_item = $items[$i];
                continue;
            }
        }
        if ($new_next_item === null) {
            for ($i = $idx + 1; $i < count($items); $i++) {
                if ($items[$i]->getAvailability() === Step::AVAILABLE) {
                    $new_next_item = $items[$i];
                    continue;
                }
            }
        }
        return $new_next_item;
    }

Referenced by play().

Here is the caller graph for this function:

getNextItem()

ilLSPlayer::getNextItem ( array  $items, LSLearnerItem  $current_item, int  $direction  )

protected

$direction is either -1 or 1;

Definition at line 242 of file class.ilLSPlayer.php.

                                                                                             : LSLearnerItem
    {
        list($position) = $this->findItemByRefId($items, $current_item->getRefId());
        $next = $position + $direction;
        if ($next >= 0 && $next < count($items)) {
            return $items[$next];
        }
        return $current_item;
    }

References LSItem\getRefId().

Referenced by play().

Here is the call graph for this function:

Here is the caller graph for this function:

play()

ilLSPlayer::play

(

RequestWrapper

$get

)

Definition at line 60 of file class.ilLSPlayer.php.

                                             : ?string
    {
        $items = $this->ls_items->getItems();
 
        if (count($items) === 0) {
            return null;
        }
 
        $current_item = $this->getNextAvailableItem($items, $this->getCurrentItem($items));
        if ($current_item === null) {
            return null;
        }
 
        $view = $this->view_factory->getViewFor($current_item);
        $state = $this->ls_items->getStateFor($current_item, $view);
        $state = $this->updateViewState($state, $view, $get);
        //reload items after update viewState
        $items = $this->ls_items->getItems();
 
        $current_item_ref_id = $current_item->getRefId();
        //now, digest parameter:
        $command = null;
        if ($get->has(self::PARAM_LSO_COMMAND)) {
            $command = $get->retrieve(self::PARAM_LSO_COMMAND, $this->refinery->kindlyTo()->string());
        }
        $param = null;
        if ($get->has(self::PARAM_LSO_PARAMETER)) {
            $param = $get->retrieve(self::PARAM_LSO_PARAMETER, $this->refinery->kindlyTo()->int());
        }
 
        switch ($command) {
            case self::LSO_CMD_SUSPEND:
            case self::LSO_CMD_FINISH:
                $this->ls_items->storeState($state, $current_item_ref_id, $current_item_ref_id);
                return 'EXIT::' . $command;
            case self::LSO_CMD_NEXT:
                $next_item = $this->getNextItem($items, $current_item, $param);
                if ($next_item->getAvailability() !== Step::AVAILABLE) {
                    $next_item = $current_item;
                }
                break;
            case self::LSO_CMD_GOTO:
                list(, $next_item) = $this->findItemByRefId($items, $param);
                break;
            default: //view-internal / unknown command
                $next_item = $current_item;
        }
        //write State to DB
        $this->ls_items->storeState($state, $current_item_ref_id, $next_item->getRefId());
 
        //get proper view
        if ($next_item != $current_item) {
            $view = $this->view_factory->getViewFor($next_item);
            $state = $this->ls_items->getStateFor($next_item, $view);
        }
 
        //content
        $obj_title = $next_item->getTitle();
        $icon = $this->ui_factory->symbol()->icon()->standard(
            $next_item->getType(),
            $next_item->getType(),
            'medium'
        );
 
        $content = $this->renderComponentView($state, $view);
 
        $panel = $this->ui_factory->panel()->standard(
            '',
            $content
        );
        $content = [$panel];
 
        $items = $this->ls_items->getItems(); //reload items after renderComponentView content
 
        //get position
        list($item_position, $item) = $this->findItemByRefId($items, $next_item->getRefId());
 
        //have the view build controls
        $control_builder = $this->control_builder;
        $view->buildControls($state, $control_builder);
 
        //amend controls not set by the view
        $control_builder = $this->buildDefaultControls($control_builder, $item, $item_position, $items);
 
        $rendered_body = $this->page_renderer->render(
            $control_builder,
            $obj_title,
            $icon,
            $content
        );
 
        $metabar_controls = [
            'exit' => $control_builder->getExitControl()
        ];
 
        $curriculum_slate = $this->page_renderer->buildCurriculumSlate(
            $this->curriculum_builder
                ->getLearnerCurriculum(true)
                ->withActive($item_position)
        );
        $mainbar_controls = [
            'curriculum' => $curriculum_slate
        ];
 
        $toc = $control_builder->getToc();
        if ($toc) {
            $toc_slate = $this->page_renderer->buildToCSlate($toc, $icon);
            $mainbar_controls['toc'] = $toc_slate;
        }
 
        $cc = $this->current_context;
        $cc->addAdditionalData(self::GS_DATA_LS_KIOSK_MODE, true);
        $cc->addAdditionalData(self::GS_DATA_LS_METABARCONTROLS, $metabar_controls);
        $cc->addAdditionalData(self::GS_DATA_LS_MAINBARCONTROLS, $mainbar_controls);
        $cc->addAdditionalData(self::GS_DATA_LS_CONTENT, $rendered_body);
 
        return null;
    }

References $param, buildDefaultControls(), findItemByRefId(), getCurrentItem(), getNextAvailableItem(), getNextItem(), ILIAS\HTTP\Wrapper\RequestWrapper\has(), LSO_CMD_FINISH, LSO_CMD_GOTO, LSO_CMD_NEXT, LSO_CMD_SUSPEND, ILIAS\Repository\refinery(), renderComponentView(), ILIAS\HTTP\Wrapper\RequestWrapper\retrieve(), and updateViewState().

Here is the call graph for this function:

renderComponentView()

ilLSPlayer::renderComponentView (   $state, ILIAS\KioskMode\View  $view  )

protected

Definition at line 318 of file class.ilLSPlayer.php.

                                                                              : Component
    {
        return $view->render(
            $state,
            $this->ui_factory,
            $this->url_builder,
            []
        );
    }

Referenced by play().

Here is the caller graph for this function:

updateViewState()

ilLSPlayer::updateViewState ( ILIAS\KioskMode\State  $state, ILIAS\KioskMode\View  $view, RequestWrapper  $get  )

protected

Definition at line 226 of file class.ilLSPlayer.php.

     : ILIAS\KioskMode\State {
        if ($get->has(self::PARAM_LSO_COMMAND) && $get->has(self::PARAM_LSO_PARAMETER)) {
            $command = $get->retrieve(self::PARAM_LSO_COMMAND, $this->refinery->kindlyTo()->string());
            $param = $get->retrieve(self::PARAM_LSO_PARAMETER, $this->refinery->kindlyTo()->int());
            $state = $view->updateGet($state, $command, $param);
        }
        return $state;
    }

References $param, ILIAS\Repository\refinery(), and ILIAS\HTTP\Wrapper\RequestWrapper\retrieve().

Referenced by play().

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

GS_DATA_LS_CONTENT

const ilLSPlayer::GS_DATA_LS_CONTENT = 'ls_content'

Definition at line 43 of file class.ilLSPlayer.php.

Referenced by ilLSViewLayoutProvider\getContentModification().

GS_DATA_LS_KIOSK_MODE

const ilLSPlayer::GS_DATA_LS_KIOSK_MODE = 'ls_kiosk_mode'

Definition at line 42 of file class.ilLSPlayer.php.

Referenced by ilLSViewLayoutProvider\isKioskModeEnabled().

GS_DATA_LS_MAINBARCONTROLS

const ilLSPlayer::GS_DATA_LS_MAINBARCONTROLS = 'ls_mainbar_controls'

Definition at line 44 of file class.ilLSPlayer.php.

Referenced by ilLSViewLayoutProvider\getMainBarModification().

GS_DATA_LS_METABARCONTROLS

const ilLSPlayer::GS_DATA_LS_METABARCONTROLS = 'ls_metabar_controls'

Definition at line 45 of file class.ilLSPlayer.php.

Referenced by ilLSViewLayoutProvider\getPageBuilderDecorator().

LSO_CMD_FINISH

const ilLSPlayer::LSO_CMD_FINISH = 'lsofinish'

Definition at line 40 of file class.ilLSPlayer.php.

Referenced by LSControlBuilder\exit(), and play().

LSO_CMD_GOTO

const ilLSPlayer::LSO_CMD_GOTO = 'lsogoto'

Definition at line 38 of file class.ilLSPlayer.php.

Referenced by play().

LSO_CMD_NEXT

const ilLSPlayer::LSO_CMD_NEXT = 'lsonext'

Definition at line 37 of file class.ilLSPlayer.php.

Referenced by play().

LSO_CMD_SUSPEND

const ilLSPlayer::LSO_CMD_SUSPEND = 'lsosuspend'

Definition at line 39 of file class.ilLSPlayer.php.

Referenced by play().

PARAM_LSO_COMMAND

const ilLSPlayer::PARAM_LSO_COMMAND = 'lsocmd'

Definition at line 34 of file class.ilLSPlayer.php.

PARAM_LSO_PARAMETER

const ilLSPlayer::PARAM_LSO_PARAMETER = 'lsov'

Definition at line 35 of file class.ilLSPlayer.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/LearningSequence/classes/Player/class.ilLSPlayer.php