ilStudyProgrammeDashboardViewGUI Class Reference

Inheritance diagram for ilStudyProgrammeDashboardViewGUI:

Collaboration diagram for ilStudyProgrammeDashboardViewGUI:

Public Member Functions
	__construct (ilLanguage $lng, ilObjUser $user, ilAccess $access, ilSetting $setting, ILIAS\UI\Factory $factory, ILIAS\UI\Renderer $renderer, ilCtrl $ctrl, ilLogger $log)

Protected Member Functions
	isCompleted (int $current_status)
	isInProgress (int $current_status)
	fillValidUntil (DateTime $value=null)
	fillNotValid ()
	fillValid ()
	fillMinimumCompletion (float $value)
	fillCurrentCompletion (float $value)
	fillStatus (string $status)
	fillFinishUntil (DateTime $value=null)
	fillRestartFrom (DateTime $value=null)
	getVisibleOnPDMode ()
	hasPermission (ilStudyProgrammeUserAssignment $assignment, string $permission)
	isReadable (ilStudyProgrammeUserAssignment $assignment)
	txt (string $code)
	calculatePercent (ilObjStudyProgramme $prg, int $current_points)
	findValidationValues (array $assignments)
	buildItem (ilObjStudyProgramme $prg, array $properties)
	getDefaultTargetUrl (int $prg_ref_id)

Protected Attributes
	$lng
	$user
	$access
	$setting
	$visible_on_pd_mode
	$log
	$factory
	$renderer
	$ctrl

Detailed Description

Definition at line 7 of file class.ilStudyProgrammeDashboardViewGUI.php.

Constructor & Destructor Documentation

__construct()

ilStudyProgrammeDashboardViewGUI::__construct	(	ilLanguage	$lng,
		ilObjUser	$user,
		ilAccess	$access,
		ilSetting	$setting,
		ILIAS\UI\Factory	$factory,
		ILIAS\UI\Renderer	$renderer,
		ilCtrl	$ctrl,
		ilLogger	$log
	)

Definition at line 55 of file class.ilStudyProgrammeDashboardViewGUI.php.

      {
        $this->lng = $lng;
        $this->lng->loadLanguageModule('prg');
        $this->user = $user;
        $this->access = $access;
        $this->setting = $setting;
        $this->log = $log;
        $this->factory = $factory;
        $this->renderer = $renderer;
        $this->ctrl = $ctrl;
    }

References $access, $ctrl, $factory, $lng, $log, $renderer, $setting, $user, and user().

Here is the call graph for this function:

Member Function Documentation

buildItem()

ilStudyProgrammeDashboardViewGUI::buildItem ( ilObjStudyProgramme  $prg, array  $properties  )

protected

Definition at line 364 of file class.ilStudyProgrammeDashboardViewGUI.php.

      : ILIAS\UI\Component\Item\Item {
        $title = $prg->getTitle();
        $link = $this->getDefaultTargetUrl((int) $prg->getRefId());
        $title_btn = $this->factory->button()->shy($title, $link);
        $description = $prg->getLongDescription() ?? "";
        $max = $this->setting->get("rep_shorten_description_length");
        if ($this->setting->get("rep_shorten_description") && $max) {
            $description = ilUtil::shortenText($description, $max, true);
        }
 
        $icon = $this->factory->symbol()->icon()->standard('prg', $title, 'medium');
        return $this->factory->item()->standard($title_btn)
            ->withProperties(array_merge(...$properties))
            ->withDescription($description)
            ->withLeadIcon($icon)
        ;
    }

calculatePercent()

ilStudyProgrammeDashboardViewGUI::calculatePercent ( ilObjStudyProgramme  $prg, int  $current_points  )

protected

Definition at line 295 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                                                       : array
    {
        $minimum_percents = 0;
        $current_percents = 0;
 
        if ($prg->hasLPChildren()) {
            $minimum_percents = 100;
            if ($current_points > 0) {
                $current_percents = 100;
            }
        }
 
        $children = $prg->getAllPrgChildren();
        if (count($children) > 0) {
            $max_points = 0;
            foreach ($children as $child) {
                $max_points += $child->getPoints();
            }
 
            if ($max_points > 0) {
                $prg_points = $prg->getPoints();
                $minimum_percents = round((100 * $prg_points / $max_points), 2);
            }
            if ($current_points > 0) {
                $current_percents = round((100 * $current_points / $max_points), 2);
            }
        }
 
        return [
            $minimum_percents,
            $current_percents
        ];
    }

References ilObjStudyProgramme\getAllPrgChildren(), ilObjStudyProgramme\getPoints(), and ilObjStudyProgramme\hasLPChildren().

Referenced by mockSPRGDashGUI\mockCalculatePercent().

Here is the call graph for this function:

Here is the caller graph for this function:

fillCurrentCompletion()

ilStudyProgrammeDashboardViewGUI::fillCurrentCompletion ( float  $value )

protected

Definition at line 202 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                           : array
    {
        $title = $value . " " . $this->txt('percentage');
        return [
            $this->txt('prg_dash_label_gain') => $title
        ];
    }

References txt().

Here is the call graph for this function:

fillFinishUntil()

ilStudyProgrammeDashboardViewGUI::fillFinishUntil ( DateTime  $value = null )

protected

Definition at line 217 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                               : array
    {
        $ret = [];
        if (!is_null($value)) {
            $date = new ilDate(
                $value->format('Y-m-d'),
                IL_CAL_DATE
            );
            $date_string = ilDatePresentation::formatDate($date);
            $ret[$this->txt('prg_dash_label_finish_until')] = $date_string;
        }
        return $ret;
    }

References $ret, ilDatePresentation\formatDate(), IL_CAL_DATE, and txt().

Here is the call graph for this function:

fillMinimumCompletion()

ilStudyProgrammeDashboardViewGUI::fillMinimumCompletion ( float  $value )

protected

Definition at line 194 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                           : array
    {
        $title = $value . " " . $this->txt('percentage');
        return [
            $this->txt('prg_dash_label_minimum') => $title
        ];
    }

References txt().

Here is the call graph for this function:

fillNotValid()

ilStudyProgrammeDashboardViewGUI::fillNotValid ( )

protected

Definition at line 180 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                      : array
    {
        return [
            $this->txt('prg_dash_label_valid') => $this->txt('no')
        ];
    }

References txt().

Here is the call graph for this function:

fillRestartFrom()

ilStudyProgrammeDashboardViewGUI::fillRestartFrom ( DateTime  $value = null )

protected

Definition at line 231 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                               : array
    {
        $ret = [];
        if (!is_null($value)) {
            $date = new ilDate(
                $value->format('Y-m-d'),
                IL_CAL_DATE
            );
            $date_string = ilDatePresentation::formatDate($date);
            $ret[$this->txt('prg_dash_label_restart_from')] = $date_string;
        }
        return $ret;
    }

References $ret, ilDatePresentation\formatDate(), IL_CAL_DATE, and txt().

Here is the call graph for this function:

fillStatus()

ilStudyProgrammeDashboardViewGUI::fillStatus ( string  $status )

protected

Definition at line 210 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                  : array
    {
        return [
            $this->txt('prg_dash_label_status') => $this->txt('prg_status_' . $status)
        ];
    }

References txt().

Here is the call graph for this function:

fillValid()

ilStudyProgrammeDashboardViewGUI::fillValid ( )

protected

Definition at line 187 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                   : array
    {
        return [
            $this->txt('prg_dash_label_valid') => $this->txt('yes')
        ];
    }

References txt().

Here is the call graph for this function:

fillValidUntil()

ilStudyProgrammeDashboardViewGUI::fillValidUntil ( DateTime  $value = null )

protected

Definition at line 165 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                              : array
    {
        $date_string = "";
        if (!is_null($value)) {
            $date = new ilDate(
                $value->format('Y-m-d'),
                IL_CAL_DATE
            );
            $date_string = ilDatePresentation::formatDate($date);
        }
        return [
            $this->txt('prg_dash_label_valid') => $date_string
        ];
    }

References ilDatePresentation\formatDate(), IL_CAL_DATE, and txt().

Here is the call graph for this function:

findValidationValues()

ilStudyProgrammeDashboardViewGUI::findValidationValues ( array  $assignments )

protected

Exceptions

ilException

Definition at line 333 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                                : array
    {
        $validation_date = $this->findValid($assignments);
 
        return [
            !is_null($validation_date) && $validation_date->format("Y-m-d") > date("Y-m-d"),
            $validation_date
        ];
    }

getDefaultTargetUrl()

ilStudyProgrammeDashboardViewGUI::getDefaultTargetUrl ( int  $prg_ref_id )

protected

Definition at line 385 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                            : string
    {
        $this->ctrl->setParameterByClass(
            ilObjStudyProgrammeGUI::class,
            'ref_id',
            $prg_ref_id
        );
        $link = $this->ctrl->getLinkTargetByClass(
            [
                ilRepositoryGUI::class,
                ilObjStudyProgrammeGUI::class,
            ]
        );
        $this->ctrl->setParameterByClass(
            ilObjStudyProgrammeGUI::class,
            'ref_id',
            null
        );
        return $link;
    }

getVisibleOnPDMode()

ilStudyProgrammeDashboardViewGUI::getVisibleOnPDMode ( )

protected

Definition at line 245 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                            : string
    {
        if (is_null($this->visible_on_pd_mode)) {
            $this->visible_on_pd_mode =
                $this->setting->get(
                    ilObjStudyProgrammeAdmin::SETTING_VISIBLE_ON_PD,
                    ilObjStudyProgrammeAdmin::SETTING_VISIBLE_ON_PD_READ
                );
        }
        return $this->visible_on_pd_mode;
    }

References $visible_on_pd_mode, ilObjStudyProgrammeAdmin\SETTING_VISIBLE_ON_PD, and ilObjStudyProgrammeAdmin\SETTING_VISIBLE_ON_PD_READ.

hasPermission()

ilStudyProgrammeDashboardViewGUI::hasPermission ( ilStudyProgrammeUserAssignment  $assignment, string  $permission  )

protected

Exceptions

ilException

Definition at line 260 of file class.ilStudyProgrammeDashboardViewGUI.php.

      : bool {
        $prg = $assignment->getStudyProgramme();
        return $this->access->checkAccess($permission, "", $prg->getRefId(), "prg", $prg->getId());
    }

isCompleted()

ilStudyProgrammeDashboardViewGUI::isCompleted ( int  $current_status )

protected

Definition at line 148 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                        : bool
    {
        $status = [
            ilStudyProgrammeProgress::STATUS_ACCREDITED,
            ilStudyProgrammeProgress::STATUS_COMPLETED
        ];
        return in_array($current_status, $status);
    }

References ilStudyProgrammeProgress\STATUS_ACCREDITED, and ilStudyProgrammeProgress\STATUS_COMPLETED.

isInProgress()

ilStudyProgrammeDashboardViewGUI::isInProgress ( int  $current_status )

protected

Definition at line 157 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                         : bool
    {
        $status = [
            ilStudyProgrammeProgress::STATUS_IN_PROGRESS
        ];
        return in_array($current_status, $status);
    }

References ilStudyProgrammeProgress\STATUS_IN_PROGRESS.

isReadable()

ilStudyProgrammeDashboardViewGUI::isReadable ( ilStudyProgrammeUserAssignment  $assignment )

protected

Exceptions

ilException

Definition at line 271 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                                                              : bool
    {
        if ($this->getVisibleOnPDMode() == ilObjStudyProgrammeAdmin::SETTING_VISIBLE_ON_PD_ALLWAYS) {
            return true;
        }
 
        return $this->hasPermission($assignment, "read");
    }

References ilObjStudyProgrammeAdmin\SETTING_VISIBLE_ON_PD_ALLWAYS.

txt()

ilStudyProgrammeDashboardViewGUI::txt ( string  $code )

protected

Definition at line 290 of file class.ilStudyProgrammeDashboardViewGUI.php.

                                         : string
    {
        return $this->lng->txt($code);
    }

Referenced by fillCurrentCompletion(), fillFinishUntil(), fillMinimumCompletion(), fillNotValid(), fillRestartFrom(), fillStatus(), fillValid(), and fillValidUntil().

Here is the caller graph for this function:

Field Documentation

$access

ilStudyProgrammeDashboardViewGUI::$access

protected

Definition at line 23 of file class.ilStudyProgrammeDashboardViewGUI.php.

Referenced by __construct().

$ctrl

ilStudyProgrammeDashboardViewGUI::$ctrl

protected

Definition at line 53 of file class.ilStudyProgrammeDashboardViewGUI.php.

Referenced by __construct().

$factory

ilStudyProgrammeDashboardViewGUI::$factory

protected

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

Referenced by __construct().

$lng

ilStudyProgrammeDashboardViewGUI::$lng

protected

Definition at line 13 of file class.ilStudyProgrammeDashboardViewGUI.php.

Referenced by __construct().

$log

ilStudyProgrammeDashboardViewGUI::$log

protected

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

Referenced by __construct().

$renderer

ilStudyProgrammeDashboardViewGUI::$renderer

protected

Definition at line 48 of file class.ilStudyProgrammeDashboardViewGUI.php.

Referenced by __construct().

$setting

ilStudyProgrammeDashboardViewGUI::$setting

protected

Definition at line 28 of file class.ilStudyProgrammeDashboardViewGUI.php.

Referenced by __construct().

$user

ilStudyProgrammeDashboardViewGUI::$user

protected

Definition at line 18 of file class.ilStudyProgrammeDashboardViewGUI.php.

Referenced by __construct().

$visible_on_pd_mode

ilStudyProgrammeDashboardViewGUI::$visible_on_pd_mode

protected

Definition at line 33 of file class.ilStudyProgrammeDashboardViewGUI.php.

Referenced by getVisibleOnPDMode().

---

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

• Modules/StudyProgramme/classes/class.ilStudyProgrammeDashboardViewGUI.php