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 ()

	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
ilLogger	$logger

RequestInterface	$request

ilCtrl	$ctrl

ilTree	$tree

ilSetting	$settings

Container Service	$container_service

Private Member Functions
	__construct ()

Private Attributes
bool	$active = false

bool	$enabled = false

int	$container = null

array	$container_items = []

int	$current_ref_id = 0

Static Private Attributes
static ilMemberViewSettings	$instance = null

Detailed Description

Settings for members view.

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

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

Constructor & Destructor Documentation

◆ __construct()

ilMemberViewSettings::__construct ( )

private

Definition at line 42 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();
        $this->container_service = $DIC->container();
    }

References $DIC, ILIAS\Repository\ctrl(), ILIAS\Repository\logger(), read(), and ILIAS\Repository\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.

Definition at line 131 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 ( )

Definition at line 137 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 196 of file class.ilMemberViewSettings.php.

                                           : int
    {
        if ($this->ctrl->isAsynch()) {
            // Ignore asynchronous requests
            return 0;
        }
 
        $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 ($target_str !== '') {
            $target_arr = explode('_', $target_str);
            if (isset($target_arr[1]) && (int) $target_arr[1]) {
                $this->current_ref_id = (int) $target_arr[1];
            }
        }
        return 0;
    }

References $ref_id, $target_arr, ILIAS\Repository\ctrl(), and ILIAS\Repository\int().

Referenced by read().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getContainer()

ilMemberViewSettings::getContainer ( )

Definition at line 60 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 ( )

Definition at line 65 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

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

                                        : ilMemberViewSettings
    {
        return self::$instance ?? (self::$instance = new ilMemberViewSettings());
    }

Referenced by ilObjCourseAccess\_isActivated(), ilObjCourseGUI\checkAgreement(), ilObjGroupGUI\checkAgreement(), ILIAS\Container\Screen\MemberViewLayoutProvider\getMemberViewModeInfo(), ilRbacSystem\initMemberView(), ilCache\isDisabled(), ilObjectListGUI\parseConditions(), ilObjCourseGUI\prepareOutput(), and ilMemberViewGUI\showMemberViewSwitch().

Here is the caller graph for this function:

◆ isActive()

ilMemberViewSettings::isActive ( )

Check if member view currently enabled.

Definition at line 85 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) &&
                $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.

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

                                                   : bool
    {
        if (!$this->active || !$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.

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

                               : bool
    {
        return $this->enabled;
    }

References $enabled.

◆ read()

ilMemberViewSettings::read ( )

protected

Read settings.

Definition at line 167 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(), getCurrentRefId(), and ILIAS\Repository\int().

Referenced by __construct().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setContainer()

ilMemberViewSettings::setContainer ( int $container )

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

                                                : void
    {
        $this->container = $container;
        ilSession::set(self::SESSION_MEMBER_VIEW_CONTAINER, $this->container);
        $this->container_service
            ->internal()
            ->domain()
            ->content()
            ->view()
            ->setContentView();
    }

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.

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

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