ILIAS  release_5-1 Revision 5.0.0-5477-g43f3e3fab5f
class.ilAssQuestionPreviewHintTracking.php
Go to the documentation of this file.
1<?php
2/* Copyright (c) 1998-2013 ILIAS open source, Extended GPL, see docs/LICENSE */
3
4
12{
16 private $db;
17
22
24 {
25 $this->db = $db;
26 $this->previewSession = $previewSession;
27 }
28
29 public function requestsExist()
30 {
31 return (
32 $this->previewSession->getNumRequestedHints() > 0
33 );
34 }
35
36 public function requestsPossible()
37 {
38 $query = "
39 SELECT COUNT(qht_hint_id) cnt_available
40 FROM qpl_hints
41 WHERE qht_question_fi = %s
42 ";
43
44 $res = $this->db->queryF(
45 $query, array('integer'), array($this->previewSession->getQuestionId())
46 );
47
48 $row = $this->db->fetchAssoc($res);
49
50 if( $row['cnt_available'] > $this->previewSession->getNumRequestedHints() )
51 {
52 return true;
53 }
54
55 return false;
56 }
57
58 public function getNextRequestableHint()
59 {
60 $query = "
61 SELECT qht_hint_id
62
63 FROM qpl_hints
64
65 WHERE qht_question_fi = %s
66
67 ORDER BY qht_hint_index ASC
68 ";
69
70 $res = $this->db->queryF(
71 $query, array('integer'), array($this->previewSession->getQuestionId())
72 );
73
74 while( $row = $this->db->fetchAssoc($res) )
75 {
76 if( !$this->isRequested($row['qht_hint_id']) )
77 {
78 return ilAssQuestionHint::getInstanceById($row['qht_hint_id']);
79 }
80 }
81
82 throw new ilTestException(
83 "no next hint found for questionId={$this->previewSession->getQuestionId()}, userId={$this->previewSession->getUserId()}"
84 );
85 }
86
87 public function storeRequest(ilAssQuestionHint $questionHint)
88 {
89 $this->previewSession->addRequestedHint($questionHint->getId());
90 }
91
92 public function isRequested($hintId)
93 {
94 return $this->previewSession->isHintRequested($hintId);
95 }
96
97 public function getNumExistingRequests()
98 {
99 return $this->previewSession->getNumRequestedHints();
100 }
101
102 public function getRequestedHintsList()
103 {
104 $hintIds = $this->previewSession->getRequestedHints();
105
106 $requestedHintsList = ilAssQuestionHintList::getListByHintIds($hintIds);
107
108 return $requestedHintsList;
109 }
110}
static getListByHintIds($hintIds)
instantiates a question hint list for the passed hint ids
static getInstanceById($hintId)
creates a hint object instance, loads the persisted hint dataset identified by passed hint id from da...
getId()
returns the hint id
__construct(ilDB $db, ilAssQuestionPreviewSession $previewSession)
Database Wrapper.
Definition: class.ilDB.php:29
Base Exception for all Exceptions relating to Modules/Test.