ilLPStatusIcons Class Reference

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

Collaboration diagram for ilLPStatusIcons:

Public Member Functions
	getImagePathInProgress ()
	getImagePathCompleted ()
	getImagePathNotAttempted ()
	getImagePathFailed ()
	getImagePathAsset ()
	A long variant of this icon is not available. More...
	getImagePathRunning ()
	A long variant of this icon is not available. More...
	renderIcon (string $path, string $alt)
	getIconComponent (string $path, string $alt)
	getImagePathForStatus (int $a_status)
	renderIconForStatus (int $a_status, ?ilLanguage $a_lng=null)
	Returns the rendered icon with alt text. More...
	lookupNumStatus (string $a_status)
	Transforms the string constants for the status to their interger equivalent. More...

Static Public Member Functions
static	getInstance (int $variant=ilLPStatusIcons::ICON_VARIANT_DEFAULT, ?\ILIAS\UI\Renderer $renderer=null, ?\ILIAS\UI\Factory $factory=null)

Data Fields
const	ICON_VARIANT_LONG = 0
const	ICON_VARIANT_SHORT = 1
const	ICON_VARIANT_SCORM = 2
const	ICON_VARIANT_DEFAULT = ilLPStatusIcons::ICON_VARIANT_LONG

Private Member Functions
	__construct (int $variant, \ILIAS\UI\Renderer $renderer, \ILIAS\UI\Factory $factory)

Private Attributes
	$image_path_in_progress = ''
	$image_path_completed = ''
	$image_path_not_attempted = ''
	$image_path_failed = ''
	$image_path_asset = ''
	$image_path_running = ''
	$factory
	$renderer

Static Private Attributes
static	$instance_variant_long = null
static	$instance_variant_short = null
static	$instance_variant_scorm = null

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 Caches and supplies the paths to the learning progress status images.

Author

Tim Schmitz schmi.nosp@m.tz@l.nosp@m.eifos.nosp@m..de

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

Constructor & Destructor Documentation

__construct()

ilLPStatusIcons::__construct ( int  $variant, \ILIAS\UI\Renderer  $renderer, \ILIAS\UI\Factory  $factory  )

private

Definition at line 93 of file class.ilLPStatusIcons.php.

References $factory, $renderer, ilUtil\getImagePath(), ICON_VARIANT_LONG, ICON_VARIANT_SCORM, and ICON_VARIANT_SHORT.

    {
        $this->factory = $factory;
        $this->renderer = $renderer;

        switch ($variant) {
            case ilLPStatusIcons::ICON_VARIANT_SCORM:
                $this->image_path_in_progress = ilUtil::getImagePath('scorm/incomplete.svg');
                $this->image_path_completed = ilUtil::getImagePath('scorm/complete.svg');
                $this->image_path_not_attempted = ilUtil::getImagePath('scorm/not_attempted.svg');
                $this->image_path_failed = ilUtil::getImagePath('scorm/failed.svg');
                $this->image_path_asset = ilUtil::getImagePath('scorm/asset.svg');
                $this->image_path_running = ilUtil::getImagePath('scorm/running.svg');
                break;

            case ilLPStatusIcons::ICON_VARIANT_SHORT:
                $this->image_path_in_progress = ilUtil::getImagePath('learning_progress/short/in_progress.svg');
                $this->image_path_completed = ilUtil::getImagePath('learning_progress/short/completed.svg');
                $this->image_path_not_attempted = ilUtil::getImagePath('learning_progress/short/not_attempted.svg');
                $this->image_path_failed = ilUtil::getImagePath('learning_progress/short/failed.svg');
                $this->image_path_asset = ilUtil::getImagePath('learning_progress/short/asset.svg');
                $this->image_path_running = ilUtil::getImagePath('learning_progress/short/running.svg');
                break;

            case ilLPStatusIcons::ICON_VARIANT_LONG:
                $this->image_path_in_progress = ilUtil::getImagePath('learning_progress/in_progress.svg');
                $this->image_path_completed = ilUtil::getImagePath('learning_progress/completed.svg');
                $this->image_path_not_attempted = ilUtil::getImagePath('learning_progress/not_attempted.svg');
                $this->image_path_failed = ilUtil::getImagePath('learning_progress/failed.svg');
                break;

            default:
                throw new ilLPException("No such variant of the LP icons exists.");
        }
    }

Here is the call graph for this function:

Member Function Documentation

getIconComponent()

ilLPStatusIcons::getIconComponent	(	string	$path,
		string	$alt
	)

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

Referenced by renderIcon().

                                                                : \ILIAS\UI\Component\Symbol\Icon\Custom
    {
        return $this->factory->symbol()->icon()->custom($path, $alt, \ILIAS\UI\Component\Symbol\Icon\Icon::SMALL);
    }

Here is the caller graph for this function:

getImagePathAsset()

ilLPStatusIcons::getImagePathAsset

(

)

A long variant of this icon is not available.

Definition at line 152 of file class.ilLPStatusIcons.php.

References $image_path_asset.

                                        : string
    {
        if ($this->image_path_asset) {
            return $this->image_path_asset;
        }
        throw new ilLPException("A long variant of the 'asset' LP icon does not exist.");
    }

getImagePathCompleted()

ilLPStatusIcons::getImagePathCompleted

(

)

Definition at line 134 of file class.ilLPStatusIcons.php.

References $image_path_completed.

Referenced by getImagePathForStatus().

                                            : string
    {
        return $this->image_path_completed;
    }

Here is the caller graph for this function:

getImagePathFailed()

ilLPStatusIcons::getImagePathFailed

(

)

Definition at line 144 of file class.ilLPStatusIcons.php.

References $image_path_failed.

Referenced by getImagePathForStatus().

                                         : string
    {
        return $this->image_path_failed;
    }

Here is the caller graph for this function:

getImagePathForStatus()

ilLPStatusIcons::getImagePathForStatus

(

int

$a_status

)

Todo:

Check whether the default can be replaced by an exception.

Definition at line 188 of file class.ilLPStatusIcons.php.

References getImagePathCompleted(), getImagePathFailed(), getImagePathInProgress(), getImagePathNotAttempted(), ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_FAILED_NUM, ilLPStatus\LP_STATUS_IN_PROGRESS_NUM, and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

Referenced by renderIconForStatus().

                                                         : string
    {
        switch ($a_status) {
            case ilLPStatus::LP_STATUS_IN_PROGRESS_NUM:
                return $this->getImagePathInProgress();

            case ilLPStatus::LP_STATUS_COMPLETED_NUM:
                return $this->getImagePathCompleted();

            case ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM:
                return $this->getImagePathNotAttempted();

            case ilLPStatus::LP_STATUS_FAILED_NUM:
                return $this->getImagePathFailed();

            default:
                return $this->getImagePathNotAttempted();
        }
    }

Here is the call graph for this function:

Here is the caller graph for this function:

getImagePathInProgress()

ilLPStatusIcons::getImagePathInProgress

(

)

Definition at line 129 of file class.ilLPStatusIcons.php.

References $image_path_in_progress.

Referenced by getImagePathForStatus().

                                             : string
    {
        return $this->image_path_in_progress;
    }

Here is the caller graph for this function:

getImagePathNotAttempted()

ilLPStatusIcons::getImagePathNotAttempted

(

)

Definition at line 139 of file class.ilLPStatusIcons.php.

References $image_path_not_attempted.

Referenced by getImagePathForStatus().

                                               : string
    {
        return $this->image_path_not_attempted;
    }

Here is the caller graph for this function:

getImagePathRunning()

ilLPStatusIcons::getImagePathRunning

(

)

A long variant of this icon is not available.

Definition at line 163 of file class.ilLPStatusIcons.php.

References $image_path_running.

                                          : string
    {
        if ($this->image_path_running) {
            return $this->image_path_running;
        }
        throw new ilLPException("A long variant of the 'running' LP icon does not exist.");
    }

getInstance()

static ilLPStatusIcons::getInstance ( int  $variant = ilLPStatusIcons::ICON_VARIANT_DEFAULT, ?\ILIAS\UI\Renderer  $renderer = null, ?\ILIAS\UI\Factory  $factory = null  )

static

Definition at line 61 of file class.ilLPStatusIcons.php.

References $DIC, $factory, $renderer, ICON_VARIANT_LONG, ICON_VARIANT_SCORM, and ICON_VARIANT_SHORT.

Referenced by ilLearningProgressBaseGUI\__appendLPDetails(), ilLPObjectStatisticsLPTableGUI\__construct(), ilLSTOCGUI\__construct(), ilLearningProgressBaseGUI\__getLegendHTML(), ilLMExplorerGUI\checkLPIcon(), ilWikiContributorsTableGUI\fillRow(), ilGroupParticipantsTableGUI\fillRow(), ilCourseParticipantsTableGUI\fillRow(), ilLPProgressTableGUI\fillRow(), ilTrUserObjectsPropsTableGUI\fillRow(), ilLPObjectStatisticsLPTableGUI\getDetailItems(), ilLMTracker\getIconForLMObject(), ilExGradesTableGUI\getIconForStatus(), ilExAssignmentGUI\getIconForStatus(), ilTrSummaryTableGUI\getItems(), ilObjExerciseGUI\getService(), ilDclRecordListTableGUI\getStatus(), ilMyStaffGUI\getUserLpStatusAsHtml(), ilLearningProgressGUI\initCollectionManualForm(), ilSCORMTrackingItemsTableGUI\parseValue(), ilSCORM2004TrackingItemsTableGUI\parseValue(), ilLPTableBaseGUI\parseValue(), ilLPStatus\preloadListGUIData(), ilPortfolioPageGUI\renderMyCourses(), ilLearningProgressGUI\showtlt(), ilLPStatusIconsTest\testGetInstanceForInvalidVariant(), and ilLPStatusIconsTest\testTripleton().

                                                                                                                                                                     : ilLPStatusIcons
    {
        if (!$renderer || !$factory) {
            global $DIC;
            $renderer = $DIC->ui()->renderer();
            $factory = $DIC->ui()->factory();
        }

        switch ($variant) {
            case ilLPStatusIcons::ICON_VARIANT_SCORM:
                if (self::$instance_variant_scorm) {
                    return self::$instance_variant_scorm;
                }
                return self::$instance_variant_scorm = new self(ilLPStatusIcons::ICON_VARIANT_SCORM, $renderer, $factory);

            case ilLPStatusIcons::ICON_VARIANT_SHORT:
                if (self::$instance_variant_short) {
                    return self::$instance_variant_short;
                }
                return self::$instance_variant_short = new self(ilLPStatusIcons::ICON_VARIANT_SHORT, $renderer, $factory);

            case ilLPStatusIcons::ICON_VARIANT_LONG:
                if (self::$instance_variant_long) {
                    return self::$instance_variant_long;
                }
                return self::$instance_variant_long = new self(ilLPStatusIcons::ICON_VARIANT_LONG, $renderer, $factory);

            default:
                throw new ilLPException("No such variant of the LP icons exists.");
        }
    }

Here is the caller graph for this function:

lookupNumStatus()

ilLPStatusIcons::lookupNumStatus

(

string

$a_status

)

Transforms the string constants for the status to their interger equivalent.

Definition at line 222 of file class.ilLPStatusIcons.php.

References ilLPStatus\LP_STATUS_COMPLETED, ilLPStatus\LP_STATUS_COMPLETED_NUM, ilLPStatus\LP_STATUS_FAILED, ilLPStatus\LP_STATUS_FAILED_NUM, ilLPStatus\LP_STATUS_IN_PROGRESS, ilLPStatus\LP_STATUS_IN_PROGRESS_NUM, ilLPStatus\LP_STATUS_NOT_ATTEMPTED, and ilLPStatus\LP_STATUS_NOT_ATTEMPTED_NUM.

                                                      : int
    {
        switch ($a_status) {
            case ilLPStatus::LP_STATUS_IN_PROGRESS:
                return ilLPStatus::LP_STATUS_IN_PROGRESS_NUM;

            case ilLPStatus::LP_STATUS_COMPLETED:
                return ilLPStatus::LP_STATUS_COMPLETED_NUM;

            case ilLPStatus::LP_STATUS_NOT_ATTEMPTED:
                return ilLPStatus::LP_STATUS_NOT_ATTEMPTED_NUM;

            case ilLPStatus::LP_STATUS_FAILED:
                return ilLPStatus::LP_STATUS_FAILED_NUM;

            default:
                throw new ilLPException("Not a valid status");
        }
    }

renderIcon()

ilLPStatusIcons::renderIcon	(	string	$path,
		string	$alt
	)

Definition at line 171 of file class.ilLPStatusIcons.php.

References getIconComponent().

Referenced by renderIconForStatus().

                                                          : string
    {
        if ($this === self::$instance_variant_scorm) {
            throw new ilLPException("SCORM variants of the LP icons cannot be rendered.");
        }

        return $this->renderer->render($this->getIconComponent($path, $alt));
    }

Here is the call graph for this function:

Here is the caller graph for this function:

renderIconForStatus()

ilLPStatusIcons::renderIconForStatus	(	int	$a_status,
		?ilLanguage	$a_lng = null
	)

Returns the rendered icon with alt text.

Definition at line 211 of file class.ilLPStatusIcons.php.

References ilLearningProgressBaseGUI\_getStatusText(), getImagePathForStatus(), and renderIcon().

                                                                                  : string
    {
        return $this->renderIcon(
            $this->getImagePathForStatus($a_status),
            ilLearningProgressBaseGUI::_getStatusText($a_status, $a_lng)
        );
    }

Here is the call graph for this function:

Field Documentation

$factory

ilLPStatusIcons::$factory

private

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

Referenced by __construct(), and getInstance().

$image_path_asset

ilLPStatusIcons::$image_path_asset = ''

private

Definition at line 49 of file class.ilLPStatusIcons.php.

Referenced by getImagePathAsset().

$image_path_completed

ilLPStatusIcons::$image_path_completed = ''

private

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

Referenced by getImagePathCompleted().

$image_path_failed

ilLPStatusIcons::$image_path_failed = ''

private

Definition at line 46 of file class.ilLPStatusIcons.php.

Referenced by getImagePathFailed().

$image_path_in_progress

ilLPStatusIcons::$image_path_in_progress = ''

private

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

Referenced by getImagePathInProgress().

$image_path_not_attempted

ilLPStatusIcons::$image_path_not_attempted = ''

private

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

Referenced by getImagePathNotAttempted().

$image_path_running

ilLPStatusIcons::$image_path_running = ''

private

Definition at line 50 of file class.ilLPStatusIcons.php.

Referenced by getImagePathRunning().

$instance_variant_long

ilLPStatusIcons::$instance_variant_long = null

staticprivate

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

$instance_variant_scorm

ilLPStatusIcons::$instance_variant_scorm = null

staticprivate

Definition at line 41 of file class.ilLPStatusIcons.php.

$instance_variant_short

ilLPStatusIcons::$instance_variant_short = null

staticprivate

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

$renderer

ilLPStatusIcons::$renderer

private

Definition at line 59 of file class.ilLPStatusIcons.php.

Referenced by __construct(), and getInstance().

ICON_VARIANT_DEFAULT

const ilLPStatusIcons::ICON_VARIANT_DEFAULT = ilLPStatusIcons::ICON_VARIANT_LONG

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

ICON_VARIANT_LONG

const ilLPStatusIcons::ICON_VARIANT_LONG = 0

Definition at line 25 of file class.ilLPStatusIcons.php.

Referenced by ilLearningProgressBaseGUI\__appendLPDetails(), __construct(), ilWikiContributorsTableGUI\fillRow(), ilGroupParticipantsTableGUI\fillRow(), ilCourseParticipantsTableGUI\fillRow(), ilLPProgressTableGUI\fillRow(), ilTrUserObjectsPropsTableGUI\fillRow(), ilLPObjectStatisticsLPTableGUI\getDetailItems(), ilExGradesTableGUI\getIconForStatus(), getInstance(), ilObjExerciseGUI\getService(), ilDclRecordListTableGUI\getStatus(), ilMyStaffGUI\getUserLpStatusAsHtml(), ilLearningProgressGUI\initCollectionManualForm(), ilLPStatus\preloadListGUIData(), ilPortfolioPageGUI\renderMyCourses(), ilLearningProgressGUI\showtlt(), and ilLPStatusIconsTest\testTripleton().

ICON_VARIANT_SCORM

const ilLPStatusIcons::ICON_VARIANT_SCORM = 2

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

Referenced by __construct(), getInstance(), ilSCORMTrackingItemsTableGUI\parseValue(), ilSCORM2004TrackingItemsTableGUI\parseValue(), and ilLPStatusIconsTest\testTripleton().

ICON_VARIANT_SHORT

const ilLPStatusIcons::ICON_VARIANT_SHORT = 1

Definition at line 26 of file class.ilLPStatusIcons.php.

Referenced by ilLPObjectStatisticsLPTableGUI\__construct(), ilLSTOCGUI\__construct(), __construct(), ilLPListOfObjectsGUI\__listObjects(), ilLMExplorerGUI\checkLPIcon(), ilLMTracker\getIconForLMObject(), getInstance(), ilTrSummaryTableGUI\getItems(), ilExAssignmentGUI\getOverviewHeader(), ilLPListOfObjectsGUI\showObjectSummary(), and ilLPStatusIconsTest\testTripleton().

---

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

• Services/Tracking/classes/status/class.ilLPStatusIcons.php