Class for image map questions. More...
Inheritance diagram for ASS_ImagemapQuestion:
Collaboration diagram for ASS_ImagemapQuestion:
Public Member Functions | |
| ASS_ImagemapQuestion ($title="", $comment="", $author="", $owner=-1, $question="", $imagemap_filename="", $image_filename="") | |
| ASS_ImagemapQuestion constructor. | |
| isComplete () | |
| Returns true, if a imagemap question is complete for use. | |
| saveToDb ($original_id="") | |
| Saves a ASS_ImagemapQuestion object to a database. | |
| duplicate ($for_test=true, $title="", $author="", $owner="") | |
| Duplicates an ASS_ImagemapQuestion. | |
| duplicateImage ($question_id) | |
| loadFromDb ($question_id) | |
| Loads a ASS_ImagemapQuestion object from a database. | |
| addAnswer ($answertext, $points, $answerorder, $correctness, $coords, $area) | |
| Adds an answer to the question. | |
| from_xml ($xml_text) | |
| Imports a question from XML. | |
| to_xml ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false) | |
| Returns a QTI xml representation of the question. | |
| get_question () | |
| Gets the imagemap question. | |
| set_question ($question="") | |
| Sets the imagemap question. | |
| get_imagemap_filename () | |
| Gets the imagemap file name. | |
| set_imagemap_filename ($imagemap_filename, $imagemap_tempfilename="") | |
| Sets the imagemap file name. | |
| get_image_filename () | |
| Gets the image file name. | |
| set_image_filename ($image_filename, $image_tempfilename="") | |
| Sets the image file name. | |
| get_imagemap_contents ($href="#") | |
| Gets the imagemap file contents. | |
| add_answer ($answertext="", $points=0.0, $status=0, $order=0, $coords="", $area="") | |
| Adds a possible answer for a imagemap question. | |
| get_answer_count () | |
| Returns the number of answers. | |
| get_answer ($index=0) | |
| Returns an answer. | |
| deleteArea ($index=0) | |
| Deletes an answer. | |
| flush_answers () | |
| Deletes all answers. | |
| getMaximumPoints () | |
| Returns the maximum points, a learner can reach answering the question. | |
| calculateReachedPoints ($user_id, $test_id) | |
| Returns the points, a learner has reached answering the question. | |
| getReachedInformation ($user_id, $test_id) | |
| Returns the evaluation data, a learner has entered to answer the question. | |
| saveWorkingData ($test_id, $limit_to=LIMIT_NO_LIMIT) | |
| Saves the learners input of the question to the database. | |
| syncWithOriginal () | |
| getQuestionType () | |
| Returns the question type of the question. | |
Data Fields | |
| $question | |
| $answers | |
| $imagemap_filename | |
| $image_filename | |
| $imagemap_contents | |
| $coords | |
Detailed Description
Class for image map questions.
ASS_ImagemapQuestion is a class for imagemap question.
- Version:
- Id:
- class.assImagemapQuestion.php 10723 2006-05-03 06:39:30Z hschottm
class.assImagemapQuestion.php Assessment
Definition at line 39 of file class.assImagemapQuestion.php.
Member Function Documentation
| ASS_ImagemapQuestion::add_answer | ( | $ | answertext = "", |
|
| $ | points = 0.0, |
|||
| $ | status = 0, |
|||
| $ | order = 0, |
|||
| $ | coords = "", |
|||
| $ | area = "" | |||
| ) |
Adds a possible answer for a imagemap question.
Adds a possible answer for a imagemap question. A ASS_AnswerImagemap object will be created and assigned to the array $this->answers.
- Parameters:
-
string $answertext The answer text double $points The points for selecting the answer (even negative points can be used) integer $status The state of the answer (set = 1 or unset = 0) integer $order A possible display order of the answer public
- See also:
- $answers
- ASS_AnswerImagemap
Definition at line 1049 of file class.assImagemapQuestion.php.
References $coords, ASS_Question::$points, and $status.
Referenced by from_xml(), and set_imagemap_filename().
{
if (array_key_exists($order, $this->answers)) {
// Antwort einf�gen
$answer = new ASS_AnswerImagemap($answertext, $points, $order, $status, $coords, $area);
for ($i = count($this->answers) - 1; $i >= $order; $i--) {
$this->answers[$i+1] = $this->answers[$i];
$this->answers[$i+1]->set_order($i+1);
}
$this->answers[$order] = $answer;
} else {
// Anwort anh�ngen
$answer = new ASS_AnswerImagemap($answertext, $points, count($this->answers), $status, $coords, $area);
array_push($this->answers, $answer);
}
}
Here is the caller graph for this function:
| ASS_ImagemapQuestion::addAnswer | ( | $ | answertext, | |
| $ | points, | |||
| $ | answerorder, | |||
| $ | correctness, | |||
| $ | coords, | |||
| $ | area | |||
| ) |
Adds an answer to the question.
Adds an answer to the question
public
Definition at line 372 of file class.assImagemapQuestion.php.
References $coords, and ASS_Question::$points.
{
array_push($this->answers, new ASS_AnswerImagemap($answertext, $points, $answerorder, $correctness, $coords, $area));
}
| ASS_ImagemapQuestion::ASS_ImagemapQuestion | ( | $ | title = "", |
|
| $ | comment = "", |
|||
| $ | author = "", |
|||
| $ | owner = -1, |
|||
| $ | question = "", |
|||
| $ | imagemap_filename = "", |
|||
| $ | image_filename = "" | |||
| ) |
ASS_ImagemapQuestion constructor.
The constructor takes possible arguments an creates an instance of the ASS_ImagemapQuestion object.
- Parameters:
-
string $title A title string to describe the question string $comment A comment string to describe the question string $author A string containing the name of the questions author integer $owner A numerical ID to identify the owner/creator string $imagemap_file The imagemap file name of the imagemap question string $image_file The image file name of the imagemap question string $question The question string of the imagemap question public
Definition at line 101 of file class.assImagemapQuestion.php.
References ASS_Question::$author, ASS_Question::$comment, $image_filename, $imagemap_filename, ASS_Question::$owner, $question, ASS_Question::$title, and ASS_Question::ASS_Question().
{
$this->ASS_Question($title, $comment, $author, $owner);
$this->question = $question;
$this->imagemap_filename = $imagemap_filename;
$this->image_filename = $image_filename;
$this->answers = array();
$this->coords = array();
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::calculateReachedPoints | ( | $ | user_id, | |
| $ | test_id | |||
| ) |
Returns the points, a learner has reached answering the question.
Returns the points, a learner has reached answering the question The points are calculated from the given answers including checks for all special scoring options in the test container.
- Parameters:
-
integer $user_id The database ID of the learner integer $test_id The database Id of the test containing the question public
Definition at line 1169 of file class.assImagemapQuestion.php.
References $data, ASS_Question::$points, $query, $result, $row, ASS_Question::$test_id, $user_id, ASS_Question::getId(), and getMaximumPoints().
{
global $ilDB;
$found_values = array();
$query = sprintf("SELECT * FROM tst_solutions WHERE user_fi = %s AND test_fi = %s AND question_fi = %s",
$ilDB->quote($user_id),
$ilDB->quote($test_id),
$ilDB->quote($this->getId())
);
$result = $ilDB->query($query);
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
{
if (strcmp($data->value1, "") != 0)
{
array_push($found_values, $data->value1);
}
}
$points = 0;
if (count($found_values) > 0)
{
foreach ($this->answers as $key => $answer)
{
if ($answer->isStateChecked())
{
if (in_array($key, $found_values))
{
$points += $answer->get_points();
}
}
}
}
// check for special scoring options in test
$query = sprintf("SELECT * FROM tst_tests WHERE test_id = %s",
$ilDB->quote($test_id)
);
$result = $ilDB->query($query);
if ($result->numRows() == 1)
{
$row = $result->fetchRow(DB_FETCHMODE_ASSOC);
if ($row["count_system"] == 1)
{
if ($points != $this->getMaximumPoints())
{
$points = 0;
}
}
}
else
{
$points = 0;
}
return $points;
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::deleteArea | ( | $ | index = 0 |
) |
Deletes an answer.
Deletes an area with a given index. The index of the first area is 0, the index of the second area is 1 and so on.
- Parameters:
-
integer $index A nonnegative index of the n-th answer public
- See also:
- $answers
Definition at line 1114 of file class.assImagemapQuestion.php.
{
if ($index < 0) return;
if (count($this->answers) < 1) return;
if ($index >= count($this->answers)) return;
unset($this->answers[$index]);
$this->answers = array_values($this->answers);
for ($i = 0; $i < count($this->answers); $i++) {
if ($this->answers[$i]->get_order() > $index) {
$this->answers[$i]->set_order($i);
}
}
}
| ASS_ImagemapQuestion::duplicate | ( | $ | for_test = true, |
|
| $ | title = "", |
|||
| $ | author = "", |
|||
| $ | owner = "" | |||
| ) |
Duplicates an ASS_ImagemapQuestion.
Duplicates an ASS_ImagemapQuestion
public
Definition at line 258 of file class.assImagemapQuestion.php.
References ASS_Question::$author, ASS_Question::$owner, ASS_Question::$title, and ASS_Question::_getOriginalId().
{
if ($this->id <= 0)
{
// The question has not been saved. It cannot be duplicated
return;
}
// duplicate the question in database
$clone = $this;
include_once ("./assessment/classes/class.assQuestion.php");
$original_id = ASS_Question::_getOriginalId($this->id);
$clone->id = -1;
if ($title)
{
$clone->setTitle($title);
}
if ($author)
{
$clone->setAuthor($author);
}
if ($owner)
{
$clone->setOwner($owner);
}
if ($for_test)
{
$clone->saveToDb($original_id);
}
else
{
$clone->saveToDb();
}
// copy question page content
$clone->copyPageOfQuestion($original_id);
// duplicate the image
$clone->duplicateImage($original_id);
return $clone->id;
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::duplicateImage | ( | $ | question_id | ) |
Definition at line 299 of file class.assImagemapQuestion.php.
References get_image_filename(), ASS_Question::getImagePath(), and ilUtil::makeDirParents().
{
$imagepath = $this->getImagePath();
$imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
if (!file_exists($imagepath)) {
ilUtil::makeDirParents($imagepath);
}
$filename = $this->get_image_filename();
if (!copy($imagepath_original . $filename, $imagepath . $filename)) {
print "image could not be duplicated!!!! ";
}
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::flush_answers | ( | ) |
Deletes all answers.
Deletes all answers
public
- See also:
- $answers
Definition at line 1135 of file class.assImagemapQuestion.php.
{
$this->answers = array();
}
| ASS_ImagemapQuestion::from_xml | ( | $ | xml_text | ) |
Imports a question from XML.
Sets the attributes of the question from the XML text passed as argument
- Returns:
- boolean True, if the import succeeds, false otherwise public
Definition at line 386 of file class.assImagemapQuestion.php.
References ASS_Question::$comment, $idx, $ilErr, $image, $result, ASS_Question::$shuffle, ilQTIUtils::_getRespcondition(), add_answer(), domxml_open_mem(), ASS_Question::getId(), ASS_Question::getImagePath(), ilUtil::makeDirParents(), saveToDb(), set_question(), ASS_Question::setAuthor(), ASS_Question::setComment(), ASS_Question::setEstimatedWorkingTime(), ASS_Question::setSuggestedSolution(), and ASS_Question::setTitle().
{
$result = false;
if (!empty($this->domxml))
{
$this->domxml->free();
}
$xml_text = preg_replace("/>\s*?</", "><", $xml_text);
$this->domxml = domxml_open_mem($xml_text);
if (!empty($this->domxml))
{
$root = $this->domxml->document_element();
$item = $root->first_child();
$this->setTitle($item->get_attribute("title"));
$this->gaps = array();
$itemnodes = $item->child_nodes();
$materials = array();
$filename = "";
$image = "";
$shuffle = "";
foreach ($itemnodes as $index => $node)
{
switch ($node->node_name())
{
case "qticomment":
$comment = $node->node_value();
if (strpos($comment, "ILIAS Version=") !== false)
{
}
elseif (strpos($comment, "Questiontype=") !== false)
{
}
elseif (strpos($comment, "Author=") !== false)
{
$comment = str_replace("Author=", "", $comment);
$this->setAuthor($comment);
}
else
{
$this->setComment($comment);
}
break;
case "itemmetadata":
$md_array = array();
$metanodes = $node->child_nodes();
foreach ($metanodes as $metanode)
{
switch ($metanode->node_name())
{
case "qtimetadata":
$metafields = $metanode->child_nodes();
foreach ($metafields as $metafield)
{
switch ($metafield->node_name())
{
case "qtimetadatafield":
$metafieldlist = $metafield->child_nodes();
$md = array("label" => "", "entry" => "");
foreach ($metafieldlist as $attr)
{
switch ($attr->node_name())
{
case "fieldlabel":
$md["label"] = $attr->get_content();
break;
case "fieldentry":
$md["entry"] = $attr->get_content();
break;
}
}
array_push($md_array, $md);
break;
}
}
break;
}
}
foreach ($md_array as $md)
{
switch ($md["label"])
{
case "ILIAS_VERSION":
break;
case "QUESTIONTYPE":
break;
case "AUTHOR":
$this->setAuthor($md["entry"]);
break;
}
}
break;
case "duration":
$iso8601period = $node->node_value();
if (preg_match("/P(\d+)Y(\d+)M(\d+)DT(\d+)H(\d+)M(\d+)S/", $iso8601period, $matches))
{
$this->setEstimatedWorkingTime($matches[4], $matches[5], $matches[6]);
}
break;
case "presentation":
$flow = $node->first_child();
$flownodes = $flow->child_nodes();
foreach ($flownodes as $idx => $flownode)
{
if (strcmp($flownode->node_name(), "material") == 0)
{
$mattext = $flownode->first_child();
$this->set_question($mattext->node_value());
}
elseif (strcmp($flownode->node_name(), "response_xy") == 0)
{
$ident = $flownode->get_attribute("ident");
$subnodes = $flownode->child_nodes();
foreach ($subnodes as $node_type)
{
switch ($node_type->node_name())
{
case "material":
$matlabel = $node_type->get_attribute("label");
if (strcmp($matlabel, "suggested_solution") == 0)
{
$mattype = $node_type->first_child();
if (strcmp($mattype->node_name(), "mattext") == 0)
{
$suggested_solution = $mattype->node_value();
if ($suggested_solution)
{
if ($this->getId() < 1)
{
$this->saveToDb();
}
$this->setSuggestedSolution($suggested_solution, 0, true);
}
}
}
break;
case "render_hotspot":
$render_hotspot = $node_type;
$labels = $render_hotspot->child_nodes();
foreach ($labels as $lidx => $response_label)
{
if (strcmp($response_label->node_name(), "material") == 0)
{
// image map image
$mattype = $response_label->first_child();
if (strcmp($mattype->node_name(), "matimage") == 0)
{
$filename = $mattype->get_attribute("label");
$image = base64_decode($mattype->node_value());
}
}
else
{
$matident = $response_label->get_attribute("ident");
switch ($response_label->get_attribute("rarea"))
{
case "Ellipse":
$materials[$matident]["area"] = "circle";
break;
case "Bounded":
$materials[$matident]["area"] = "poly";
break;
case "Rectangle":
$materials[$matident]["area"] = "rect";
break;
}
$material_children = $response_label->child_nodes();
foreach ($material_children as $midx => $childnode)
{
if (strcmp($childnode->node_name(), "#text") == 0)
{
$materials[$matident]["coords"] = $childnode->node_value();
}
elseif (strcmp($childnode->node_name(), "material") == 0)
{
$materials[$matident]["answertext"] = $childnode->node_value();
}
}
}
}
break;
}
}
}
}
break;
case "resprocessing":
$resproc_nodes = $node->child_nodes();
foreach ($resproc_nodes as $index => $respcondition)
{
if (strcmp($respcondition->node_name(), "respcondition") == 0)
{
$respcondition_array =& ilQTIUtils::_getRespcondition($respcondition);
foreach ($materials as $index => $material)
{
if (strcmp($material["coords"], $respcondition_array["conditionvar"]["value"]) == 0)
{
$this->add_answer(
$material["answertext"],
$respcondition_array["setvar"]["points"],
$respcondition_array["conditionvar"]["selected"],
$index,
$material["coords"],
$material["area"]
);
}
}
}
}
break;
}
}
if ($filename)
{
$this->saveToDb();
$imagepath = $this->getImagePath();
if (!file_exists($imagepath))
{
ilUtil::makeDirParents($imagepath);
}
$imagepath .= $filename;
$fh = fopen($imagepath, "wb");
if ($fh == false)
{
global $ilErr;
$ilErr->raiseError($this->lng->txt("error_save_image_file") . ": $php_errormsg", $ilErr->MESSAGE);
return;
}
$imagefile = fwrite($fh, $image);
fclose($fh);
$this->image_filename = $filename;
}
$result = true;
}
return $result;
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::get_answer | ( | $ | index = 0 |
) |
Returns an answer.
Returns an answer with a given index. The index of the first answer is 0, the index of the second answer is 1 and so on.
- Parameters:
-
integer $index A nonnegative index of the n-th answer
- Returns:
- object ASS_AnswerImagemap-Object containing the answer public
- See also:
- $answers
Definition at line 1097 of file class.assImagemapQuestion.php.
{
if ($index < 0) return NULL;
if (count($this->answers) < 1) return NULL;
if ($index >= count($this->answers)) return NULL;
return $this->answers[$index];
}
| ASS_ImagemapQuestion::get_answer_count | ( | ) |
Returns the number of answers.
Returns the number of answers
- Returns:
- integer The number of answers of the multiple choice question public
- See also:
- $answers
Definition at line 1082 of file class.assImagemapQuestion.php.
{
return count($this->answers);
}
| ASS_ImagemapQuestion::get_image_filename | ( | ) |
Gets the image file name.
Gets the image file name
- Returns:
- string The image file name of the ASS_ImagemapQuestion object public
- See also:
- $image_filename
Definition at line 981 of file class.assImagemapQuestion.php.
Referenced by duplicateImage(), and to_xml().
{
return $this->image_filename;
}
Here is the caller graph for this function:
| ASS_ImagemapQuestion::get_imagemap_contents | ( | $ | href = "#" |
) |
Gets the imagemap file contents.
Gets the imagemap file contents
- Returns:
- string The imagemap file contents of the ASS_ImagemapQuestion object public
- See also:
- $imagemap_contents
Definition at line 1023 of file class.assImagemapQuestion.php.
References $imagemap_contents.
{
$imagemap_contents = "<map name=\"".$this->title."\"> ";
for ($i = 0; $i < count($this->answers); $i++) {
$imagemap_contents .= "<area alt=\"".$this->answers[$i]->get_answertext()."\" ";
$imagemap_contents .= "shape=\"".$this->answers[$i]->get_area()."\" ";
$imagemap_contents .= "coords=\"".$this->answers[$i]->get_coords()."\" ";
$imagemap_contents .= "href=\"$href&selimage=" . $this->answers[$i]->get_order() . "\" /> ";
}
$imagemap_contents .= "</map>";
return $imagemap_contents;
}
| ASS_ImagemapQuestion::get_imagemap_filename | ( | ) |
Gets the imagemap file name.
Gets the imagemap file name
- Returns:
- string The imagemap file of the ASS_ImagemapQuestion object public
- See also:
- $imagemap_filename
Definition at line 940 of file class.assImagemapQuestion.php.
{
return $this->imagemap_filename;
}
| ASS_ImagemapQuestion::get_question | ( | ) |
Gets the imagemap question.
Gets the question string of the ASS_ImagemapQuestion object
- Returns:
- string The question string of the ASS_ImagemapQuestion object public
- See also:
- $question
Definition at line 914 of file class.assImagemapQuestion.php.
Referenced by to_xml().
{
return $this->question;
}
Here is the caller graph for this function:
| ASS_ImagemapQuestion::getMaximumPoints | ( | ) |
Returns the maximum points, a learner can reach answering the question.
Returns the maximum points, a learner can reach answering the question
public
- See also:
- $points
Reimplemented from ASS_Question.
Definition at line 1147 of file class.assImagemapQuestion.php.
References ASS_Question::$points.
Referenced by calculateReachedPoints(), saveToDb(), and syncWithOriginal().
{
$points = array("set" => 0, "unset" => 0);
foreach ($this->answers as $key => $value) {
if ($value->get_points() > $points["set"])
{
$points["set"] = $value->get_points();
}
}
return $points["set"];
}
Here is the caller graph for this function:
| ASS_ImagemapQuestion::getQuestionType | ( | ) |
Returns the question type of the question.
Returns the question type of the question
- Returns:
- integer The question type of the question public
Definition at line 1369 of file class.assImagemapQuestion.php.
Referenced by saveToDb().
{
return 6;
}
Here is the caller graph for this function:
| ASS_ImagemapQuestion::getReachedInformation | ( | $ | user_id, | |
| $ | test_id | |||
| ) |
Returns the evaluation data, a learner has entered to answer the question.
Returns the evaluation data, a learner has entered to answer the question
- Parameters:
-
integer $user_id The database ID of the learner integer $test_id The database Id of the test containing the question public
Definition at line 1234 of file class.assImagemapQuestion.php.
References $counter, $data, $query, $result, ASS_Question::$test_id, $user_id, and ASS_Question::getId().
{
$found_values = array();
$query = sprintf("SELECT * FROM tst_solutions WHERE user_fi = %s AND test_fi = %s AND question_fi = %s",
$this->ilias->db->quote($user_id),
$this->ilias->db->quote($test_id),
$this->ilias->db->quote($this->getId())
);
$result = $this->ilias->db->query($query);
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
{
array_push($found_values, $data->value1);
}
$counter = 1;
$user_result = array();
foreach ($found_values as $key => $value)
{
$solution = array(
"order" => "$counter",
"points" => 0,
"true" => 0,
"value" => "",
);
if (strlen($value) > 0)
{
$solution["value"] = $value;
$solution["points"] = $this->answers[$value]->get_points();
if ($this->answers[$value]->isStateChecked())
{
$solution["true"] = 1;
}
}
$counter++;
array_push($user_result, $solution);
}
return $user_result;
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::isComplete | ( | ) |
Returns true, if a imagemap question is complete for use.
Returns true, if a imagemap question is complete for use
- Returns:
- boolean True, if the imagemap question is complete for use, otherwise false public
Reimplemented from ASS_Question.
Definition at line 128 of file class.assImagemapQuestion.php.
Referenced by saveToDb(), and syncWithOriginal().
{
if (($this->title) and ($this->author) and ($this->question) and ($this->image_filename) and (count($this->answers)))
{
return true;
}
else
{
return false;
}
}
Here is the caller graph for this function:
| ASS_ImagemapQuestion::loadFromDb | ( | $ | question_id | ) |
Loads a ASS_ImagemapQuestion object from a database.
Loads a ASS_ImagemapQuestion object from a database (experimental)
- Parameters:
-
object $db A pear DB object integer $question_id A unique key which defines the multiple choice test in the database public
Reimplemented from ASS_Question.
Definition at line 321 of file class.assImagemapQuestion.php.
References $data, ASS_Question::$ilias, $query, $result, and ASS_Question::setEstimatedWorkingTime().
{
global $ilias;
$db = & $ilias->db;
$query = sprintf("SELECT * FROM qpl_questions WHERE question_id = %s",
$db->quote($question_id)
);
$result = $db->query($query);
if (strcmp(strtolower(get_class($result)), db_result) == 0) {
if ($result->numRows() == 1) {
$data = $result->fetchRow(DB_FETCHMODE_OBJECT);
$this->id = $question_id;
$this->obj_id = $data->obj_fi;
$this->title = $data->title;
$this->comment = $data->comment;
$this->author = $data->author;
$this->original_id = $data->original_id;
$this->solution_hint = $data->solution_hint;
$this->owner = $data->owner;
$this->question = $data->question_text;
$this->image_filename = $data->image_file;
$this->points = $data->points;
$this->setEstimatedWorkingTime(substr($data->working_time, 0, 2), substr($data->working_time, 3, 2), substr($data->working_time, 6, 2));
}
$query = sprintf("SELECT * FROM qpl_answers WHERE question_fi = %s ORDER BY aorder ASC",
$db->quote($question_id)
);
$result = $db->query($query);
if (strcmp(strtolower(get_class($result)), db_result) == 0) {
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT)) {
if ($data->correctness == 0)
{
// fix for older single response answers where points could be given for unchecked answers
$data->correctness = 1;
$data->points = 0;
}
array_push($this->answers, new ASS_AnswerImagemap($data->answertext, $data->points, $data->aorder, $data->correctness, $data->coords, $data->area));
}
}
}
parent::loadFromDb($question_id);
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::saveToDb | ( | $ | original_id = "" |
) |
Saves a ASS_ImagemapQuestion object to a database.
Saves a ASS_ImagemapQuestion object to a database (experimental)
- Parameters:
-
object $db A pear DB object public
Reimplemented from ASS_Question.
Definition at line 148 of file class.assImagemapQuestion.php.
References ASS_Question::$ilias, $query, $result, ASS_Question::createPageObject(), ASS_Question::getEstimatedWorkingTime(), getMaximumPoints(), getQuestionType(), ASS_Question::getTestId(), ASS_Question::insertIntoTest(), and isComplete().
Referenced by from_xml().
{
global $ilias;
$complete = 0;
if ($this->isComplete())
{
$complete = 1;
}
$db = & $ilias->db;
$estw_time = $this->getEstimatedWorkingTime();
$estw_time = sprintf("%02d:%02d:%02d", $estw_time['h'], $estw_time['m'], $estw_time['s']);
if ($original_id)
{
$original_id = $db->quote($original_id);
}
else
{
$original_id = "NULL";
}
if ($this->id == -1)
{
// Neuen Datensatz schreiben
$now = getdate();
$question_type = $this->getQuestionType();
$created = sprintf("%04d%02d%02d%02d%02d%02d", $now['year'], $now['mon'], $now['mday'], $now['hours'], $now['minutes'], $now['seconds']);
$query = sprintf("INSERT INTO qpl_questions (question_id, question_type_fi, obj_fi, title, comment, author, owner, question_text, working_time, points, image_file, complete, created, original_id, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NULL)",
$db->quote($question_type),
$db->quote($this->obj_id),
$db->quote($this->title),
$db->quote($this->comment),
$db->quote($this->author),
$db->quote($this->owner),
$db->quote($this->question),
$db->quote($estw_time),
$db->quote($this->getMaximumPoints() . ""),
$db->quote($this->image_filename),
$db->quote("$complete"),
$db->quote($created),
$original_id
);
$result = $db->query($query);
if ($result == DB_OK)
{
$this->id = $db->getLastInsertId();
// create page object of question
$this->createPageObject();
// Falls die Frage in einen Test eingef�gt werden soll, auch diese Verbindung erstellen
if ($this->getTestId() > 0)
{
$this->insertIntoTest($this->getTestId());
}
}
}
else
{
// Vorhandenen Datensatz aktualisieren
$query = sprintf("UPDATE qpl_questions SET obj_fi = %s, title = %s, comment = %s, author = %s, question_text = %s, working_time = %s, points = %s, image_file = %s, complete = %s WHERE question_id = %s",
$db->quote($this->obj_id. ""),
$db->quote($this->title),
$db->quote($this->comment),
$db->quote($this->author),
$db->quote($this->question),
$db->quote($estw_time),
$db->quote($this->getMaximumPoints() . ""),
$db->quote($this->image_filename),
$db->quote("$complete"),
$db->quote($this->id)
);
$result = $db->query($query);
}
if ($result == DB_OK)
{
$query = sprintf("DELETE FROM qpl_answers WHERE question_fi = %s",
$db->quote($this->id)
);
$result = $db->query($query);
// Anworten wegschreiben
foreach ($this->answers as $key => $value)
{
$answer_obj = $this->answers[$key];
//print "id:".$this->id." answer tex:".$answer_obj->get_answertext()." answer_obj->get_order():".$answer_obj->get_order()." answer_obj->get_coords():".$answer_obj->get_coords()." answer_obj->get_area():".$answer_obj->get_area();
$query = sprintf("INSERT INTO qpl_answers (answer_id, question_fi, answertext, points, aorder, correctness, coords, area, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, NULL)",
$db->quote($this->id),
$db->quote($answer_obj->get_answertext() . ""),
$db->quote($answer_obj->get_points() . ""),
$db->quote($answer_obj->get_order() . ""),
$db->quote($answer_obj->getState() . ""),
$db->quote($answer_obj->get_coords() . ""),
$db->quote($answer_obj->get_area() . "")
);
$answer_result = $db->query($query);
}
}
parent::saveToDb($original_id);
}
Here is the call graph for this function:
Here is the caller graph for this function:
| ASS_ImagemapQuestion::saveWorkingData | ( | $ | test_id, | |
| $ | limit_to = LIMIT_NO_LIMIT | |||
| ) |
Saves the learners input of the question to the database.
Saves the learners input of the question to the database
- Parameters:
-
integer $test_id The database id of the test containing this question
- Returns:
- boolean Indicates the save status (true if saved successful, false otherwise) public
- See also:
- $answers
Reimplemented from ASS_Question.
Definition at line 1281 of file class.assImagemapQuestion.php.
References $_GET, $ilUser, $query, $result, ASS_Question::$test_id, and ASS_Question::getId().
{
global $ilDB;
global $ilUser;
$db =& $ilDB->db;
$query = sprintf("DELETE FROM tst_solutions WHERE user_fi = %s AND test_fi = %s AND question_fi = %s",
$db->quote($ilUser->id),
$db->quote($test_id),
$db->quote($this->getId())
);
$result = $db->query($query);
$query = sprintf("INSERT INTO tst_solutions (solution_id, user_fi, test_fi, question_fi, value1, value2, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, NULL, NULL)",
$db->quote($ilUser->id),
$db->quote($test_id),
$db->quote($this->getId()),
$db->quote($_GET["selImage"])
);
$result = $db->query($query);
parent::saveWorkingData($test_id);
return true;
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::set_image_filename | ( | $ | image_filename, | |
| $ | image_tempfilename = "" | |||
| ) |
Sets the image file name.
Sets the image file name
- Parameters:
-
string $image_file name. public
- See also:
- $image_filename
Definition at line 994 of file class.assImagemapQuestion.php.
References $image_filename, ASS_Question::getImagePath(), ilUtil::makeDirParents(), and ilUtil::moveUploadedFile().
{
if (!empty($image_filename))
{
$image_filename = str_replace(" ", "_", $image_filename);
$this->image_filename = $image_filename;
}
if (!empty($image_tempfilename)) {
$imagepath = $this->getImagePath();
if (!file_exists($imagepath)) {
ilUtil::makeDirParents($imagepath);
}
if (!ilUtil::moveUploadedFile($image_tempfilename, $image_filename, $imagepath.$image_filename))
{
$this->ilias->raiseError("The image could not be uploaded!", $this->ilias->error_obj->MESSAGE);
}
}
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::set_imagemap_filename | ( | $ | imagemap_filename, | |
| $ | imagemap_tempfilename = "" | |||
| ) |
Sets the imagemap file name.
Sets the imagemap file name
- Parameters:
-
string $imagemap_file. public
- See also:
- $imagemap_filename
Definition at line 953 of file class.assImagemapQuestion.php.
References $coords, $imagemap_filename, and add_answer().
{
if (!empty($imagemap_filename)) {
$this->imagemap_filename = $imagemap_filename;
}
if (!empty($imagemap_tempfilename)) {
$fp = fopen($imagemap_tempfilename, "r");
$contents = fread($fp, filesize($imagemap_tempfilename));
fclose($fp);
if (preg_match_all("/<area(.+)>/siU", $contents, $matches)) {
for ($i=0; $i< count($matches[1]); $i++) {
preg_match("/alt\s*=\s*\"(.+)\"\s*/siU", $matches[1][$i], $alt);
preg_match("/coords\s*=\s*\"(.+)\"\s*/siU", $matches[1][$i], $coords);
preg_match("/shape\s*=\s*\"(.+)\"\s*/siU", $matches[1][$i], $shape);
$this->add_answer($alt[1], 0.0, FALSE, count($this->answers), $coords[1], $shape[1]);
}
}
}
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::set_question | ( | $ | question = "" |
) |
Sets the imagemap question.
Sets the question string of the ASS_ImagemapQuestion object
- Parameters:
-
string $question A string containing the imagemap question public
- See also:
- $question
Definition at line 927 of file class.assImagemapQuestion.php.
References $question.
Referenced by from_xml().
{
$this->question = $question;
}
Here is the caller graph for this function:
| ASS_ImagemapQuestion::syncWithOriginal | ( | ) |
Reimplemented from ASS_Question.
Definition at line 1304 of file class.assImagemapQuestion.php.
References ASS_Question::$ilias, $query, $result, ASS_Question::getEstimatedWorkingTime(), getMaximumPoints(), and isComplete().
{
global $ilias;
if ($this->original_id)
{
$complete = 0;
if ($this->isComplete())
{
$complete = 1;
}
$db = & $ilias->db;
$estw_time = $this->getEstimatedWorkingTime();
$estw_time = sprintf("%02d:%02d:%02d", $estw_time['h'], $estw_time['m'], $estw_time['s']);
$query = sprintf("UPDATE qpl_questions SET obj_fi = %s, title = %s, comment = %s, author = %s, question_text = %s, working_time = %s, points = %s, image_file = %s, complete = %s WHERE question_id = %s",
$db->quote($this->obj_id. ""),
$db->quote($this->title . ""),
$db->quote($this->comment . ""),
$db->quote($this->author . ""),
$db->quote($this->question . ""),
$db->quote($estw_time . ""),
$db->quote($this->getMaximumPoints() . ""),
$db->quote($this->image_filename . ""),
$db->quote($complete . ""),
$db->quote($this->original_id . "")
);
$result = $db->query($query);
if ($result == DB_OK)
{
// write answers
// delete old answers
$query = sprintf("DELETE FROM qpl_answers WHERE question_fi = %s",
$db->quote($this->original_id)
);
$result = $db->query($query);
foreach ($this->answers as $key => $value)
{
$answer_obj = $this->answers[$key];
$query = sprintf("INSERT INTO qpl_answers (answer_id, question_fi, answertext, points, aorder, correctness, coords, area, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, NULL)",
$db->quote($this->original_id . ""),
$db->quote($answer_obj->get_answertext() . ""),
$db->quote($answer_obj->get_points() . ""),
$db->quote($answer_obj->get_order() . ""),
$db->quote($answer_obj->getState() . ""),
$db->quote($answer_obj->get_coords() . ""),
$db->quote($answer_obj->get_area() . "")
);
$answer_result = $db->query($query);
}
}
parent::syncWithOriginal();
}
}
Here is the call graph for this function:
| ASS_ImagemapQuestion::to_xml | ( | $ | a_include_header = true, |
|
| $ | a_include_binary = true, |
|||
| $ | a_shuffle = false, |
|||
| $ | test_output = false | |||
| ) |
Returns a QTI xml representation of the question.
Returns a QTI xml representation of the question and sets the internal domxml variable with the DOM XML representation of the QTI xml representation
- Returns:
- string The QTI xml representation of the question public
Definition at line 631 of file class.assImagemapQuestion.php.
References $ilErr, $pos, $xml, domxml_open_mem(), get_image_filename(), get_question(), ASS_Question::getAuthor(), ASS_Question::getComment(), ASS_Question::getEstimatedWorkingTime(), ASS_Question::getImagePath(), ASS_Question::getImagePathWeb(), ASS_Question::getSuggestedSolution(), and ASS_Question::getTitle().
{
if (!empty($this->domxml))
{
$this->domxml->free();
}
$xml_header = "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<questestinterop></questestinterop>\n";
$this->domxml = domxml_open_mem($xml_header);
$root = $this->domxml->document_element();
// qti ident
$qtiIdent = $this->domxml->create_element("item");
$qtiIdent->set_attribute("ident", "il_".IL_INST_ID."_qst_".$this->getId());
$qtiIdent->set_attribute("title", $this->getTitle());
$root->append_child($qtiIdent);
// add question description
$qtiComment = $this->domxml->create_element("qticomment");
$qtiCommentText = $this->domxml->create_text_node($this->getComment());
$qtiComment->append_child($qtiCommentText);
$qtiIdent->append_child($qtiComment);
// add estimated working time
$qtiDuration = $this->domxml->create_element("duration");
$workingtime = $this->getEstimatedWorkingTime();
$qtiDurationText = $this->domxml->create_text_node(sprintf("P0Y0M0DT%dH%dM%dS", $workingtime["h"], $workingtime["m"], $workingtime["s"]));
$qtiDuration->append_child($qtiDurationText);
$qtiIdent->append_child($qtiDuration);
// add ILIAS specific metadata
$qtiItemmetadata = $this->domxml->create_element("itemmetadata");
$qtiMetadata = $this->domxml->create_element("qtimetadata");
$qtiMetadatafield = $this->domxml->create_element("qtimetadatafield");
$qtiFieldlabel = $this->domxml->create_element("fieldlabel");
$qtiFieldlabelText = $this->domxml->create_text_node("ILIAS_VERSION");
$qtiFieldlabel->append_child($qtiFieldlabelText);
$qtiFieldentry = $this->domxml->create_element("fieldentry");
$qtiFieldentryText = $this->domxml->create_text_node($this->ilias->getSetting("ilias_version"));
$qtiFieldentry->append_child($qtiFieldentryText);
$qtiMetadatafield->append_child($qtiFieldlabel);
$qtiMetadatafield->append_child($qtiFieldentry);
$qtiMetadata->append_child($qtiMetadatafield);
$qtiMetadatafield = $this->domxml->create_element("qtimetadatafield");
$qtiFieldlabel = $this->domxml->create_element("fieldlabel");
$qtiFieldlabelText = $this->domxml->create_text_node("QUESTIONTYPE");
$qtiFieldlabel->append_child($qtiFieldlabelText);
$qtiFieldentry = $this->domxml->create_element("fieldentry");
$qtiFieldentryText = $this->domxml->create_text_node(IMAGEMAP_QUESTION_IDENTIFIER);
$qtiFieldentry->append_child($qtiFieldentryText);
$qtiMetadatafield->append_child($qtiFieldlabel);
$qtiMetadatafield->append_child($qtiFieldentry);
$qtiMetadata->append_child($qtiMetadatafield);
$qtiMetadatafield = $this->domxml->create_element("qtimetadatafield");
$qtiFieldlabel = $this->domxml->create_element("fieldlabel");
$qtiFieldlabelText = $this->domxml->create_text_node("AUTHOR");
$qtiFieldlabel->append_child($qtiFieldlabelText);
$qtiFieldentry = $this->domxml->create_element("fieldentry");
$qtiFieldentryText = $this->domxml->create_text_node($this->getAuthor());
$qtiFieldentry->append_child($qtiFieldentryText);
$qtiMetadatafield->append_child($qtiFieldlabel);
$qtiMetadatafield->append_child($qtiFieldentry);
$qtiMetadata->append_child($qtiMetadatafield);
$qtiItemmetadata->append_child($qtiMetadata);
$qtiIdent->append_child($qtiItemmetadata);
// PART I: qti presentation
$qtiPresentation = $this->domxml->create_element("presentation");
$qtiPresentation->set_attribute("label", $this->getTitle());
// add flow to presentation
$qtiFlow = $this->domxml->create_element("flow");
// add material with question text to presentation
$qtiMaterial = $this->domxml->create_element("material");
$qtiMatText = $this->domxml->create_element("mattext");
$qtiMatTextText = $this->domxml->create_text_node($this->get_question());
$qtiMatText->append_child($qtiMatTextText);
$qtiMaterial->append_child($qtiMatText);
$qtiFlow->append_child($qtiMaterial);
// add answers to presentation
$qtiResponseXy = $this->domxml->create_element("response_xy");
$qtiResponseXy->set_attribute("ident", "IM");
$qtiResponseXy->set_attribute("rcardinality", "Single");
$solution = $this->getSuggestedSolution(0);
if (count($solution))
{
if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches))
{
$qtiMaterial = $this->domxml->create_element("material");
$qtiMaterial->set_attribute("label", "suggested_solution");
$qtiMatText = $this->domxml->create_element("mattext");
$intlink = "il_" . IL_INST_ID . "_" . $matches[2] . "_" . $matches[3];
if (strcmp($matches[1], "") != 0)
{
$intlink = $solution["internal_link"];
}
$qtiMatTextText = $this->domxml->create_text_node($intlink);
$qtiMatText->append_child($qtiMatTextText);
$qtiMaterial->append_child($qtiMatText);
$qtiResponseXy->append_child($qtiMaterial);
}
}
$qtiRenderHotspot = $this->domxml->create_element("render_hotspot");
$qtiMaterial = $this->domxml->create_element("material");
$qtiMatImage = $this->domxml->create_element("matimage");
$imagetype = "image/jpeg";
if (preg_match("/.*\.(png|gif)$/", $this->get_image_filename(), $matches))
{
$imagetype = "image/" . $matches[1];
}
$qtiMatImage->set_attribute("imagtype", $imagetype);
$qtiMatImage->set_attribute("label", $this->get_image_filename());
if ($a_include_binary)
{
if ($test_output)
{
$qtiMatImage->set_attribute("uri", $this->getImagePathWeb() . $this->get_image_filename());
}
else
{
$qtiMatImage->set_attribute("embedded", "base64");
$imagepath = $this->getImagePath() . $this->get_image_filename();
$fh = fopen($imagepath, "rb");
if ($fh == false)
{
global $ilErr;
$ilErr->raiseError($this->lng->txt("error_open_image_file"), $ilErr->MESSAGE);
return;
}
$imagefile = fread($fh, filesize($imagepath));
fclose($fh);
$base64 = base64_encode($imagefile);
$qtiBase64Data = $this->domxml->create_text_node($base64);
$qtiMatImage->append_child($qtiBase64Data);
}
}
$qtiMaterial->append_child($qtiMatImage);
$qtiRenderHotspot->append_child($qtiMaterial);
// add answers
foreach ($this->answers as $index => $answer)
{
$qtiResponseLabel = $this->domxml->create_element("response_label");
$qtiResponseLabel->set_attribute("ident", $index);
switch ($answer->get_area())
{
case "rect":
$qtiResponseLabel->set_attribute("rarea", "Rectangle");
break;
case "circle":
$qtiResponseLabel->set_attribute("rarea", "Ellipse");
break;
case "poly":
$qtiResponseLabel->set_attribute("rarea", "Bounded");
break;
}
$qtiResponseLabelCoords = $this->domxml->create_text_node($answer->get_coords());
$qtiMaterial = $this->domxml->create_element("material");
$qtiMatText = $this->domxml->create_element("mattext");
$qtiMatTextText = $this->domxml->create_text_node($answer->get_answertext());
$qtiMatText->append_child($qtiMatTextText);
$qtiMaterial->append_child($qtiMatText);
$qtiResponseLabel->append_child($qtiResponseLabelCoords);
$qtiResponseLabel->append_child($qtiMaterial);
$qtiRenderHotspot->append_child($qtiResponseLabel);
}
$qtiResponseXy->append_child($qtiRenderHotspot);
$qtiFlow->append_child($qtiResponseXy);
$qtiPresentation->append_child($qtiFlow);
$qtiIdent->append_child($qtiPresentation);
// PART II: qti resprocessing
$qtiResprocessing = $this->domxml->create_element("resprocessing");
$qtiOutcomes = $this->domxml->create_element("outcomes");
$qtiDecvar = $this->domxml->create_element("decvar");
$qtiOutcomes->append_child($qtiDecvar);
$qtiResprocessing->append_child($qtiOutcomes);
// add response conditions
foreach ($this->answers as $index => $answer)
{
$qtiRespcondition = $this->domxml->create_element("respcondition");
$qtiRespcondition->set_attribute("continue", "Yes");
// qti conditionvar
$qtiConditionvar = $this->domxml->create_element("conditionvar");
if (!$answer->isStateSet())
{
$qtinot = $this->domxml->create_element("not");
}
$qtiVarinside = $this->domxml->create_element("varinside");
$qtiVarinside->set_attribute("respident", "IM");
switch ($answer->get_area())
{
case "rect":
$qtiVarinside->set_attribute("areatype", "Rectangle");
break;
case "circle":
$qtiVarinside->set_attribute("areatype", "Ellipse");
break;
case "poly":
$qtiVarinside->set_attribute("areatype", "Bounded");
break;
}
$qtiVarinsideText = $this->domxml->create_text_node($answer->get_coords());
$qtiVarinside->append_child($qtiVarinsideText);
if (!$answer->isStateSet())
{
$qtiConditionvar->append_child($qtinot);
$qtinot->append_child($qtiVarinside);
}
else
{
$qtiConditionvar->append_child($qtiVarinside);
}
// qti setvar
$qtiSetvar = $this->domxml->create_element("setvar");
$qtiSetvar->set_attribute("action", "Add");
$qtiSetvarText = $this->domxml->create_text_node($answer->get_points());
$qtiSetvar->append_child($qtiSetvarText);
// qti displayfeedback
$qtiDisplayfeedback = $this->domxml->create_element("displayfeedback");
$qtiDisplayfeedback->set_attribute("feedbacktype", "Response");
$linkrefid = "";
if ($answer->isStateSet())
{
$linkrefid = "True";
}
else
{
$linkrefid = "False_$index";
}
$qtiDisplayfeedback->set_attribute("linkrefid", $linkrefid);
$qtiRespcondition->append_child($qtiConditionvar);
$qtiRespcondition->append_child($qtiSetvar);
$qtiRespcondition->append_child($qtiDisplayfeedback);
$qtiResprocessing->append_child($qtiRespcondition);
}
$qtiIdent->append_child($qtiResprocessing);
// PART III: qti itemfeedback
foreach ($this->answers as $index => $answer)
{
$qtiItemfeedback = $this->domxml->create_element("itemfeedback");
$linkrefid = "";
if ($answer->isStateSet())
{
$linkrefid = "True";
}
else
{
$linkrefid = "False_$index";
}
$qtiItemfeedback->set_attribute("ident", $linkrefid);
$qtiItemfeedback->set_attribute("view", "All");
// qti flow_mat
$qtiFlowmat = $this->domxml->create_element("flow_mat");
$qtiMaterial = $this->domxml->create_element("material");
$qtiMattext = $this->domxml->create_element("mattext");
// Insert response text for right/wrong answers here!!!
$qtiMattextText = $this->domxml->create_text_node("");
$qtiMattext->append_child($qtiMattextText);
$qtiMaterial->append_child($qtiMattext);
$qtiFlowmat->append_child($qtiMaterial);
$qtiItemfeedback->append_child($qtiFlowmat);
$qtiIdent->append_child($qtiItemfeedback);
}
$xml = $this->domxml->dump_mem(true);
if (!$a_include_header)
{
$pos = strpos($xml, "?>");
$xml = substr($xml, $pos + 2);
}
//echo htmlentities($xml);
return $xml;
}
Here is the call graph for this function:
Field Documentation
| ASS_ImagemapQuestion::$answers |
Definition at line 57 of file class.assImagemapQuestion.php.
| ASS_ImagemapQuestion::$coords |
Definition at line 85 of file class.assImagemapQuestion.php.
Referenced by add_answer(), addAnswer(), and set_imagemap_filename().
| ASS_ImagemapQuestion::$image_filename |
Definition at line 75 of file class.assImagemapQuestion.php.
Referenced by ASS_ImagemapQuestion(), and set_image_filename().
| ASS_ImagemapQuestion::$imagemap_contents |
Definition at line 84 of file class.assImagemapQuestion.php.
Referenced by get_imagemap_contents().
| ASS_ImagemapQuestion::$imagemap_filename |
Definition at line 66 of file class.assImagemapQuestion.php.
Referenced by ASS_ImagemapQuestion(), and set_imagemap_filename().
| ASS_ImagemapQuestion::$question |
Definition at line 48 of file class.assImagemapQuestion.php.
Referenced by ASS_ImagemapQuestion(), and set_question().
The documentation for this class was generated from the following file:
- assessment/classes/class.assImagemapQuestion.php
