Collaboration diagram for ilAssQuestionPreviewHintTracking:

Public Member Functions
	__construct (ilDBInterface $db, ilAssQuestionPreviewSession $previewSession)

	requestsExist ()

	requestsPossible ()

	getNextRequestableHint ()

	storeRequest (ilAssQuestionHint $questionHint)

	isRequested ($hintId)

	getNumExistingRequests ()

	getRequestedHintsList ()

	getRequestStatisticData ()

Private Attributes
	$db

	$previewSession

Detailed Description

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

Constructor & Destructor Documentation

◆ __construct()

ilAssQuestionPreviewHintTracking::__construct	(	ilDBInterface	$db,
		ilAssQuestionPreviewSession	$previewSession
	)

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

    {
        $this->db = $db;
        $this->previewSession = $previewSession;
    }

References $db, and $previewSession.

Member Function Documentation

◆ getNextRequestableHint()

ilAssQuestionPreviewHintTracking::getNextRequestableHint ( )

Definition at line 73 of file class.ilAssQuestionPreviewHintTracking.php.

                                            : ilAssQuestionHint
    {
        $query = "
                        SELECT          qht_hint_id
                        
                        FROM            qpl_hints
                        
                        WHERE           qht_question_fi = %s
                        
                        ORDER BY        qht_hint_index ASC
                ";
 
        $res = $this->db->queryF(
            $query,
            array('integer'),
            array($this->previewSession->getQuestionId())
        );
 
        while ($row = $this->db->fetchAssoc($res)) {
            if (!$this->isRequested($row['qht_hint_id'])) {
                return ilAssQuestionHint::getInstanceById($row['qht_hint_id']);
            }
        }
 
        throw new ilTestException(
            "no next hint found for questionId={$this->previewSession->getQuestionId()}, userId={$this->previewSession->getUserId()}"
        );
    }

References $query, $res, ilAssQuestionHint\getInstanceById(), and isRequested().

Here is the call graph for this function:

◆ getNumExistingRequests()

ilAssQuestionPreviewHintTracking::getNumExistingRequests ( )

Definition at line 112 of file class.ilAssQuestionPreviewHintTracking.php.

                                            : int
    {
        return $this->previewSession->getNumRequestedHints();
    }

◆ getRequestedHintsList()

ilAssQuestionPreviewHintTracking::getRequestedHintsList ( )

Definition at line 117 of file class.ilAssQuestionPreviewHintTracking.php.

                                           : ilAssQuestionHintList
    {
        $hintIds = $this->previewSession->getRequestedHints();
 
        $requestedHintsList = ilAssQuestionHintList::getListByHintIds($hintIds);
 
        return $requestedHintsList;
    }

References ilAssQuestionHintList\getListByHintIds().

Referenced by getRequestStatisticData().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getRequestStatisticData()

ilAssQuestionPreviewHintTracking::getRequestStatisticData ( )

Definition at line 126 of file class.ilAssQuestionPreviewHintTracking.php.

                                             : ilAssQuestionHintRequestStatisticData
    {
        $count = 0;
        $points = 0;
 
        foreach ($this->getRequestedHintsList() as $hint) {
            $count++;
            $points += $hint->getPoints();
        }
 
        $requestsStatisticData = new ilAssQuestionHintRequestStatisticData();
        $requestsStatisticData->setRequestsCount($count);
        $requestsStatisticData->setRequestsPoints($points);
 
        return $requestsStatisticData;
    }

References getRequestedHintsList().

Here is the call graph for this function:

◆ isRequested()

ilAssQuestionPreviewHintTracking::isRequested ( $hintId )

Definition at line 107 of file class.ilAssQuestionPreviewHintTracking.php.

                                        : bool
    {
        return $this->previewSession->isHintRequested($hintId);
    }

Referenced by getNextRequestableHint().

Here is the caller graph for this function:

◆ requestsExist()

ilAssQuestionPreviewHintTracking::requestsExist ( )

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

                                   : bool
    {
        return (
            $this->previewSession->getNumRequestedHints() > 0
        );
    }

◆ requestsPossible()

ilAssQuestionPreviewHintTracking::requestsPossible ( )

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

                                      : bool
    {
        $query = "
                        SELECT          COUNT(qht_hint_id) cnt_available
                        FROM            qpl_hints
                        WHERE           qht_question_fi = %s
                ";
 
        $res = $this->db->queryF(
            $query,
            array('integer'),
            array($this->previewSession->getQuestionId())
        );
 
        $row = $this->db->fetchAssoc($res);
 
        if ($row['cnt_available'] > $this->previewSession->getNumRequestedHints()) {
            return true;
        }
 
        return false;
    }

References $query, and $res.

◆ storeRequest()

ilAssQuestionPreviewHintTracking::storeRequest ( ilAssQuestionHint $questionHint )

Definition at line 102 of file class.ilAssQuestionPreviewHintTracking.php.

                                                                 : void
    {
        $this->previewSession->addRequestedHint($questionHint->getId());
    }