@classDescription Settings for members view More...

Collaboration diagram for ilMemberViewSettings:

Public Member Functions
	getContainer ()

	getCurrentRefId ()

	setContainer (int $container)

	isActive ()
	Check if member view currently enabled. More...

	isActiveForRefId (int $a_ref_id)
	Check if member view is currently enabled for given ref id. More...

	activate (int $a_ref_id)
	Enable member view for this session and container. More...

	deactivate ()
	Deactivate member view. More...

	toggleActivation (int $a_ref_id, bool $a_activation)
	Toggle activation status. More...

	isEnabled ()
	Check if members view is enabled in the administration. More...

Static Public Member Functions
static	getInstance ()

Data Fields
const	SESSION_MEMBER_VIEW_CONTAINER = 'member_view_container'

Protected Member Functions
	read ()
	Read settings. More...

	findEffectiveRefId ()
	Find effective ref_id for request. More...

Protected Attributes
	$logger

	$request

	$ctrl

	$tree

	$settings

Private Member Functions
	__construct ()
	Constructor (singleton) More...

Private Attributes
	$active = false

	$enabled = false

	$container = null

	$container_items = array()

	$current_ref_id = 0

Static Private Attributes
static	$instance = null

Detailed Description

@classDescription Settings for members view

Author: Stefan Meyer meyer.nosp@m.@lei.nosp@m.fos.c.nosp@m.om

Definition at line 31 of file class.ilMemberViewSettings.php.

Constructor & Destructor Documentation

◆ __construct()

ilMemberViewSettings::__construct ( )

private

Constructor (singleton)

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

    {
        global $DIC;
 
        $this->tree = $DIC->repositoryTree();
        $this->settings = $DIC->settings();
        $this->request = $DIC->http()->request();
        $this->ctrl = $DIC->ctrl();
        $this->logger = $DIC->logger()->cont();
        $this->read();
    }

References $DIC, read(), and settings().

Here is the call graph for this function:

Member Function Documentation

◆ activate()

ilMemberViewSettings::activate ( int $a_ref_id )

Enable member view for this session and container.

Parameters

int $a_ref_id

Definition at line 196 of file class.ilMemberViewSettings.php.

                                            : void
    {
        $this->active = true;
        $this->setContainer($a_ref_id);
    }

References setContainer().

Referenced by toggleActivation().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deactivate()

ilMemberViewSettings::deactivate ( )

Deactivate member view.

Returns

Definition at line 206 of file class.ilMemberViewSettings.php.

                                 : void
    {
        $this->active = false;
        $this->container = null;
        ilSession::clear(self::SESSION_MEMBER_VIEW_CONTAINER);
    }

References ilSession\clear().

Referenced by read(), and toggleActivation().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ findEffectiveRefId()

ilMemberViewSettings::findEffectiveRefId ( )

protected

Find effective ref_id for request.

Definition at line 268 of file class.ilMemberViewSettings.php.

    {
        if ($this->ctrl->isAsynch()) {
            // Ignore asynchronous requests
            return;
        }
 
        $ref_id = (int) $this->request->getQueryParams()['ref_id'] ?? 0;
        if ($ref_id) {
            return $this->current_ref_id = $ref_id;
        }
        $target_str = (string) $this->request->getQueryParams()['target'] ?? '';
        if (strlen($target_str)) {
            $target_arr = explode('_', (string) $target_str);
            if (isset($target_arr[1]) && (int) $target_arr[1]) {
                $this->current_ref_id = (int) $target_arr[1];
            }
        }
    }

References $target_arr.

Referenced by read().

Here is the caller graph for this function:

◆ getContainer()

ilMemberViewSettings::getContainer ( )

Returns: int|null

Definition at line 120 of file class.ilMemberViewSettings.php.

                                   : ?int
    {
        return $this->container;
    }

References $container.

Referenced by isActive(), isActiveForRefId(), and read().

Here is the caller graph for this function:

◆ getCurrentRefId()

ilMemberViewSettings::getCurrentRefId ( )

Returns: int

Definition at line 128 of file class.ilMemberViewSettings.php.

                                      : int
    {
        return $this->current_ref_id;
    }

References $current_ref_id.

Referenced by isActive(), and read().

Here is the caller graph for this function:

◆ getInstance()

static ilMemberViewSettings::getInstance ( )

static

Returns: ilMemberViewSettings

Definition at line 109 of file class.ilMemberViewSettings.php.

                                         : ilMemberViewSettings
    {
        if (self::$instance != null) {
            return self::$instance;
        }
        return self::$instance = new ilMemberViewSettings();
    }

References $instance.

Referenced by ilMainMenuGUI\__construct(), ilConditionHandler\_checkAllConditionsOfTarget(), ilObjCourseAccess\_isActivated(), ilInfoScreenGUI\addPreconditionSection(), ilObjCourseGUI\checkAgreement(), ilObjGroupGUI\checkAgreement(), ILIAS\Container\Screen\MemberViewLayoutProvider\getMemberViewModeInfo(), ilRbacSystem\initMemberView(), ilMainMenuGUI\initMemberView(), ilCache\isDisabled(), ilObjectListGUI\parseConditions(), ilObjCourseGUI\prepareOutput(), ilMemberViewGUI\showMemberViewSwitch(), and ilContainerGUI\showTreeFlatIcon().

Here is the caller graph for this function:

◆ isActive()

ilMemberViewSettings::isActive ( )

Check if member view currently enabled.

Returns: bool

Definition at line 147 of file class.ilMemberViewSettings.php.

                               : bool
    {
        static $mv_status;
        if (!isset($mv_status)) {
            if (!$this->active) {
                // Not active
                return $mv_status = false;
            }
 
            if (!$this->getCurrentRefId()) {
                // No ref id given => mail, search, personal desktop menu in other tab
                return $mv_status = false;
            }
 
            if (!in_array($this->getCurrentRefId(), $this->container_items) and
                $this->getContainer() != $this->getCurrentRefId()
            ) {
                // outside of course
                return $mv_status = false;
            }
            return $mv_status = true;
        }
 
        return $mv_status;
    }

References getContainer(), and getCurrentRefId().

Here is the call graph for this function:

◆ isActiveForRefId()

ilMemberViewSettings::isActiveForRefId ( int $a_ref_id )

Check if member view is currently enabled for given ref id.

Parameters

int $a_ref_id

Returns: bool

Definition at line 178 of file class.ilMemberViewSettings.php.

                                                    : bool
    {
        if (!$this->active || !(int) $a_ref_id) {
            return false;
        }
        
        if (
            !in_array($a_ref_id, $this->container_items) &&
            $this->getContainer() != $a_ref_id) {
            return false;
        }
        return true;
    }

References getContainer().

Here is the call graph for this function:

◆ isEnabled()

ilMemberViewSettings::isEnabled ( )

Check if members view is enabled in the administration.

Returns: bool

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

                                : bool
    {
        return (bool) $this->enabled;
    }

References $enabled.

◆ read()

ilMemberViewSettings::read ( )

protected

Read settings.

Definition at line 239 of file class.ilMemberViewSettings.php.

                              : void
    {
        $current_ref_id = $this->findEffectiveRefId();
        
        // member view is always enabled
        // (2013-06-18, http://www.ilias.de/docu/goto_docu_wiki_1357_Reorganising_Administration.html)
 
        // $this->enabled = $ilSetting->get('preview_learner');
        $this->enabled = true;
 
        if (ilSession::get(self::SESSION_MEMBER_VIEW_CONTAINER)) {
            $this->active = true;
            $this->container = (int) ilSession::get(self::SESSION_MEMBER_VIEW_CONTAINER);
            $this->container_items = $this->tree->getSubTreeIds($this->getContainer());
 
            // deactivate if out of scope
            if (
                $this->getCurrentRefId() &&
                !in_array($this->getCurrentRefId(), $this->container_items) &&
                $this->getCurrentRefId() != $this->getContainer()
            ) {
                $this->deactivate();
            }
        }
    }

References $current_ref_id, deactivate(), findEffectiveRefId(), ilSession\get(), getContainer(), and getCurrentRefId().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setContainer()

ilMemberViewSettings::setContainer ( int $container )

Parameters

int $container

Definition at line 136 of file class.ilMemberViewSettings.php.

    {
        $this->container = $container;
        ilSession::set(self::SESSION_MEMBER_VIEW_CONTAINER, $this->container);
        ilSession::set('il_cont_admin_panel', false);
    }

References $container, and ilSession\set().

Referenced by activate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ toggleActivation()

ilMemberViewSettings::toggleActivation	(	int	$a_ref_id,
		bool	$a_activation
	)

Toggle activation status.

Parameters

int	$a_ref_id
bool	$a_activation

Definition at line 218 of file class.ilMemberViewSettings.php.

                                                                        : void
    {
        if ($a_activation) {
            $this->activate($a_ref_id);
        } else {
            $this->deactivate($a_ref_id);
        }
    }