Collaboration diagram for ilAssQuestionPreviewSession:

Public Member Functions
	__construct ($userId, $questionId)

	init ()

	getUserId ()

	getQuestionId ()

	setInstantResponseActive ($instantResponseActive)

	isInstantResponseActive ()

	setParticipantsSolution ($participantSolution)

	getParticipantsSolution ()

	hasParticipantSolution ()

	getNumRequestedHints ()

	isHintRequested ($hintId)

	addRequestedHint ($hintId)

	getRequestedHints ()

	resetRequestedHints ()

	setRandomizerSeed ($seed)

	getRandomizerSeed ()

	randomizerSeedExists ()

Data Fields
const	SESSION_BASEINDEX = 'ilAssQuestionPreviewSessions'

const	SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE = 'instantResponseActive'

const	SESSION_SUBINDEX_PARTICIPANT_SOLUTION = 'participantSolution'

const	SESSION_SUBINDEX_REQUESTED_HINTS = 'requestedHints'

const	SESSION_SUBINDEX_RANDOMIZER_SEED = 'randomizerSeed'

Private Member Functions
	getSessionContextIndex ()

	saveSessionValue ($subIndex, $value)

	issetSessionValue ($subIndex)

	readSessionValue ($subIndex)

	ensureSessionStructureExists ()

Private Attributes
	$userId

	$questionId

Detailed Description

Definition at line 24 of file class.ilAssQuestionPreviewSession.php.

Constructor & Destructor Documentation

◆ __construct()

ilAssQuestionPreviewSession::__construct	(	$userId,
		$questionId
	)

Definition at line 36 of file class.ilAssQuestionPreviewSession.php.

    {
        $this->userId = $userId;
        $this->questionId = $questionId;
    }

References $questionId, and $userId.

Member Function Documentation

◆ addRequestedHint()

ilAssQuestionPreviewSession::addRequestedHint ( $hintId )

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

                                             : void
    {
        $requestedHints = $this->getRequestedHints();
        $requestedHints[$hintId] = $hintId;
        $this->saveSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS, $requestedHints);
    }

References getRequestedHints(), and saveSessionValue().

Here is the call graph for this function:

◆ ensureSessionStructureExists()

ilAssQuestionPreviewSession::ensureSessionStructureExists ( )

private

Definition at line 167 of file class.ilAssQuestionPreviewSession.php.

                                                   : void
    {
        if (!is_array(ilSession::get(self::SESSION_BASEINDEX))) {
            ilSession::set(self::SESSION_BASEINDEX, array());
        }
 
        $baseSession = ilSession::get(self::SESSION_BASEINDEX);
 
        if (!isset($baseSession[$this->getSessionContextIndex()])) {
            $baseSession[$this->getSessionContextIndex()] = array();
        }
 
        $contextSession = &$baseSession[$this->getSessionContextIndex()];
 
        if (!isset($contextSession[self::SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE])) {
            $contextSession[self::SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE] = 0;
        }
 
        if (!isset($contextSession[self::SESSION_SUBINDEX_PARTICIPANT_SOLUTION])) {
            $contextSession[self::SESSION_SUBINDEX_PARTICIPANT_SOLUTION] = null;
        }
 
        if (!isset($contextSession[self::SESSION_SUBINDEX_RANDOMIZER_SEED])) {
            $contextSession[self::SESSION_SUBINDEX_RANDOMIZER_SEED] = null;
        }
 
        ilSession::set(self::SESSION_BASEINDEX, $baseSession);
    }

References ilSession\get(), getSessionContextIndex(), SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE, SESSION_SUBINDEX_PARTICIPANT_SOLUTION, SESSION_SUBINDEX_RANDOMIZER_SEED, and ilSession\set().

Referenced by init().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getNumRequestedHints()

ilAssQuestionPreviewSession::getNumRequestedHints ( )

Definition at line 106 of file class.ilAssQuestionPreviewSession.php.

                                          : int
    {
        if (!$this->issetSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS)) {
            return 0;
        }
        $hints = $this->readSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS);
 
        if (!is_array($hints)) {
            return 0;
        }
 
        return count($hints);
    }

References issetSessionValue(), and readSessionValue().

Here is the call graph for this function:

◆ getParticipantsSolution()

ilAssQuestionPreviewSession::getParticipantsSolution ( )

Definition at line 96 of file class.ilAssQuestionPreviewSession.php.

    {
        return $this->readSessionValue(self::SESSION_SUBINDEX_PARTICIPANT_SOLUTION) == [] ? null : $this->readSessionValue(self::SESSION_SUBINDEX_PARTICIPANT_SOLUTION);
    }

References readSessionValue().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getQuestionId()

ilAssQuestionPreviewSession::getQuestionId ( )

Definition at line 52 of file class.ilAssQuestionPreviewSession.php.

    {
        return $this->questionId;
    }

References $questionId.

◆ getRandomizerSeed()

ilAssQuestionPreviewSession::getRandomizerSeed ( )

Definition at line 156 of file class.ilAssQuestionPreviewSession.php.

                                       : ?int
    {
        $val = $this->readSessionValue(self::SESSION_SUBINDEX_RANDOMIZER_SEED);
        return $val === [] ? null : $val;
    }

References readSessionValue().

Referenced by randomizerSeedExists().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRequestedHints()

ilAssQuestionPreviewSession::getRequestedHints ( )

Definition at line 137 of file class.ilAssQuestionPreviewSession.php.

    {
        if ($this->issetSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS)) {
            return $this->readSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS);
        }
 
        return [];
    }

References issetSessionValue(), and readSessionValue().

Referenced by addRequestedHint().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSessionContextIndex()

ilAssQuestionPreviewSession::getSessionContextIndex ( )

private

Definition at line 57 of file class.ilAssQuestionPreviewSession.php.

                                             : string
    {
        return "u{$this->userId}::q{$this->questionId}";
    }

Referenced by ensureSessionStructureExists(), issetSessionValue(), readSessionValue(), and saveSessionValue().

Here is the caller graph for this function:

◆ getUserId()

ilAssQuestionPreviewSession::getUserId ( )

Definition at line 47 of file class.ilAssQuestionPreviewSession.php.

    {
        return $this->userId;
    }

References $userId.

Referenced by assFileUpload\savePreviewData().

Here is the caller graph for this function:

◆ hasParticipantSolution()

ilAssQuestionPreviewSession::hasParticipantSolution ( )

Definition at line 101 of file class.ilAssQuestionPreviewSession.php.

                                            : bool
    {
        return $this->issetSessionValue(self::SESSION_SUBINDEX_PARTICIPANT_SOLUTION);
    }

References issetSessionValue().

Referenced by assOrderingQuestion\calculateReachedPointsFromPreviewSession().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ init()

ilAssQuestionPreviewSession::init ( )

Definition at line 42 of file class.ilAssQuestionPreviewSession.php.

                          : void
    {
        $this->ensureSessionStructureExists();
    }

References ensureSessionStructureExists().

Here is the call graph for this function:

◆ isHintRequested()

ilAssQuestionPreviewSession::isHintRequested ( $hintId )

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

                                            : bool
    {
        if ($this->issetSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS)) {
            $requestedHints = $this->readSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS);
            return isset($requestedHints[$hintId]);
        }
 
        return false;
    }

References issetSessionValue(), and readSessionValue().

Here is the call graph for this function:

◆ isInstantResponseActive()

ilAssQuestionPreviewSession::isInstantResponseActive ( )

Definition at line 86 of file class.ilAssQuestionPreviewSession.php.

    {
        return $this->readSessionValue(self::SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE);
    }

References readSessionValue().

Here is the call graph for this function:

◆ issetSessionValue()

ilAssQuestionPreviewSession::issetSessionValue ( $subIndex )

private

Definition at line 69 of file class.ilAssQuestionPreviewSession.php.

                                                 : bool
    {
        $val = ilSession::get(self::SESSION_BASEINDEX);
        return isset($val[$this->getSessionContextIndex()][$subIndex]);
    }

References ilSession\get(), and getSessionContextIndex().

Referenced by getNumRequestedHints(), getRequestedHints(), hasParticipantSolution(), and isHintRequested().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ randomizerSeedExists()

ilAssQuestionPreviewSession::randomizerSeedExists ( )

Definition at line 162 of file class.ilAssQuestionPreviewSession.php.

                                          : bool
    {
        return ($this->getRandomizerSeed() !== null);
    }

References getRandomizerSeed().

Here is the call graph for this function:

◆ readSessionValue()

ilAssQuestionPreviewSession::readSessionValue ( $subIndex )

private

Definition at line 75 of file class.ilAssQuestionPreviewSession.php.

    {
        $val = ilSession::get(self::SESSION_BASEINDEX);
        return $val[$this->getSessionContextIndex()][$subIndex] ?? [];
    }

References ilSession\get(), and getSessionContextIndex().

Referenced by getNumRequestedHints(), getParticipantsSolution(), getRandomizerSeed(), getRequestedHints(), isHintRequested(), and isInstantResponseActive().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetRequestedHints()

ilAssQuestionPreviewSession::resetRequestedHints ( )

Definition at line 146 of file class.ilAssQuestionPreviewSession.php.

                                         : void
    {
        $this->saveSessionValue(self::SESSION_SUBINDEX_REQUESTED_HINTS, array());
    }

References saveSessionValue().

Here is the call graph for this function:

◆ saveSessionValue()

ilAssQuestionPreviewSession::saveSessionValue	(	$subIndex,
		$value
	)

private

Definition at line 62 of file class.ilAssQuestionPreviewSession.php.

                                                        : void
    {
        $val = ilSession::get(self::SESSION_BASEINDEX);
        $val[$this->getSessionContextIndex()][$subIndex] = $value;
        ilSession::set(self::SESSION_BASEINDEX, $val);
    }

References ilSession\get(), getSessionContextIndex(), and ilSession\set().

Referenced by addRequestedHint(), resetRequestedHints(), setInstantResponseActive(), setParticipantsSolution(), and setRandomizerSeed().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setInstantResponseActive()

ilAssQuestionPreviewSession::setInstantResponseActive ( $instantResponseActive )

Definition at line 81 of file class.ilAssQuestionPreviewSession.php.

                                                                    : void
    {
        $this->saveSessionValue(self::SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE, $instantResponseActive);
    }

References saveSessionValue().

Here is the call graph for this function:

◆ setParticipantsSolution()

ilAssQuestionPreviewSession::setParticipantsSolution ( $participantSolution )

Definition at line 91 of file class.ilAssQuestionPreviewSession.php.

                                                                 : void
    {
        $this->saveSessionValue(self::SESSION_SUBINDEX_PARTICIPANT_SOLUTION, $participantSolution);
    }

References saveSessionValue().

Referenced by assErrorText\savePreviewData(), assFileUpload\savePreviewData(), assFormulaQuestion\savePreviewData(), assImagemapQuestion\savePreviewData(), assLongMenu\savePreviewData(), assMatchingQuestion\savePreviewData(), assNumeric\savePreviewData(), assOrderingQuestion\savePreviewData(), assQuestion\savePreviewData(), and assSingleChoice\savePreviewData().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setRandomizerSeed()

ilAssQuestionPreviewSession::setRandomizerSeed ( $seed )

Definition at line 151 of file class.ilAssQuestionPreviewSession.php.

                                            : void
    {
        $this->saveSessionValue(self::SESSION_SUBINDEX_RANDOMIZER_SEED, $seed);
    }

References saveSessionValue().

Here is the call graph for this function:

Field Documentation

◆ $questionId

ilAssQuestionPreviewSession::$questionId

private

Definition at line 34 of file class.ilAssQuestionPreviewSession.php.

Referenced by __construct(), and getQuestionId().

◆ $userId

ilAssQuestionPreviewSession::$userId

private

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

Referenced by __construct(), and getUserId().

◆ SESSION_BASEINDEX

const ilAssQuestionPreviewSession::SESSION_BASEINDEX = 'ilAssQuestionPreviewSessions'

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

◆ SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE

const ilAssQuestionPreviewSession::SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE = 'instantResponseActive'

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

Referenced by ensureSessionStructureExists().

◆ SESSION_SUBINDEX_PARTICIPANT_SOLUTION

const ilAssQuestionPreviewSession::SESSION_SUBINDEX_PARTICIPANT_SOLUTION = 'participantSolution'

Definition at line 29 of file class.ilAssQuestionPreviewSession.php.

Referenced by ensureSessionStructureExists().

◆ SESSION_SUBINDEX_RANDOMIZER_SEED

const ilAssQuestionPreviewSession::SESSION_SUBINDEX_RANDOMIZER_SEED = 'randomizerSeed'

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

Referenced by ensureSessionStructureExists().

◆ SESSION_SUBINDEX_REQUESTED_HINTS

const ilAssQuestionPreviewSession::SESSION_SUBINDEX_REQUESTED_HINTS = 'requestedHints'

Definition at line 30 of file class.ilAssQuestionPreviewSession.php.

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

Modules/TestQuestionPool/classes/class.ilAssQuestionPreviewSession.php

Public Member Functions

Data Fields

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addRequestedHint()

◆ ensureSessionStructureExists()

◆ getNumRequestedHints()

◆ getParticipantsSolution()

◆ getQuestionId()

◆ getRandomizerSeed()

◆ getRequestedHints()

◆ getSessionContextIndex()

◆ getUserId()

◆ hasParticipantSolution()

◆ init()

◆ isHintRequested()

◆ isInstantResponseActive()

◆ issetSessionValue()

◆ randomizerSeedExists()

◆ readSessionValue()

◆ resetRequestedHints()

◆ saveSessionValue()

◆ setInstantResponseActive()

◆ setParticipantsSolution()

◆ setRandomizerSeed()

Field Documentation

◆ $questionId

◆ $userId

◆ SESSION_BASEINDEX

◆ SESSION_SUBINDEX_INSTANT_RESPONSE_ACTIVE

◆ SESSION_SUBINDEX_PARTICIPANT_SOLUTION

◆ SESSION_SUBINDEX_RANDOMIZER_SEED

◆ SESSION_SUBINDEX_REQUESTED_HINTS