ilLearningProgressGUI Class Reference

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V. More...

Inheritance diagram for ilLearningProgressGUI:

Collaboration diagram for ilLearningProgressGUI:

Public Member Functions
	executeCommand ()
	execute command More...
	__setCmdClass (string $a_class)
	__getNextClass ()
Public Member Functions inherited from ilLearningProgressBaseGUI
	__construct (int $a_mode, int $a_ref_id=0, int $a_usr_id=0)
	isAnonymized ()
	getMode ()
	getRefId ()
	getObjId ()
	getUserId ()
	__getDefaultCommand ()
	__setSubTabs (int $a_active)
	__buildFooter ()
	__buildHeader ()
	__showObjectDetails (ilInfoScreenGUI $info, int $item_id=0, bool $add_section=true)
	show details about current object. More...
	__appendLPDetails (ilInfoScreenGUI $info, int $item_id, int $user_id)
	__getLegendHTML (int $variant=ilLPStatusIcons::ICON_VARIANT_LONG)
	__showEditUser (int $a_user_id, int $a_ref_id, ?string $a_cancel=null, int $a_sub_id=0)
	__updateUser (int $user_id, int $obj_id)

Protected Member Functions
	editManual ()
	Show progress screen for "edit manual". More...
	initCollectionManualForm ()
	updateManual ()
	showtlt ()
Protected Member Functions inherited from ilLearningProgressBaseGUI
	initUserIdFromQuery ()
	initEditUserForm (int $a_user_id, int $a_obj_id, ?string $a_cancel=null)

Additional Inherited Members
Static Public Member Functions inherited from ilLearningProgressBaseGUI
static	_getStatusText (int $a_status, ?ilLanguage $a_lng=null)
	Get status alt text. More...
static	__readStatus (int $a_obj_id, int $user_id)
	PhpInconsistentReturnPointsInspection More...
static	isObjectOffline (int $a_obj_id, string $a_type='')
Data Fields inherited from ilLearningProgressBaseGUI
const	LP_CONTEXT_PERSONAL_DESKTOP = 1
const	LP_CONTEXT_ADMINISTRATION = 2
const	LP_CONTEXT_REPOSITORY = 3
const	LP_CONTEXT_USER_FOLDER = 4
const	LP_CONTEXT_ORG_UNIT = 5
Protected Attributes inherited from ilLearningProgressBaseGUI
RefineryFactory	$refinery
HttpServices	$http
ilGlobalTemplateInterface	$tpl
ilHelpGUI	$help
ilCtrlInterface	$ctrl
ilLanguage	$lng
ilLogger	$logger
ilTabsGUI	$tabs_gui
ilToolbarGUI	$toolbar
ilObjectDataCache	$ilObjectDataCache
ilObjUser	$user
ilAccessHandler	$access
ilRbacSystem	$rbacsystem
ilRbacReview	$rbacreview
ilTree	$tree
bool	$anonymized
int	$usr_id = 0
int	$ref_id = 0
int	$obj_id = 0
string	$obj_type = ''
int	$mode = 0
const	LP_ACTIVE_SETTINGS = 1
const	LP_ACTIVE_OBJECTS = 2
const	LP_ACTIVE_PROGRESS = 3
const	LP_ACTIVE_USERS = 5
const	LP_ACTIVE_SUMMARY = 6
const	LP_ACTIVE_OBJSTATACCESS = 7
const	LP_ACTIVE_OBJSTATTYPES = 8
const	LP_ACTIVE_OBJSTATDAILY = 9
const	LP_ACTIVE_OBJSTATADMIN = 10
const	LP_ACTIVE_MATRIX = 11

Detailed Description

This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Learning e.V.

ILIAS is licensed with the GPL-3.0, see https://www.gnu.org/licenses/gpl-3.0.en.html You should have received a copy of said license along with the source code, too.

If this is not the case or you just want to try ILIAS, you'll find us at: https://www.ilias.de https://github.com/ILIAS-eLearning Class ilObjUserTrackingGUI

Author

Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om ilLearningProgressGUI: ilLPListOfObjectsGUI, ilLPListOfSettingsGUI, ilLPListOfProgressGUI ilLearningProgressGUI: ilLPObjectStatisticsGUI

Definition at line 27 of file class.ilLearningProgressGUI.php.

Member Function Documentation

__getNextClass()

ilLearningProgressGUI::__getNextClass

(

)

Definition at line 138 of file class.ilLearningProgressGUI.php.

References ilObjUserTracking\_enabledLearningProgress(), ilObjUserTracking\_enabledUserRelatedData(), ilObjUserTracking\_hasLearningProgressLearner(), ilObjUserTracking\_hasLearningProgressOtherUsers(), ilObject\_lookupObjId(), ilLearningProgressAccess\checkPermission(), ilSession\clear(), ILIAS\Repository\ctrl(), ilSession\get(), ilObjectLP\getInstance(), ilLearningProgressBaseGUI\getMode(), ilLearningProgressBaseGUI\getRefId(), ilUtil\redirect(), and ilSession\set().

Referenced by executeCommand().

                                    : string
    {
        // #9857
        if (!ilObjUserTracking::_enabledLearningProgress()) {
            return '';
        }

        if (strlen($next_class = $this->ctrl->getNextClass())) {
            if ($this->getMode() == self::LP_CONTEXT_PERSONAL_DESKTOP) {
                ilSession::set('il_lp_history', $next_class);
            }
            return $next_class;
        }
        switch ($this->getMode()) {
            case self::LP_CONTEXT_ADMINISTRATION:
                return 'illplistofobjectsgui';

            case self::LP_CONTEXT_REPOSITORY:
                $cmd = $this->ctrl->getCmd();
                if (in_array(
                    $cmd,
                    array("editManual", "updatemanual", "showtlt")
                )) {
                    return "";
                }

                // #12771
                $olp = ilObjectLP::getInstance(
                    ilObject::_lookupObjId($this->getRefId())
                );
                if (!$olp->isActive()) {
                    if (!($olp instanceof ilPluginLP) &&
                        ilLearningProgressAccess::checkPermission(
                            'edit_learning_progress',
                            $this->getRefId()
                        )) {
                        return 'illplistofsettingsgui';
                    } else {
                        return '';
                    }
                }

                if (!$this->anonymized &&
                    ilLearningProgressAccess::checkPermission(
                        'read_learning_progress',
                        $this->getRefId()
                    )) {
                    return 'illplistofobjectsgui';
                }
                if (
                ilLearningProgressAccess::checkPermission(
                    'edit_learning_progress',
                    $this->getRefId()
                )) {
                    return 'illplistofsettingsgui';
                }
                return 'illplistofprogressgui';

            case self::LP_CONTEXT_PERSONAL_DESKTOP:

                $has_edit = ilObjUserTracking::_hasLearningProgressOtherUsers();
                $has_personal = ilObjUserTracking::_hasLearningProgressLearner(
                );

                if ($has_edit || $has_personal) {
                    // default (#10928)
                    $tgt = null;
                    if ($has_personal) {
                        $tgt = 'illplistofprogressgui';
                    } elseif ($has_edit) {
                        $tgt = 'illplistofobjectsgui';
                    }

                    // validate session
                    switch (ilSession::get('il_lp_history')) {
                        case 'illplistofobjectsgui':
                            if (!$has_edit) {
                                ilSession::clear('il_lp_history');
                            }
                            break;

                        case 'illplistofprogressgui':
                            if (!$has_personal) {
                                ilSession::clear('il_lp_history');
                            }
                            break;
                    }

                    if (ilSession::get('il_lp_history')) {
                        return ilSession::get('il_lp_history');
                    } elseif ($tgt) {
                        return $tgt;
                    }
                }

                // should not happen
                ilUtil::redirect("ilias.php?baseClass=ilDashboardGUI");

            // no break
            case self::LP_CONTEXT_USER_FOLDER:
            case self::LP_CONTEXT_ORG_UNIT:
                if (ilObjUserTracking::_enabledUserRelatedData()) {
                    return 'illplistofprogressgui';
                }
                break;
        }
        return '';
    }

Here is the call graph for this function:

Here is the caller graph for this function:

__setCmdClass()

ilLearningProgressGUI::__setCmdClass

(

string

$a_class

)

Definition at line 130 of file class.ilLearningProgressGUI.php.

References ILIAS\Repository\ctrl().

Referenced by executeCommand().

                                                  : void
    {
        if (strcasecmp(ilLearningProgressGUI::class, $this->ctrl->getCmdClass()) === 0) {
            $this->ctrl->setCmdClass($a_class);
        }
        //$this->ctrl->setCmdClass($a_class);
    }

Here is the call graph for this function:

Here is the caller graph for this function:

editManual()

ilLearningProgressGUI::editManual ( )

protected

Show progress screen for "edit manual".

Definition at line 250 of file class.ilLearningProgressGUI.php.

References ilObject\_lookupObjId(), ilLearningProgressAccess\checkAccess(), ilObjectLP\getInstance(), ilLearningProgressBaseGUI\getRefId(), initCollectionManualForm(), and ilLPObjSettings\LP_MODE_COLLECTION_MANUAL.

                                   : void
    {
        if (ilLearningProgressAccess::checkAccess($this->getRefId())) {
            $olp = ilObjectLP::getInstance(
                ilObject::_lookupObjId($this->getRefId())
            );
            if ($olp->getCurrentMode(
                ) == ilLPObjSettings::LP_MODE_COLLECTION_MANUAL) {
                $form = $this->initCollectionManualForm();
                $this->tpl->setContent($form->getHTML());
            }
        }
    }

Here is the call graph for this function:

executeCommand()

ilLearningProgressGUI::executeCommand

(

)

execute command

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

References ilLearningProgressBaseGUI\__buildFooter(), ilLearningProgressBaseGUI\__buildHeader(), __getNextClass(), __setCmdClass(), ilLearningProgressBaseGUI\__setSubTabs(), ilObject\_lookupType(), ilLearningProgressAccess\checkPermission(), ILIAS\Repository\ctrl(), ilLearningProgressBaseGUI\getMode(), ilLearningProgressBaseGUI\getRefId(), ilLearningProgressBaseGUI\getUserId(), and ILIAS\Repository\help().

    {
        $this->ctrl->setReturn($this, "");

        // E.g personal desktop mode needs locator header icon ...
        $this->__buildHeader();
        switch ($this->__getNextClass()) {
            case 'illplistofprogressgui':

                $this->help->setScreenIdComponent(
                    "lp_" . ilObject::_lookupType($this->getRefId(), true)
                );

                $this->__setSubTabs(self::LP_ACTIVE_PROGRESS);
                $this->__setCmdClass(ilLPListOfProgressGUI::class);
                $lop_gui = new ilLPListOfProgressGUI(
                    $this->getMode(),
                    $this->getRefId(),
                    $this->getUserId()
                );
                $this->ctrl->forwardCommand($lop_gui);
                break;

            case 'illplistofobjectsgui':
                if ($this->getRefId() &&
                    !ilLearningProgressAccess::checkPermission(
                        'read_learning_progress',
                        $this->getRefId()
                    )) {
                    return;
                }

                if (stristr($this->ctrl->getCmd(), "matrix")) {
                    $this->__setSubTabs(self::LP_ACTIVE_MATRIX);
                } elseif (stristr($this->ctrl->getCmd(), "summary")) {
                    $this->__setSubTabs(self::LP_ACTIVE_SUMMARY);
                } else {
                    $this->__setSubTabs(self::LP_ACTIVE_OBJECTS);
                }
                $loo_gui = new ilLPListOfObjectsGUI(
                    $this->getMode(),
                    $this->getRefId()
                );
                $this->__setCmdClass(ilLPListOfObjectsGUI::class);
                $this->ctrl->forwardCommand($loo_gui);
                break;

            case 'illplistofsettingsgui':
                if ($this->getRefId() &&
                    !ilLearningProgressAccess::checkPermission(
                        'edit_learning_progress',
                        $this->getRefId()
                    )) {
                    return;
                }

                $this->__setSubTabs(self::LP_ACTIVE_SETTINGS);
                $los_gui = new ilLPListOfSettingsGUI(
                    $this->getMode(),
                    $this->getRefId()
                );
                $this->__setCmdClass(ilLPListOfSettingsGUI::class);
                $this->ctrl->forwardCommand($los_gui);
                break;

            case 'illpobjectstatisticsgui':
                if (stristr($this->ctrl->getCmd(), "access")) {
                    $this->__setSubTabs(self::LP_ACTIVE_OBJSTATACCESS);
                } elseif (stristr($this->ctrl->getCmd(), "types")) {
                    $this->__setSubTabs(self::LP_ACTIVE_OBJSTATTYPES);
                } elseif (stristr($this->ctrl->getCmd(), "daily")) {
                    $this->__setSubTabs(self::LP_ACTIVE_OBJSTATDAILY);
                } else {
                    $this->__setSubTabs(self::LP_ACTIVE_OBJSTATADMIN);
                }
                $this->__setCmdClass(ilLPObjectStatisticsGUI::class);
                $this->tabs_gui->activateTab('statistics');
                $ost_gui = new ilLPObjectStatisticsGUI(
                    $this->getMode(),
                    $this->getRefId()
                );
                $this->ctrl->forwardCommand($ost_gui);
                break;

            default:
                $cmd = $this->ctrl->getCmd();
                if (!$cmd) {
                    return;
                }
                $this->$cmd();
                $this->tpl->printToStdout();
                break;
        }

        // E.G personal desktop mode needs $tpl->show();
        $this->__buildFooter();
    }

Here is the call graph for this function:

initCollectionManualForm()

ilLearningProgressGUI::initCollectionManualForm ( )

protected

Definition at line 264 of file class.ilLearningProgressGUI.php.

References ilLPStatusFactory\_getClassById(), ilObject\_lookupType(), ILIAS\Repository\ctrl(), ilDatePresentation\formatDate(), ilLPStatusIcons\getInstance(), ilObjectLP\getInstance(), ilLearningProgressBaseGUI\getObjId(), ilLearningProgressBaseGUI\getRefId(), ilLPStatusIcons\ICON_VARIANT_LONG, IL_CAL_UNIX, ILIAS\Repository\lng(), ilLPObjSettings\LP_MODE_COLLECTION_MANUAL, ilLPStatus\LP_STATUS_COMPLETED_NUM, and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

Referenced by editManual(), and updateManual().

                                                 : ilPropertyFormGUI
    {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this, "updatemanual"));
        $form->setTitle($this->lng->txt("learning_progress"));
        $form->setDescription(
            $this->lng->txt("trac_collection_manual_learner_info")
        );

        $coll_items = array();

        $olp = ilObjectLP::getInstance($this->getObjId());
        $collection = $olp->getCollectionInstance();
        $subitem_info = '';
        $subitem_title = '';
        $possible_items = [];
        if ($collection) {
            $coll_items = $collection->getItems();
            $possible_items = $collection->getPossibleItems(
                $this->getRefId()
            ); // for titles

            switch (ilObject::_lookupType($this->getObjId())) {
                case "lm":
                    $subitem_title = $this->lng->txt("objs_st");
                    $subitem_info = $this->lng->txt(
                        "trac_collection_manual_learner_lm_info"
                    );
                    break;
            }
        }

        $class = ilLPStatusFactory::_getClassById(
            $this->getObjId(),
            ilLPObjSettings::LP_MODE_COLLECTION_MANUAL
        );
        $lp_data = $class::_getObjectStatus($this->getObjId(), $this->usr_id);

        $icons = ilLPStatusIcons::getInstance(ilLPStatusIcons::ICON_VARIANT_LONG);

        $grp = new ilCheckboxGroupInputGUI($subitem_title, "sids");
        $grp->setInfo($subitem_info);
        $form->addItem($grp);

        // #14994 - using possible items for proper sorting

        $completed = array();
        foreach (array_keys($possible_items) as $item_id) {
            if (!in_array($item_id, $coll_items)) {
                continue;
            }

            $info = null;
            $status = ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM;

            if (isset($lp_data[$item_id])) {
                $changed = new ilDateTime($lp_data[$item_id][1], IL_CAL_UNIX);
                $info = $this->lng->txt(
                    "trac_collection_manual_learner_changed_ts"
                ) . ": " .
                    ilDatePresentation::formatDate($changed);

                if ($lp_data[$item_id][0]) {
                    $status = ilLPStatus::LP_STATUS_COMPLETED_NUM;
                    $completed[] = $item_id;
                }
            }

            $icon = $icons->renderIconForStatus($status);

            $opt = new ilCheckboxOption(
                $icon . " " . $possible_items[$item_id]["title"],
                $item_id
            );
            if ($info) {
                $opt->setInfo($info);
            }
            $grp->addOption($opt);
        }

        if ($completed) {
            $grp->setValue($completed);
        }

        $form->addCommandButton("updatemanual", $this->lng->txt("save"));

        return $form;
    }

Here is the call graph for this function:

Here is the caller graph for this function:

showtlt()

ilLearningProgressGUI::showtlt ( )

protected

Definition at line 387 of file class.ilLearningProgressGUI.php.

References ilLPStatusFactory\_getClassById(), ILIAS\Repository\ctrl(), ilLPStatusIcons\getInstance(), ilObjectLP\getInstance(), ilLearningProgressBaseGUI\getObjId(), ilLearningProgressBaseGUI\getRefId(), ilLPStatusIcons\ICON_VARIANT_LONG, ILIAS\Repository\lng(), ilLPObjSettings\LP_MODE_COLLECTION_TLT, ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_IN_PROGRESS_NUM, ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM, ilDatePresentation\secondsToString(), and ILIAS\Repository\user().

    {
        $form = new ilPropertyFormGUI();
        $form->setFormAction($this->ctrl->getFormAction($this, "showtlt"));
        $form->setTitle($this->lng->txt("learning_progress"));
        $form->setDescription(
            $this->lng->txt("trac_collection_tlt_learner_info")
        );

        $coll_items = array();

        $olp = ilObjectLP::getInstance($this->getObjId());
        $collection = $olp->getCollectionInstance();
        $possible_items = [];
        if ($collection) {
            $coll_items = $collection->getItems();
            $possible_items = $collection->getPossibleItems(
                $this->getRefId()
            ); // for titles
        }

        $class = ilLPStatusFactory::_getClassById(
            $this->getObjId(),
            ilLPObjSettings::LP_MODE_COLLECTION_TLT
        );
        $info = $class::_getStatusInfo($this->getObjId(), true);

        $icons = ilLPStatusIcons::getInstance(ilLPStatusIcons::ICON_VARIANT_LONG);

        foreach ($coll_items as $item_id) {
            // #16599 - deleted items should not be displayed
            if (!array_key_exists($item_id, $possible_items)) {
                continue;
            }

            $field = new ilCustomInputGUI($possible_items[$item_id]["title"]);

            // lp status
            $status = ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM;
            if (isset($info["completed"][$item_id]) &&
                in_array($this->user->getId(), $info["completed"][$item_id])) {
                $status = ilLPStatus::LP_STATUS_COMPLETED_NUM;
            } elseif (isset($info["in_progress"][$item_id]) &&
                in_array(
                    $this->user->getId(),
                    $info["in_progress"][$item_id]
                )) {
                $status = ilLPStatus::LP_STATUS_IN_PROGRESS_NUM;
            }
            $field->setHtml($icons->renderIconForStatus($status));

            // stats
            $spent = 0;
            if (isset($info["tlt_users"][$item_id][$this->user->getId()])) {
                $spent = $info["tlt_users"][$item_id][$this->user->getId()];
            }
            $needed = $info["tlt"][$item_id];
            if ($needed) {
                $field->setInfo(
                    sprintf(
                        $this->lng->txt("trac_collection_tlt_learner_subitem"),
                        ilDatePresentation::secondsToString($spent),
                        ilDatePresentation::secondsToString($needed),
                        min(100, round(abs($spent) / $needed * 100))
                    )
                );
            }

            $form->addItem($field);
        }

        $this->tpl->setContent($form->getHTML());
    }

Here is the call graph for this function:

updateManual()

ilLearningProgressGUI::updateManual ( )

protected

Definition at line 353 of file class.ilLearningProgressGUI.php.

References ilLPStatusFactory\_getClassById(), ilObject\_lookupObjId(), ilLearningProgressAccess\checkAccess(), ILIAS\Repository\ctrl(), ilObjectLP\getInstance(), ilLearningProgressBaseGUI\getObjId(), ilLearningProgressBaseGUI\getRefId(), initCollectionManualForm(), ILIAS\Repository\lng(), and ilLPObjSettings\LP_MODE_COLLECTION_MANUAL.

                                     : void
    {
        if (ilLearningProgressAccess::checkAccess($this->getRefId())) {
            $olp = ilObjectLP::getInstance(
                ilObject::_lookupObjId($this->getRefId())
            );
            if ($olp->getCurrentMode(
                ) == ilLPObjSettings::LP_MODE_COLLECTION_MANUAL) {
                $form = $this->initCollectionManualForm();
                if ($form->checkInput()) {
                    $class = ilLPStatusFactory::_getClassById(
                        $this->getObjId(),
                        ilLPObjSettings::LP_MODE_COLLECTION_MANUAL
                    );
                    $class::_setObjectStatus(
                        $this->getObjId(),
                        $this->usr_id,
                        $form->getInput("sids")
                    );

                    $this->tpl->setOnScreenMessage(
                        'success',
                        $this->lng->txt(
                            "settings_saved"
                        ),
                        true
                    );
                }

                $this->ctrl->redirect($this, "editManual");
            }
        }
    }

Here is the call graph for this function:

---

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

• Services/Tracking/classes/class.ilLearningProgressGUI.php