Class for single choice questions. More...
Inheritance diagram for assSingleChoice:
Collaboration diagram for assSingleChoice:
Public Member Functions | |
| assSingleChoice ($title="", $comment="", $author="", $owner=-1, $question="", $output_type=OUTPUT_ORDER) | |
| assSingleChoice constructor | |
| isComplete () | |
| Returns true, if a single choice question is complete for use. | |
| saveToDb ($original_id="") | |
| Saves a assSingleChoice object to a database. | |
| loadFromDb ($question_id) | |
| Loads a assSingleChoice object from a database. | |
| duplicate ($for_test=true, $title="", $author="", $owner="") | |
| Duplicates an assSingleChoiceQuestion. | |
| copyObject ($target_questionpool, $title="") | |
| Copies an assSingleChoice object. | |
| getOutputType () | |
| Gets the single choice output type. | |
| setOutputType ($output_type=OUTPUT_ORDER) | |
| Sets the single choice output type. | |
| addAnswer ($answertext="", $points=0.0, $points_unchecked=0.0, $order=0, $answerimage="") | |
| Adds a possible answer for a single choice question. | |
| getAnswerCount () | |
| Returns the number of answers. | |
| getAnswer ($index=0) | |
| Returns an answer. | |
| deleteAnswer ($index=0) | |
| Deletes an answer. | |
| flushAnswers () | |
| Deletes all answers. | |
| getMaximumPoints () | |
| Returns the maximum points, a learner can reach answering the question. | |
| calculateReachedPoints ($active_id, $pass=NULL) | |
| Returns the points, a learner has reached answering the question. | |
| saveWorkingData ($active_id, $pass=NULL) | |
| Saves the learners input of the question to the database. | |
| syncFeedbackSingleAnswers () | |
| Synchronizes the single answer feedback with an original question. | |
| syncWithOriginal () | |
| getQuestionType () | |
| Returns the question type of the question. | |
| getAdditionalTableName () | |
| Returns the name of the additional question data table in the database. | |
| getAnswerTableName () | |
| Returns the name of the answer table in the database. | |
| getGraphicalAnswerSetting () | |
| setGraphicalAnswerSetting ($a_setting=0) | |
| setImageFile ($image_filename, $image_tempfilename="") | |
| Sets the image file. | |
| deleteImage ($image_filename) | |
| Deletes an image file. | |
| duplicateImages ($question_id) | |
| copyImages ($question_id, $source_questionpool) | |
| saveFeedbackSingleAnswer ($answer_index, $feedback) | |
| Saves feedback for a single selected answer to the database. | |
| getFeedbackSingleAnswer ($answer_index) | |
| Returns the feedback for a single selected answer. | |
| duplicateFeedbackAnswer ($original_id) | |
| Duplicates the answer specific feedback. | |
| getRTETextWithMediaObjects () | |
| Collects all text in the question which could contain media objects which were created with the Rich Text Editor. | |
| & | getAnswers () |
| Returns a reference to the answers array. | |
Data Fields | |
| $answers | |
| $output_type | |
Protected Member Functions | |
| syncImages () | |
| Sync images of a MC question on synchronisation with the original question. | |
Detailed Description
Class for single choice questions.
assSingleChoice is a class for single choice questions.
- Version:
- Id:
- class.assSingleChoice.php 19624 2009-04-14 11:56:59Z hschottm
Definition at line 35 of file class.assSingleChoice.php.
Member Function Documentation
| assSingleChoice::addAnswer | ( | $ | answertext = "", |
|
| $ | points = 0.0, |
|||
| $ | points_unchecked = 0.0, |
|||
| $ | order = 0, |
|||
| $ | answerimage = "" | |||
| ) |
Adds a possible answer for a single choice question.
Adds a possible answer for a single choice question. A ASS_AnswerBinaryStateImage 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) boolean $state Defines the answer as correct (TRUE) or incorrect (FALSE) integer $order A possible display order of the answer double $points The points for not selecting the answer (even negative points can be used) public
- See also:
- $answers
- ASS_AnswerBinaryStateImage
Definition at line 428 of file class.assSingleChoice.php.
References assQuestion::$points.
{
$found = -1;
foreach ($this->answers as $key => $value)
{
if ($value->getOrder() == $order)
{
$found = $order;
}
}
include_once "./Modules/TestQuestionPool/classes/class.assAnswerBinaryStateImage.php";
if ($found >= 0)
{
// Antwort einfügen
$answer = new ASS_AnswerBinaryStateImage($answertext, $points, $found, 1, $answerimage);
array_push($this->answers, $answer);
for ($i = $found + 1; $i < count($this->answers); $i++)
{
$this->answers[$i] = $this->answers[$i-1];
}
$this->answers[$found] = $answer;
}
else
{
// Anwort anhängen
$answer = new ASS_AnswerBinaryStateImage($answertext, $points, count($this->answers), 1, $answerimage);
array_push($this->answers, $answer);
}
}
| assSingleChoice::assSingleChoice | ( | $ | title = "", |
|
| $ | comment = "", |
|||
| $ | author = "", |
|||
| $ | owner = -1, |
|||
| $ | question = "", |
|||
| $ | output_type = OUTPUT_ORDER | |||
| ) |
assSingleChoice constructor
The constructor takes possible arguments an creates an instance of the assSingleChoice 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 $question The question string of the single choice question integer $output_type The output order of the single choice answers public
- See also:
- assQuestion:assQuestion()
Definition at line 70 of file class.assSingleChoice.php.
References assQuestion::$author, assQuestion::$comment, $output_type, assQuestion::$owner, assQuestion::$question, assQuestion::$title, and assQuestion::assQuestion().
{
$this->assQuestion($title, $comment, $author, $owner, $question);
$this->output_type = $output_type;
$this->answers = array();
}
Here is the call graph for this function:
| assSingleChoice::calculateReachedPoints | ( | $ | active_id, | |
| $ | pass = NULL | |||
| ) |
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 571 of file class.assSingleChoice.php.
References $data, assQuestion::$points, assQuestion::getId(), and assQuestion::getSolutionMaxPass().
{
global $ilDB;
$found_values = array();
if (is_null($pass))
{
$pass = $this->getSolutionMaxPass($active_id);
}
$query = sprintf("SELECT * FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
$ilDB->quote($active_id . ""),
$ilDB->quote($this->getId() . ""),
$ilDB->quote($pass . "")
);
$result = $ilDB->query($query);
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
{
if (strcmp($data->value1, "") != 0)
{
array_push($found_values, $data->value1);
}
}
$points = 0;
foreach ($this->answers as $key => $answer)
{
if (count($found_values) > 0)
{
if (in_array($key, $found_values))
{
$points += $answer->getPoints();
}
}
}
$points = parent::calculateReachedPoints($active_id, $pass = NULL, $points);
return $points;
}
Here is the call graph for this function:
| assSingleChoice::copyImages | ( | $ | question_id, | |
| $ | source_questionpool | |||
| ) |
Definition at line 889 of file class.assSingleChoice.php.
References $filename, $ilLog, assQuestion::getImagePath(), and ilUtil::makeDirParents().
{
global $ilLog;
$imagepath = $this->getImagePath();
$imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
$imagepath_original = str_replace("/$this->obj_id/", "/$source_questionpool/", $imagepath_original);
if (!file_exists($imagepath))
{
ilUtil::makeDirParents($imagepath);
}
foreach ($this->answers as $answer)
{
$filename = $answer->getImage();
if (strlen($filename))
{
if (!copy($imagepath_original . $filename, $imagepath . $filename))
{
$ilLog->write("image could not be duplicated!!!!", $ilLog->ERROR);
$ilLog->write("object: " . print_r($this, TRUE), $ilLog->ERROR);
}
if (!copy($imagepath_original . $filename . ".thumb.jpg", $imagepath . $filename . ".thumb.jpg"))
{
$ilLog->write("image thumbnail could not be duplicated!!!!", $ilLog->ERROR);
$ilLog->write("object: " . print_r($this, TRUE), $ilLog->ERROR);
}
}
}
}
Here is the call graph for this function:
| assSingleChoice::copyObject | ( | $ | target_questionpool, | |
| $ | title = "" | |||
| ) |
Copies an assSingleChoice object.
Copies an assSingleChoice object
public
Definition at line 351 of file class.assSingleChoice.php.
References assQuestion::$title, assQuestion::_getOriginalId(), and assQuestion::getObjId().
{
if ($this->id <= 0)
{
// The question has not been saved. It cannot be duplicated
return;
}
// duplicate the question in database
$clone = $this;
include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
$original_id = assQuestion::_getOriginalId($this->id);
$clone->id = -1;
$source_questionpool = $this->getObjId();
$clone->setObjId($target_questionpool);
if ($title)
{
$clone->setTitle($title);
}
$clone->saveToDb();
// copy question page content
$clone->copyPageOfQuestion($original_id);
// copy XHTML media objects
$clone->copyXHTMLMediaObjectsOfQuestion($original_id);
// duplicate the image
$clone->copyImages($original_id, $source_questionpool);
// duplicate the generic feedback
$clone->duplicateFeedbackGeneric($original_id);
// duplicate the answer specific feedback
$clone->duplicateFeedbackAnswer($original_id);
return $clone->id;
}
Here is the call graph for this function:
| assSingleChoice::deleteAnswer | ( | $ | index = 0 |
) |
Deletes an answer.
Deletes 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 public
- See also:
- $answers
Definition at line 508 of file class.assSingleChoice.php.
References deleteImage().
{
if ($index < 0) return;
if (count($this->answers) < 1) return;
if ($index >= count($this->answers)) return;
$answer = $this->answers[$index];
if (strlen($answer->getImage())) $this->deleteImage($answer->getImage());
unset($this->answers[$index]);
$this->answers = array_values($this->answers);
for ($i = 0; $i < count($this->answers); $i++)
{
if ($this->answers[$i]->getOrder() > $index)
{
$this->answers[$i]->setOrder($i);
}
}
}
Here is the call graph for this function:
| assSingleChoice::deleteImage | ( | $ | image_filename | ) |
Deletes an image file.
Deletes an image file
- Parameters:
-
string $image_filename Name of the image file to delete private
Definition at line 853 of file class.assSingleChoice.php.
References assQuestion::getImagePath().
Referenced by deleteAnswer().
{
$imagepath = $this->getImagePath();
unlink($imagepath . $image_filename);
$thumbpath = $imagepath . $image_filename . "." . "thumb.jpg";
unlink($thumbpath);
}
Here is the call graph for this function:
Here is the caller graph for this function:
| assSingleChoice::duplicate | ( | $ | for_test = true, |
|
| $ | title = "", |
|||
| $ | author = "", |
|||
| $ | owner = "" | |||
| ) |
Duplicates an assSingleChoiceQuestion.
Duplicates an assSingleChoiceQuestion
public
Definition at line 294 of file class.assSingleChoice.php.
References assQuestion::$author, assQuestion::$owner, assQuestion::$title, assQuestion::_getOriginalId(), and assQuestion::getId().
{
if ($this->id <= 0)
{
// The question has not been saved. It cannot be duplicated
return;
}
// duplicate the question in database
$this_id = $this->getId();
$clone = $this;
include_once ("./Modules/TestQuestionPool/classes/class.assQuestion.php");
$original_id = assQuestion::_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($this_id);
// copy XHTML media objects
$clone->copyXHTMLMediaObjectsOfQuestion($this_id);
// duplicate the images
$clone->duplicateImages($this_id);
// duplicate the generic feedback
$clone->duplicateFeedbackGeneric($this_id);
// duplicate the answer specific feedback
$clone->duplicateFeedbackAnswer($this_id);
return $clone->id;
}
Here is the call graph for this function:
| assSingleChoice::duplicateFeedbackAnswer | ( | $ | original_id | ) |
Duplicates the answer specific feedback.
Duplicates the answer specific feedback
- Parameters:
-
integer $original_id The database ID of the original question public
Definition at line 1024 of file class.assSingleChoice.php.
{
global $ilDB;
$feedback = "";
$query = sprintf("SELECT * FROM qpl_feedback_singlechoice WHERE question_fi = %s",
$ilDB->quote($original_id . "")
);
$result = $ilDB->query($query);
if ($result->numRows())
{
while ($row = $result->fetchRow(DB_FETCHMODE_ASSOC))
{
$duplicatequery = sprintf("INSERT INTO qpl_feedback_singlechoice VALUES (NULL, %s, %s, %s, NULL)",
$ilDB->quote($this->getId() . ""),
$ilDB->quote($row["answer"] . ""),
$ilDB->quote($row["feedback"] . "")
);
$duplicateresult = $ilDB->query($duplicatequery);
}
}
}
| assSingleChoice::duplicateImages | ( | $ | question_id | ) |
Definition at line 861 of file class.assSingleChoice.php.
References $filename, $ilLog, assQuestion::getImagePath(), and ilUtil::makeDirParents().
{
global $ilLog;
$imagepath = $this->getImagePath();
$imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
if (!file_exists($imagepath))
{
ilUtil::makeDirParents($imagepath);
}
foreach ($this->answers as $answer)
{
$filename = $answer->getImage();
if (strlen($filename))
{
if (!copy($imagepath_original . $filename, $imagepath . $filename))
{
$ilLog->write("image could not be duplicated!!!!", $ilLog->ERROR);
$ilLog->write("object: " . print_r($this, TRUE), $ilLog->ERROR);
}
if (!copy($imagepath_original . $filename . ".thumb.jpg", $imagepath . $filename . ".thumb.jpg"))
{
$ilLog->write("image thumbnail could not be duplicated!!!!", $ilLog->ERROR);
$ilLog->write("object: " . print_r($this, TRUE), $ilLog->ERROR);
}
}
}
}
Here is the call graph for this function:
| assSingleChoice::flushAnswers | ( | ) |
Deletes all answers.
Deletes all answers
public
- See also:
- $answers
Definition at line 534 of file class.assSingleChoice.php.
{
$this->answers = array();
}
| assSingleChoice::getAdditionalTableName | ( | ) |
Returns the name of the additional question data table in the database.
Returns the name of the additional question data table in the database
- Returns:
- string The additional table name public
Reimplemented from assQuestion.
Definition at line 763 of file class.assSingleChoice.php.
{
return "qpl_question_singlechoice";
}
| assSingleChoice::getAnswer | ( | $ | 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_AnswerBinaryStateImage-Object containing the answer public
- See also:
- $answers
Definition at line 489 of file class.assSingleChoice.php.
{
if ($index < 0) return NULL;
if (count($this->answers) < 1) return NULL;
if ($index >= count($this->answers)) return NULL;
return $this->answers[$index];
}
| assSingleChoice::getAnswerCount | ( | ) |
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 473 of file class.assSingleChoice.php.
{
return count($this->answers);
}
| & assSingleChoice::getAnswers | ( | ) |
Returns a reference to the answers array.
Definition at line 1066 of file class.assSingleChoice.php.
{
return $this->answers;
}
| assSingleChoice::getAnswerTableName | ( | ) |
Returns the name of the answer table in the database.
Returns the name of the answer table in the database
- Returns:
- string The answer table name public
Reimplemented from assQuestion.
Definition at line 776 of file class.assSingleChoice.php.
{
return "qpl_answer_singlechoice";
}
| assSingleChoice::getFeedbackSingleAnswer | ( | $ | answer_index | ) |
Returns the feedback for a single selected answer.
Returns the feedback for a single selected answer
- Parameters:
-
integer $answer_index The index of the answer
- Returns:
- string Feedback text public
Definition at line 997 of file class.assSingleChoice.php.
References ilRTE::_replaceMediaObjectImageSrc().
Referenced by getRTETextWithMediaObjects().
{
global $ilDB;
$feedback = "";
$query = sprintf("SELECT * FROM qpl_feedback_singlechoice WHERE question_fi = %s AND answer = %s",
$ilDB->quote($this->getId() . ""),
$ilDB->quote($answer_index . "")
);
$result = $ilDB->query($query);
if ($result->numRows())
{
$row = $result->fetchRow(DB_FETCHMODE_ASSOC);
include_once("./Services/RTE/classes/class.ilRTE.php");
$feedback = ilRTE::_replaceMediaObjectImageSrc($row["feedback"], 1);
}
return $feedback;
}
Here is the call graph for this function:
Here is the caller graph for this function:
| assSingleChoice::getGraphicalAnswerSetting | ( | ) |
Definition at line 781 of file class.assSingleChoice.php.
{
global $ilUser;
$graphicalAnswerSetting = $ilUser->getPref("graphicalAnswerSetting");
if ($graphicalAnswerSetting != 1)
{
$graphicalAnswerSetting = 0;
}
return $graphicalAnswerSetting;
}
| assSingleChoice::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 assQuestion.
Definition at line 547 of file class.assSingleChoice.php.
References assQuestion::$points.
Referenced by isComplete(), and saveToDb().
{
$points = 0;
foreach ($this->answers as $key => $value)
{
if ($value->getPoints() > $points)
{
$points = $value->getPoints();
}
}
return $points;
}
Here is the caller graph for this function:
| assSingleChoice::getOutputType | ( | ) |
Gets the single choice output type.
Gets the single choice output type which is either OUTPUT_ORDER (=0) or OUTPUT_RANDOM (=1).
- Returns:
- integer The output type of the assSingleChoice object public
- See also:
- $output_type
Reimplemented from assQuestion.
Definition at line 394 of file class.assSingleChoice.php.
{
return $this->output_type;
}
| assSingleChoice::getQuestionType | ( | ) |
Returns the question type of the question.
Returns the question type of the question
- Returns:
- integer The question type of the question public
Reimplemented from assQuestion.
Definition at line 750 of file class.assSingleChoice.php.
{
return "assSingleChoice";
}
| assSingleChoice::getRTETextWithMediaObjects | ( | ) |
Collects all text in the question which could contain media objects which were created with the Rich Text Editor.
Reimplemented from assQuestion.
Definition at line 1051 of file class.assSingleChoice.php.
References getFeedbackSingleAnswer().
{
$text = parent::getRTETextWithMediaObjects();
foreach ($this->answers as $index => $answer)
{
$text .= $this->getFeedbackSingleAnswer($index);
$answer_obj = $this->answers[$index];
$text .= $answer_obj->getAnswertext();
}
return $text;
}
Here is the call graph for this function:
| assSingleChoice::isComplete | ( | ) |
Returns true, if a single choice question is complete for use.
Returns true, if a single choice question is complete for use
- Returns:
- boolean True, if the single choice question is complete for use, otherwise false public
Reimplemented from assQuestion.
Definition at line 92 of file class.assSingleChoice.php.
References getMaximumPoints().
Referenced by saveToDb().
{
if (($this->title) and ($this->author) and ($this->question) and (count($this->answers)) and ($this->getMaximumPoints() > 0))
{
foreach ($this->answers as $answer)
{
if ((strlen($answer->getAnswertext()) == 0) && (strlen($answer->getImage()) == 0)) return false;
}
return true;
}
else
{
return false;
}
}
Here is the call graph for this function:
Here is the caller graph for this function:
| assSingleChoice::loadFromDb | ( | $ | question_id | ) |
Loads a assSingleChoice object from a database.
Loads a assSingleChoice object from a database
- 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 assQuestion.
Definition at line 233 of file class.assSingleChoice.php.
References $data, ilRTE::_replaceMediaObjectImageSrc(), assQuestion::getImagePath(), assQuestion::setEstimatedWorkingTime(), setGraphicalAnswerSetting(), and assQuestion::setShuffle().
{
global $ilDB;
$hasimages = 0;
$query = sprintf("SELECT qpl_questions.*, qpl_question_singlechoice.* FROM qpl_questions, qpl_question_singlechoice WHERE question_id = %s AND qpl_questions.question_id = qpl_question_singlechoice.question_fi",
$ilDB->quote($question_id));
$result = $ilDB->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->title = $data->title;
$this->comment = $data->comment;
$this->solution_hint = $data->solution_hint;
$this->original_id = $data->original_id;
$this->obj_id = $data->obj_fi;
$this->author = $data->author;
$this->owner = $data->owner;
$this->points = $data->points;
include_once("./Services/RTE/classes/class.ilRTE.php");
$this->question = ilRTE::_replaceMediaObjectImageSrc($data->question_text, 1);
$this->setShuffle($data->shuffle);
$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_answer_singlechoice WHERE question_fi = %s ORDER BY aorder ASC",
$ilDB->quote($question_id));
$result = $ilDB->query($query);
include_once "./Modules/TestQuestionPool/classes/class.assAnswerBinaryStateImage.php";
if (strcmp(strtolower(get_class($result)), db_result) == 0)
{
while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
{
$imagefilename = $this->getImagePath() . $data->imagefile;
if (!@file_exists($imagefilename))
{
$data->imagefile = "";
}
include_once("./Services/RTE/classes/class.ilRTE.php");
$data->answertext = ilRTE::_replaceMediaObjectImageSrc($data->answertext, 1);
if (strlen($data->imagefile)) $hasimages = 1;
array_push($this->answers, new ASS_AnswerBinaryStateImage($data->answertext, $data->points, $data->aorder, 1, $data->imagefile));
}
}
}
$this->setGraphicalAnswerSetting($hasimages);
parent::loadFromDb($question_id);
}
Here is the call graph for this function:
| assSingleChoice::saveFeedbackSingleAnswer | ( | $ | answer_index, | |
| $ | feedback | |||
| ) |
Saves feedback for a single selected answer to the database.
Saves feedback for a single selected answer to the database
- Parameters:
-
integer $answer_index The index of the answer string $feedback Feedback text public
Definition at line 967 of file class.assSingleChoice.php.
References ilRTE::_replaceMediaObjectImageSrc().
{
global $ilDB;
$query = sprintf("DELETE FROM qpl_feedback_singlechoice WHERE question_fi = %s AND answer = %s",
$ilDB->quote($this->getId() . ""),
$ilDB->quote($answer_index . "")
);
$result = $ilDB->query($query);
if (strlen($feedback))
{
include_once("./Services/RTE/classes/class.ilRTE.php");
$query = sprintf("INSERT INTO qpl_feedback_singlechoice VALUES (NULL, %s, %s, %s, NULL)",
$ilDB->quote($this->getId() . ""),
$ilDB->quote($answer_index . ""),
$ilDB->quote(ilRTE::_replaceMediaObjectImageSrc($feedback, 0))
);
$result = $ilDB->query($query);
}
}
Here is the call graph for this function:
| assSingleChoice::saveToDb | ( | $ | original_id = "" |
) |
Saves a assSingleChoice object to a database.
Saves a assSingleChoice object to a database (experimental)
- Parameters:
-
object $db A pear DB object public
Reimplemented from assQuestion.
Definition at line 116 of file class.assSingleChoice.php.
References ilRTE::_replaceMediaObjectImageSrc(), assQuestion::createPageObject(), assQuestion::getEstimatedWorkingTime(), getMaximumPoints(), assQuestion::getTestId(), assQuestion::insertIntoTest(), and isComplete().
{
global $ilDB;
$complete = 0;
if ($this->isComplete())
{
$complete = 1;
}
$estw_time = $this->getEstimatedWorkingTime();
$estw_time = sprintf("%02d:%02d:%02d", $estw_time['h'], $estw_time['m'], $estw_time['s']);
if ($original_id)
{
$original_id = $ilDB->quote($original_id);
}
else
{
$original_id = "NULL";
}
include_once("./Services/RTE/classes/class.ilRTE.php");
if ($this->id == -1)
{
// Neuen Datensatz schreiben
$now = getdate();
$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, points, working_time, complete, created, original_id, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NULL)",
$ilDB->quote($this->getQuestionTypeID() . ""),
$ilDB->quote($this->obj_id),
$ilDB->quote($this->title),
$ilDB->quote($this->comment),
$ilDB->quote($this->author),
$ilDB->quote($this->owner),
$ilDB->quote(ilRTE::_replaceMediaObjectImageSrc($this->question, 0)),
$ilDB->quote($this->getMaximumPoints() . ""),
$ilDB->quote($estw_time),
$ilDB->quote("$complete"),
$ilDB->quote($created),
$original_id
);
$result = $ilDB->query($query);
if ($result == DB_OK)
{
$this->id = $ilDB->getLastInsertId();
$query = sprintf("INSERT INTO qpl_question_singlechoice (question_fi, shuffle) VALUES (%s, %s)",
$ilDB->quote($this->id . ""),
$ilDB->quote("$this->shuffle")
);
$ilDB->query($query);
// create page object of question
$this->createPageObject();
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, points = %s, working_time=%s, complete = %s WHERE question_id = %s",
$ilDB->quote($this->obj_id. ""),
$ilDB->quote($this->title),
$ilDB->quote($this->comment),
$ilDB->quote($this->author),
$ilDB->quote(ilRTE::_replaceMediaObjectImageSrc($this->question, 0)),
$ilDB->quote($this->getMaximumPoints() . ""),
$ilDB->quote($estw_time),
$ilDB->quote("$complete"),
$ilDB->quote($this->id)
);
$result = $ilDB->query($query);
$query = sprintf("UPDATE qpl_question_singlechoice SET shuffle = %s WHERE question_fi = %s",
$ilDB->quote("$this->shuffle"),
$ilDB->quote($this->id . "")
);
$result = $ilDB->query($query);
}
if ($result == DB_OK)
{
// Antworten schreiben
// alte Antworten löschen
$query = sprintf("DELETE FROM qpl_answer_singlechoice WHERE question_fi = %s",
$ilDB->quote($this->id)
);
$result = $ilDB->query($query);
// Anworten wegschreiben
foreach ($this->answers as $key => $value)
{
$answer_obj = $this->answers[$key];
$query = sprintf("INSERT INTO qpl_answer_singlechoice (answer_id, question_fi, answertext, points, aorder, imagefile) VALUES (NULL, %s, %s, %s, %s, %s)",
$ilDB->quote($this->id),
$ilDB->quote(ilRTE::_replaceMediaObjectImageSrc($answer_obj->getAnswertext(), 0)),
$ilDB->quote($answer_obj->getPoints() . ""),
$ilDB->quote($answer_obj->getOrder() . ""),
$ilDB->quote($answer_obj->getImage() . "")
);
$answer_result = $ilDB->query($query);
}
}
parent::saveToDb($original_id);
}
Here is the call graph for this function:
| assSingleChoice::saveWorkingData | ( | $ | active_id, | |
| $ | pass = NULL | |||
| ) |
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 assQuestion.
Definition at line 619 of file class.assSingleChoice.php.
References ilObjAssessmentFolder::_enabledAssessmentLogging(), ilObjAssessmentFolder::_getLogLanguage(), ilObjTest::_getPass(), assQuestion::getId(), and assQuestion::logAction().
{
global $ilDB;
global $ilUser;
if (is_null($pass))
{
include_once "./Modules/Test/classes/class.ilObjTest.php";
$pass = ilObjTest::_getPass($active_id);
}
$entered_values = 0;
$query = sprintf("SELECT * FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
$ilDB->quote($active_id . ""),
$ilDB->quote($this->getId() . ""),
$ilDB->quote($pass . "")
);
$result = $ilDB->query($query);
$row = $result->fetchRow(DB_FETCHMODE_OBJECT);
$update = $row->solution_id;
if ($update)
{
if (strlen($_POST["multiple_choice_result"]))
{
$query = sprintf("UPDATE tst_solutions SET value1 = %s WHERE solution_id = %s",
$ilDB->quote($_POST["multiple_choice_result"]),
$ilDB->quote($update)
);
$result = $ilDB->query($query);
$entered_values++;
}
else
{
$query = sprintf("DELETE FROM tst_solutions WHERE solution_id = %s",
$ilDB->quote($update)
);
$result = $ilDB->query($query);
}
}
else
{
if (strlen($_POST["multiple_choice_result"]))
{
$query = sprintf("INSERT INTO tst_solutions (solution_id, active_fi, question_fi, value1, value2, pass, TIMESTAMP) VALUES (NULL, %s, %s, %s, NULL, %s, NULL)",
$ilDB->quote($active_id),
$ilDB->quote($this->getId()),
$ilDB->quote($_POST["multiple_choice_result"]),
$ilDB->quote($pass . "")
);
$result = $ilDB->query($query);
$entered_values++;
}
}
if ($entered_values)
{
include_once ("./classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_user_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
}
}
else
{
include_once ("./classes/class.ilObjAssessmentFolder.php");
if (ilObjAssessmentFolder::_enabledAssessmentLogging())
{
$this->logAction($this->lng->txtlng("assessment", "log_user_not_entered_values", ilObjAssessmentFolder::_getLogLanguage()), $active_id, $this->getId());
}
}
parent::saveWorkingData($active_id, $pass);
return true;
}
Here is the call graph for this function:
| assSingleChoice::setGraphicalAnswerSetting | ( | $ | a_setting = 0 |
) |
Definition at line 793 of file class.assSingleChoice.php.
Referenced by loadFromDb().
{
global $ilUser;
$ilUser->writePref("graphicalAnswerSetting", $a_setting);
}
Here is the caller graph for this function:
| assSingleChoice::setImageFile | ( | $ | image_filename, | |
| $ | image_tempfilename = "" | |||
| ) |
Sets the image file.
Sets the image file and uploads the image to the object's image directory.
- Parameters:
-
string $image_filename Name of the original image file string $image_tempfilename Name of the temporary uploaded image file
- Returns:
- integer An errorcode if the image upload fails, 0 otherwise public
Definition at line 809 of file class.assSingleChoice.php.
References ilUtil::convertImage(), assQuestion::getImagePath(), ilObjMediaObject::getMimeType(), ilUtil::makeDirParents(), and ilUtil::moveUploadedFile().
{
$result = 0;
if (!empty($image_tempfilename))
{
$image_filename = str_replace(" ", "_", $image_filename);
$imagepath = $this->getImagePath();
if (!file_exists($imagepath))
{
ilUtil::makeDirParents($imagepath);
}
//if (!move_uploaded_file($image_tempfilename, $imagepath . $image_filename))
if (!ilUtil::moveUploadedFile($image_tempfilename, $image_filename, $imagepath.$image_filename))
{
$result = 2;
}
else
{
include_once "./Services/MediaObjects/classes/class.ilObjMediaObject.php";
$mimetype = ilObjMediaObject::getMimeType($imagepath . $image_filename);
if (!preg_match("/^image/", $mimetype))
{
unlink($imagepath . $image_filename);
$result = 1;
}
else
{
// create thumbnail file
$thumbpath = $imagepath . $image_filename . "." . "thumb.jpg";
ilUtil::convertImage($imagepath.$image_filename, $thumbpath, "JPEG", 100);
}
}
}
return $result;
}
Here is the call graph for this function:
| assSingleChoice::setOutputType | ( | $ | output_type = OUTPUT_ORDER |
) |
Sets the single choice output type.
Sets the output type of the assSingleChoice object
- Parameters:
-
integer $output_type A nonnegative integer value specifying the output type. It is OUTPUT_ORDER (=0) or OUTPUT_RANDOM (=1). public
- See also:
- $response
Reimplemented from assQuestion.
Definition at line 408 of file class.assSingleChoice.php.
References $output_type.
{
$this->output_type = $output_type;
}
| assSingleChoice::syncFeedbackSingleAnswers | ( | ) |
Synchronizes the single answer feedback with an original question.
Synchronizes the single answer feedback with an original question
public
Definition at line 699 of file class.assSingleChoice.php.
Referenced by syncWithOriginal().
{
global $ilDB;
$feedback = "";
// delete generic feedback of the original
$deletequery = sprintf("DELETE FROM qpl_feedback_singlechoice WHERE question_fi = %s",
$ilDB->quote($this->original_id . "")
);
$result = $ilDB->query($deletequery);
// get generic feedback of the actual question
$query = sprintf("SELECT * FROM qpl_feedback_singlechoice WHERE question_fi = %s",
$ilDB->quote($this->getId() . "")
);
$result = $ilDB->query($query);
// save generic feedback to the original
if ($result->numRows())
{
while ($row = $result->fetchRow(DB_FETCHMODE_ASSOC))
{
$duplicatequery = sprintf("INSERT INTO qpl_feedback_singlechoice VALUES (NULL, %s, %s, %s, NULL)",
$ilDB->quote($this->original_id . ""),
$ilDB->quote($row["answer"] . ""),
$ilDB->quote($row["feedback"] . "")
);
$duplicateresult = $ilDB->query($duplicatequery);
}
}
}
Here is the caller graph for this function:
| assSingleChoice::syncImages | ( | ) | [protected] |
Sync images of a MC question on synchronisation with the original question.
Definition at line 921 of file class.assSingleChoice.php.
References $filename, $ilLog, ilUtil::delDir(), assQuestion::getImagePath(), assQuestion::getOriginalId(), and ilUtil::makeDirParents().
Referenced by syncWithOriginal().
{
global $ilLog;
$question_id = $this->getOriginalId();
$imagepath = $this->getImagePath();
$imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
if (!file_exists($imagepath))
{
ilUtil::makeDirParents($imagepath);
}
ilUtil::delDir($imagepath_original);
ilUtil::makeDirParents($imagepath_original);
foreach ($this->answers as $answer)
{
$filename = $answer->getImage();
if (strlen($filename))
{
if (@file_exists($imagepath . $filename))
{
if (!@copy($imagepath . $filename, $imagepath_original . $filename))
{
$ilLog->write("image could not be duplicated!!!!", $ilLog->ERROR);
$ilLog->write("object: " . print_r($this, TRUE), $ilLog->ERROR);
}
}
if (@file_exists($imagepath . $filename . ".thumb.jpg"))
{
if (!@copy($imagepath . $filename . ".thumb.jpg", $imagepath_original . $filename . ".thumb.jpg"))
{
$ilLog->write("image thumbnail could not be duplicated!!!!", $ilLog->ERROR);
$ilLog->write("object: " . print_r($this, TRUE), $ilLog->ERROR);
}
}
}
}
}
Here is the call graph for this function:
Here is the caller graph for this function:
| assSingleChoice::syncWithOriginal | ( | ) |
Reimplemented from assQuestion.
Definition at line 732 of file class.assSingleChoice.php.
References assQuestion::getOriginalId(), syncFeedbackSingleAnswers(), and syncImages().
{
if ($this->getOriginalId())
{
$this->syncFeedbackSingleAnswers();
$this->syncImages();
parent::syncWithOriginal();
}
}
Here is the call graph for this function:
Field Documentation
| assSingleChoice::$answers |
Definition at line 44 of file class.assSingleChoice.php.
| assSingleChoice::$output_type |
Definition at line 54 of file class.assSingleChoice.php.
Referenced by assSingleChoice(), and setOutputType().
The documentation for this class was generated from the following file:
- Modules/TestQuestionPool/classes/class.assSingleChoice.php
