Public Member Functions | Data Fields

assMatchingQuestion Class Reference

Class for matching questions. More...

Inheritance diagram for assMatchingQuestion:
Collaboration diagram for assMatchingQuestion:

Public Member Functions

 assMatchingQuestion ($title="", $comment="", $author="", $owner=-1, $question="", $matching_type=MT_TERMS_DEFINITIONS)
 assMatchingQuestion constructor
 isComplete ()
 Returns true, if a matching question is complete for use.
 fromXML (&$item, &$questionpool_id, &$tst_id, &$tst_object, &$question_counter, &$import_mapping)
 Creates a question from a QTI file.
 to_xml ($a_include_header=true, $a_include_binary=true, $a_shuffle=false, $test_output=false, $force_image_references=false)
 Returns a QTI xml representation of the question.
 saveToDb ($original_id="")
 Saves a assMatchingQuestion object to a database.
 loadFromDb ($question_id)
 Loads a assMatchingQuestion object from a database.
 addMatchingPair ($answertext, $points, $answerorder, $matchingtext, $matchingorder)
 Adds an answer to the question.
 duplicate ($for_test=true, $title="", $author="", $owner="")
 Duplicates an assMatchingQuestion.
 copyObject ($target_questionpool, $title="")
 Copies an assMatchingQuestion.
 duplicateImages ($question_id)
 copyImages ($question_id, $source_questionpool)
 setQuestion ($question="")
 Sets the matching question text.
 setMatchingType ($matching_type=MT_TERMS_DEFINITIONS)
 Sets the matching question type.
 getQuestion ()
 Returns the question text.
 get_matching_type ()
 Returns the matching question type.
 add_matchingpair ($term="", $picture_or_definition="", $points=0.0, $term_id=0, $picture_or_definition_id=0)
 Adds an matching pair for an matching question.
 get_matchingpair ($index=0)
 Returns a matching pair.
 delete_matchingpair ($index=0)
 Deletes a matching pair.
 flush_matchingpairs ()
 Deletes all matching pairs.
 get_matchingpair_count ()
 Returns the number of matching pairs.
 calculateReachedPoints ($active_id, $pass=NULL)
 Returns the points, a learner has reached answering the question.
 getMaximumPoints ()
 Returns the maximum points, a learner can reach answering the question.
 setImageFile ($image_filename, $image_tempfilename="")
 Sets the image file.
 checkSaveData ()
 Checks the data to be saved for consistency.
 saveWorkingData ($active_id, $pass=NULL)
 Saves the learners input of the question to the database.
 get_random_id ()
 syncWithOriginal ()
 pc_array_shuffle ($array)
 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.

Data Fields

 $question
 $matchingpairs
 $matching_type

Detailed Description

Class for matching questions.

assMatchingQuestion is a class for matching questions.

Author:
Helmut Schottmüller <helmut.schottmueller@mac.com>
Version:
Id:
class.assMatchingQuestion.php 14646 2007-09-04 10:03:31Z hschottm

class.assMatchingQuestion.php Assessment

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


Member Function Documentation

assMatchingQuestion::add_matchingpair ( term = "",
picture_or_definition = "",
points = 0.0,
term_id = 0,
picture_or_definition_id = 0 
)

Adds an matching pair for an matching question.

Adds an matching pair for an matching choice question. The students have to fill in an order for the matching pair. The matching pair is an ASS_AnswerMatching object that will be created and assigned to the array $this->matchingpairs.

Parameters:
string $answertext The answer text
string $matchingtext The matching text of the answer text
double $points The points for selecting the matching pair (even negative points can be used)
integer $order A possible display order of the matching pair public
See also:
$matchingpairs
ASS_AnswerMatching

Definition at line 1031 of file class.assMatchingQuestion.php.

References assQuestion::$points, and get_random_id().

        {
                // append answer
                if ($term_id == 0)
                {
                        $term_id = $this->get_random_id();
                }

                if ($picture_or_definition_id == 0)
                {
                        $picture_or_definition_id = $this->get_random_id();
                }
                include_once "./assessment/classes/class.assAnswerMatching.php";
                $matchingpair = new ASS_AnswerMatching($term, $points, $term_id, $picture_or_definition, $picture_or_definition_id);
                array_push($this->matchingpairs, $matchingpair);
        }

Here is the call graph for this function:

assMatchingQuestion::addMatchingPair ( answertext,
points,
answerorder,
matchingtext,
matchingorder 
)

Adds an answer to the question.

Adds an answer to the question

public

Definition at line 816 of file class.assMatchingQuestion.php.

References assQuestion::$points.

Referenced by fromXML().

        {
                include_once "./assessment/classes/class.assAnswerMatching.php";
                array_push($this->matchingpairs, new ASS_AnswerMatching($answertext, $points, $answerorder, $matchingtext, $matchingorder));
        }

Here is the caller graph for this function:

assMatchingQuestion::assMatchingQuestion ( title = "",
comment = "",
author = "",
owner = -1,
question = "",
matching_type = MT_TERMS_DEFINITIONS 
)

assMatchingQuestion constructor

The constructor takes possible arguments an creates an instance of the assMatchingQuestion 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 matching question public

Definition at line 79 of file class.assMatchingQuestion.php.

References assQuestion::$author, assQuestion::$comment, $matching_type, assQuestion::$owner, $question, assQuestion::$title, and assQuestion::assQuestion().

        {
                $this->assQuestion($title, $comment, $author, $owner);
                $this->matchingpairs = array();
                $this->question = $question;
                $this->matching_type = $matching_type;
        }

Here is the call graph for this function:

assMatchingQuestion::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 1148 of file class.assMatchingQuestion.php.

References $data, $key, assQuestion::$points, $query, $result, assQuestion::getId(), and assQuestion::getSolutionMaxPass().

        {
                global $ilDB;
                
                $found_value1 = array();
                $found_value2 = 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_value1, $data->value1);
                                array_push($found_value2, $data->value2);
                        }
                }
                $points = 0;
                foreach ($found_value2 as $key => $value)
                {
                        foreach ($this->matchingpairs as $answer_key => $answer_value)
                        {
                                if (($answer_value->getDefinitionId() == $value) and ($answer_value->getTermId() == $found_value1[$key]))
                                {
                                        $points += $answer_value->getPoints();
                                }
                        }
                }

                $points = parent::calculateReachedPoints($active_id, $pass = NULL, $points);
                return $points;
        }

Here is the call graph for this function:

assMatchingQuestion::checkSaveData (  ) 

Checks the data to be saved for consistency.

Checks the data to be saved for consistency

Returns:
boolean True, if the check was ok, False otherwise public
See also:
$answers

Definition at line 1264 of file class.assMatchingQuestion.php.

References $_POST, $key, $result, and sendInfo().

Referenced by saveWorkingData().

        {
                $result = true;
                $matching_values = array();
                foreach ($_POST as $key => $value)
                {
                        if (preg_match("/^sel_matching_(\d+)/", $key, $matches))
                        {
                                if ((strcmp($value, "") != 0) && ($value != -1))
                                {
                                        array_push($matching_values, $value);
                                }
                        }
                }
                $check_matching = array_flip($matching_values);
                if (count($check_matching) != count($matching_values))
                {
                        // duplicate matching values!!!
                        $result = false;
                        sendInfo($this->lng->txt("duplicate_matching_values_selected"), TRUE);
                }
                return $result;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assMatchingQuestion::copyImages ( question_id,
source_questionpool 
)

Definition at line 935 of file class.assMatchingQuestion.php.

References get_matching_type(), assQuestion::getImagePath(), and ilUtil::makeDirParents().

        {
                if ($this->get_matching_type() == MT_TERMS_PICTURES)
                {
                        $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->matchingpairs as $answer)
                        {
                                $filename = $answer->getPicture();
                                if (!copy($imagepath_original . $filename, $imagepath . $filename))
                                {
                                        print "image could not be duplicated!!!! ";
                                }
                                if (!copy($imagepath_original . $filename . ".thumb.jpg", $imagepath . $filename . ".thumb.jpg"))
                                {
                                        print "image thumbnail could not be duplicated!!!! ";
                                }
                        }
                }
        }

Here is the call graph for this function:

assMatchingQuestion::copyObject ( target_questionpool,
title = "" 
)

Copies an assMatchingQuestion.

Copies an assMatchingQuestion

public

Definition at line 880 of file class.assMatchingQuestion.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 ("./assessment/classes/class.assQuestion.php");
                $original_id = assQuestion::_getOriginalId($this->id);
                $clone->id = -1;
                if ($title)
                {
                        $clone->setTitle($title);
                }
                $source_questionpool = $this->getObjId();
                $clone->setObjId($target_questionpool);
                $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);
                return $clone->id;
        }

Here is the call graph for this function:

assMatchingQuestion::delete_matchingpair ( index = 0  ) 

Deletes a matching pair.

Deletes a matching pair with a given index. The index of the first matching pair is 0, the index of the second matching pair is 1 and so on.

Parameters:
integer $index A nonnegative index of the n-th matching pair public
See also:
$matchingpairs

Definition at line 1092 of file class.assMatchingQuestion.php.

        {
                if ($index < 0)
                {
                        return;
                }
                if (count($this->matchingpairs) < 1)
                {
                        return;
                }
                if ($index >= count($this->matchingpairs))
                {
                        return;
                }
                unset($this->matchingpairs[$index]);
                $this->matchingpairs = array_values($this->matchingpairs);
        }

assMatchingQuestion::duplicate ( for_test = true,
title = "",
author = "",
owner = "" 
)

Duplicates an assMatchingQuestion.

Duplicates an assMatchingQuestion

public

Definition at line 830 of file class.assMatchingQuestion.php.

References assQuestion::$author, assQuestion::$owner, assQuestion::$title, assQuestion::_getOriginalId(), and assQuestion::getId().

Referenced by fromXML().

        {
                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 ("./assessment/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 image
                $clone->duplicateImages($this_id);
                return $clone->id;
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assMatchingQuestion::duplicateImages ( question_id  ) 

Definition at line 910 of file class.assMatchingQuestion.php.

References get_matching_type(), assQuestion::getImagePath(), and ilUtil::makeDirParents().

        {
                if ($this->get_matching_type() == MT_TERMS_PICTURES)
                {
                        $imagepath = $this->getImagePath();
                        $imagepath_original = str_replace("/$this->id/images", "/$question_id/images", $imagepath);
                        if (!file_exists($imagepath))
                        {
                                ilUtil::makeDirParents($imagepath);
                        }
                        foreach ($this->matchingpairs as $answer)
                        {
                                $filename = $answer->getPicture();
                                if (!copy($imagepath_original . $filename, $imagepath . $filename))
                                {
                                        print "image could not be duplicated!!!! ";
                                }
                                if (!copy($imagepath_original . $filename . ".thumb.jpg", $imagepath . $filename . ".thumb.jpg"))
                                {
                                        print "image thumbnail could not be duplicated!!!! ";
                                }
                        }
                }
        }

Here is the call graph for this function:

assMatchingQuestion::flush_matchingpairs (  ) 

Deletes all matching pairs.

Deletes all matching pairs

public

See also:
$matchingpairs

Definition at line 1118 of file class.assMatchingQuestion.php.

        {
                $this->matchingpairs = array();
        }

assMatchingQuestion::fromXML ( &$  item,
&$  questionpool_id,
&$  tst_id,
&$  tst_object,
&$  question_counter,
&$  import_mapping 
)

Creates a question from a QTI file.

Receives parameters from a QTI parser and creates a valid ILIAS question object

Parameters:
object $item The QTI item object
integer $questionpool_id The id of the parent questionpool
integer $tst_id The id of the parent test if the question is part of a test
object $tst_object A reference to the parent test object
integer $question_counter A reference to a question counter to count the questions of an imported question pool
array $import_mapping An array containing references to included ILIAS objects public

Definition at line 127 of file class.assMatchingQuestion.php.

References $_SESSION, assQuestion::$shuffle, $type, ilObjQuestionPool::_getImportDirectory(), ilObjTest::_getImportDirectory(), ilRTE::_replaceMediaObjectImageSrc(), ilObjMediaObject::_saveTempFileAsMediaObject(), ilObjMediaObject::_saveUsage(), addMatchingPair(), ilUtil::convertImage(), duplicate(), getContent(), assQuestion::getId(), assQuestion::getImagePath(), getQuestion(), ilUtil::makeDirParents(), assQuestion::QTIMaterialToString(), saveToDb(), assQuestion::setAuthor(), assQuestion::setComment(), assQuestion::setEstimatedWorkingTime(), setMatchingType(), assQuestion::setObjId(), assQuestion::setOwner(), setQuestion(), assQuestion::setShuffle(), assQuestion::setSuggestedSolution(), and assQuestion::setTitle().

        {
                global $ilUser;

                // empty session variable for imported xhtml mobs
                unset($_SESSION["import_mob_xhtml"]);
                $presentation = $item->getPresentation(); 
                $duration = $item->getDuration();
                $shuffle = 0;
                $now = getdate();
                $created = sprintf("%04d%02d%02d%02d%02d%02d", $now['year'], $now['mon'], $now['mday'], $now['hours'], $now['minutes'], $now['seconds']);
                $terms = array();
                $matches = array();
                $foundimage = FALSE;
                foreach ($presentation->order as $entry)
                {
                        switch ($entry["type"])
                        {
                                case "response":
                                        $response = $presentation->response[$entry["index"]];
                                        $rendertype = $response->getRenderType();
                                        switch (strtolower(get_class($rendertype)))
                                        {
                                                case "ilqtirenderchoice":
                                                        $shuffle = $rendertype->getShuffle();
                                                        $answerorder = 0;
                                                        foreach ($rendertype->response_labels as $response_label)
                                                        {
                                                                $ident = $response_label->getIdent();
                                                                $answertext = "";
                                                                $answerimage = array();
                                                                foreach ($response_label->material as $mat)
                                                                {
                                                                        for ($m = 0; $m < $mat->getMaterialCount(); $m++)
                                                                        {
                                                                                $foundmat = $mat->getMaterial($m);
                                                                                if (strcmp($foundmat["type"], "mattext") == 0)
                                                                                {
                                                                                        $answertext .= $foundmat["material"]->getContent();
                                                                                }
                                                                                if (strcmp($foundmat["type"], "matimage") == 0)
                                                                                {
                                                                                        $foundimage = TRUE;
                                                                                        $answerimage = array(
                                                                                                "imagetype" => $foundmat["material"]->getImageType(),
                                                                                                "label" => $foundmat["material"]->getLabel(),
                                                                                                "content" => $foundmat["material"]->getContent()
                                                                                        );
                                                                                }
                                                                        }
                                                                }
                                                                if (($response_label->getMatchMax() == 1) && (strlen($response_label->getMatchGroup())))
                                                                {
                                                                        $terms[$ident] = array(
                                                                                "answertext" => $answertext,
                                                                                "answerimage" => $answerimage,
                                                                                "points" => 0,
                                                                                "answerorder" => $ident,
                                                                                "action" => ""
                                                                        );
                                                                }
                                                                else
                                                                {
                                                                        $matches[$ident] = array(
                                                                                "answertext" => $answertext,
                                                                                "answerimage" => $answerimage,
                                                                                "points" => 0,
                                                                                "matchingorder" => $ident,
                                                                                "action" => ""
                                                                        );
                                                                }
                                                        }
                                                        break;
                                        }
                                        break;
                        }
                }
                $responses = array();
                foreach ($item->resprocessing as $resprocessing)
                {
                        foreach ($resprocessing->respcondition as $respcondition)
                        {
                                $subset = array();
                                $correctness = 1;
                                $conditionvar = $respcondition->getConditionvar();
                                foreach ($conditionvar->order as $order)
                                {
                                        switch ($order["field"])
                                        {
                                                case "varsubset":
                                                        $subset = split(",", $conditionvar->varsubset[$order["index"]]->getContent());
                                                        break;
                                        }
                                }
                                foreach ($respcondition->setvar as $setvar)
                                {
                                        array_push($responses, array("subset" => $subset, "action" => $setvar->getAction(), "points" => $setvar->getContent())); 
                                }
                        }
                }
                $type = 1;
                if ($foundimage)
                {
                        $type = 0;
                }
                $this->setTitle($item->getTitle());
                $this->setComment($item->getComment());
                $this->setAuthor($item->getAuthor());
                $this->setOwner($ilUser->getId());
                $this->setQuestion($this->QTIMaterialToString($item->getQuestiontext()));
                $this->setMatchingType($type);
                $this->setObjId($questionpool_id);
                $this->setEstimatedWorkingTime($duration["h"], $duration["m"], $duration["s"]);
                $this->setShuffle($shuffle);
                foreach ($responses as $response)
                {
                        $subset = $response["subset"];
                        $term = array();
                        $match = array();
                        foreach ($subset as $ident)
                        {
                                if (array_key_exists($ident, $terms))
                                {
                                        $term = $terms[$ident];
                                }
                                if (array_key_exists($ident, $matches))
                                {
                                        $match = $matches[$ident];
                                }
                        }
                        if ($type == 0)
                        {
                                $this->addMatchingPair($match["answertext"], $response["points"], $match["matchingorder"], $term["answerimage"]["label"], $term["answerorder"]);
                        }
                        else
                        {
                                $this->addMatchingPair($match["answertext"], $response["points"], $match["matchingorder"], $term["answertext"], $term["answerorder"]);
                        }
                }
                $this->saveToDb();
                if (count($item->suggested_solutions))
                {
                        foreach ($item->suggested_solutions as $suggested_solution)
                        {
                                $this->setSuggestedSolution($suggested_solution["solution"]->getContent(), $suggested_solution["gap_index"], true);
                        }
                        $this->saveToDb();
                }
                foreach ($responses as $response)
                {
                        $subset = $response["subset"];
                        $term = array();
                        $match = array();
                        foreach ($subset as $ident)
                        {
                                if (array_key_exists($ident, $terms))
                                {
                                        $term = $terms[$ident];
                                }
                                if (array_key_exists($ident, $matches))
                                {
                                        $match = $matches[$ident];
                                }
                        }
                        if ($type == 0)
                        {
                                $image =& base64_decode($term["answerimage"]["content"]);
                                $imagepath = $this->getImagePath();
                                include_once "./classes/class.ilUtil.php";
                                if (!file_exists($imagepath))
                                {
                                        ilUtil::makeDirParents($imagepath);
                                }
                                $imagepath .=  $term["answerimage"]["label"];
                                $fh = fopen($imagepath, "wb");
                                if ($fh == false)
                                {
//                                                                      global $ilErr;
//                                                                      $ilErr->raiseError($this->lng->txt("error_save_image_file") . ": $php_errormsg", $ilErr->MESSAGE);
//                                                                      return;
                                }
                                else
                                {
                                        $imagefile = fwrite($fh, $image);
                                        fclose($fh);
                                }
                                // create thumbnail file
                                $thumbpath = $imagepath . "." . "thumb.jpg";
                                ilUtil::convertImage($imagepath, $thumbpath, "JPEG", 100);
                        }
                }
                // handle the import of media objects in XHTML code
                if (is_array($_SESSION["import_mob_xhtml"]))
                {
                        include_once "./content/classes/Media/class.ilObjMediaObject.php";
                        include_once "./Services/RTE/classes/class.ilRTE.php";
                        foreach ($_SESSION["import_mob_xhtml"] as $mob)
                        {
                                if ($tst_id > 0)
                                {
                                        include_once "./assessment/classes/class.ilObjTest.php";
                                        $importfile = ilObjTest::_getImportDirectory() . "/" . $_SESSION["tst_import_subdir"] . "/" . $mob["uri"];
                                }
                                else
                                {
                                        include_once "./assessment/classes/class.ilObjQuestionPool.php";
                                        $importfile = ilObjQuestionPool::_getImportDirectory() . "/" . $_SESSION["qpl_import_subdir"] . "/" . $mob["uri"];
                                }
                                $media_object =& ilObjMediaObject::_saveTempFileAsMediaObject(basename($importfile), $importfile, FALSE);
                                ilObjMediaObject::_saveUsage($media_object->getId(), "qpl:html", $this->getId());
                                $this->setQuestion(ilRTE::_replaceMediaObjectImageSrc(str_replace("src=\"" . $mob["mob"] . "\"", "src=\"" . "il_" . IL_INST_ID . "_mob_" . $media_object->getId() . "\"", $this->getQuestion()), 1));
                        }
                        $this->saveToDb();
                }
                if ($tst_id > 0)
                {
                        $q_1_id = $this->getId();
                        $question_id = $this->duplicate(true);
                        $tst_object->questions[$question_counter++] = $question_id;
                        $import_mapping[$item->getIdent()] = array("pool" => $q_1_id, "test" => $question_id);
                }
                else
                {
                        $import_mapping[$item->getIdent()] = array("pool" => $this->getId(), "test" => 0);
                }
                //$ilLog->write(strftime("%D %T") . ": finished import multiple choice question (single response)");
        }

Here is the call graph for this function:

assMatchingQuestion::get_matching_type (  ) 

Returns the matching question type.

Returns the matching question type

Returns:
integer The matching question type public
See also:
$matching_type

Definition at line 1012 of file class.assMatchingQuestion.php.

Referenced by copyImages(), duplicateImages(), and to_xml().

        {
                return $this->matching_type;
        }

Here is the caller graph for this function:

assMatchingQuestion::get_matchingpair ( index = 0  ) 

Returns a matching pair.

Returns a matching pair with a given index. The index of the first matching pair is 0, the index of the second matching pair is 1 and so on.

Parameters:
integer $index A nonnegative index of the n-th matching pair
Returns:
object ASS_AnswerMatching-Object public
See also:
$matchingpairs

Definition at line 1065 of file class.assMatchingQuestion.php.

        {
                if ($index < 0)
                {
                        return NULL;
                }
                if (count($this->matchingpairs) < 1)
                {
                        return NULL;
                }
                if ($index >= count($this->matchingpairs))
                {
                        return NULL;
                }
                return $this->matchingpairs[$index];
        }

assMatchingQuestion::get_matchingpair_count (  ) 

Returns the number of matching pairs.

Returns the number of matching pairs

Returns:
integer The number of matching pairs of the matching question public
See also:
$matchingpairs

Definition at line 1132 of file class.assMatchingQuestion.php.

        {
                return count($this->matchingpairs);
        }

assMatchingQuestion::get_random_id (  ) 

Definition at line 1359 of file class.assMatchingQuestion.php.

References $key.

Referenced by add_matchingpair().

        {
                mt_srand((double)microtime()*1000000);
                $random_number = mt_rand(1, 100000);
                $found = FALSE;
                while ($found)
                {
                        $found = FALSE;
                        foreach ($this->matchingpairs as $key => $value)
                        {
                                if (($value->getTermId() == $random_number) || ($value->getDefinitionId() == $random_number))
                                {
                                        $found = TRUE;
                                        $random_number++;
                                }
                        }
                }
                return $random_number;
        }

Here is the caller graph for this function:

assMatchingQuestion::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 1478 of file class.assMatchingQuestion.php.

        {
                return "qpl_question_matching";
        }

assMatchingQuestion::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 1491 of file class.assMatchingQuestion.php.

        {
                return "qpl_answer_matching";
        }

assMatchingQuestion::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 1196 of file class.assMatchingQuestion.php.

References $key, and assQuestion::$points.

Referenced by isComplete(), saveToDb(), and syncWithOriginal().

        {
                $points = 0;
                foreach ($this->matchingpairs as $key => $value)
                {
                        if ($value->getPoints() > 0)
                        {
                                $points += $value->getPoints();
                        }
                }
                return $points;
        }

Here is the caller graph for this function:

assMatchingQuestion::getQuestion (  ) 

Returns the question text.

Returns the question text

Returns:
string The question text string public
See also:
$question

Definition at line 998 of file class.assMatchingQuestion.php.

Referenced by fromXML(), and to_xml().

        {
                return $this->question;
        }

Here is the caller graph for this function:

assMatchingQuestion::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 1465 of file class.assMatchingQuestion.php.

Referenced by saveToDb().

        {
                return 4;
        }

Here is the caller graph for this function:

assMatchingQuestion::isComplete (  ) 

Returns true, if a matching question is complete for use.

Returns true, if a matching question is complete for use

Returns:
boolean True, if the matching question is complete for use, otherwise false public

Reimplemented from assQuestion.

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

References getMaximumPoints().

Referenced by saveToDb(), and syncWithOriginal().

        {
                if (($this->title) and ($this->author) and ($this->question) and (count($this->matchingpairs)) and ($this->getMaximumPoints() > 0))
                {
                        return true;
                }
                else
                {
                        return false;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assMatchingQuestion::loadFromDb ( question_id  ) 

Loads a assMatchingQuestion object from a database.

Loads a assMatchingQuestion 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 assQuestion.

Definition at line 764 of file class.assMatchingQuestion.php.

References $data, $query, $result, ilRTE::_replaceMediaObjectImageSrc(), and assQuestion::setEstimatedWorkingTime().

        {
                global $ilDB;

    $query = sprintf("SELECT qpl_questions.*, qpl_question_matching.* FROM qpl_questions, qpl_question_matching WHERE question_id = %s AND qpl_questions.question_id = qpl_question_matching.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->author = $data->author;
                                $this->solution_hint = $data->solution_hint;
                                $this->obj_id = $data->obj_fi;
                                $this->original_id = $data->original_id;
                                $this->owner = $data->owner;
                                $this->matching_type = $data->matching_type;
                                include_once("./Services/RTE/classes/class.ilRTE.php");
                                $this->question = ilRTE::_replaceMediaObjectImageSrc($data->question_text, 1);
                                $this->points = $data->points;
                                $this->shuffle = $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_matching WHERE question_fi = %s ORDER BY answer_id ASC",
                                $ilDB->quote($question_id)
                        );
                        $result = $ilDB->query($query);
                        include_once "./assessment/classes/class.assAnswerMatching.php";
                        if (strcmp(strtolower(get_class($result)), db_result) == 0)
                        {
                                while ($data = $result->fetchRow(DB_FETCHMODE_OBJECT))
                                {
                                        array_push($this->matchingpairs, new ASS_AnswerMatching($data->answertext, $data->points, $data->aorder, $data->matchingtext, $data->matching_order));
                                }
                        }
                }
                parent::loadFromDb($question_id);
        }

Here is the call graph for this function:

assMatchingQuestion::pc_array_shuffle ( array  ) 

Definition at line 1440 of file class.assMatchingQuestion.php.

                                          {
                $i = count($array);
                mt_srand((double)microtime()*1000000);
                while(--$i) 
                {
                        $j = mt_rand(0, $i);
                        if ($i != $j) 
                        {
                                // swap elements
                                $tmp = $array[$j];
                                $array[$j] = $array[$i];
                                $array[$i] = $tmp;
                        }
                }
                return $array;
        }

assMatchingQuestion::saveToDb ( original_id = ""  ) 

Saves a assMatchingQuestion object to a database.

Saves a assMatchingQuestion object to a database (experimental)

Parameters:
object $db A pear DB object public

Reimplemented from assQuestion.

Definition at line 637 of file class.assMatchingQuestion.php.

References $key, $query, $result, ilRTE::_cleanupMediaObjectUsage(), ilRTE::_replaceMediaObjectImageSrc(), assQuestion::createPageObject(), assQuestion::getEstimatedWorkingTime(), assQuestion::getId(), getMaximumPoints(), getQuestionType(), assQuestion::getTestId(), assQuestion::insertIntoTest(), and isComplete().

Referenced by fromXML().

        {
                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";
                }

                // cleanup RTE images which are not inserted into the question text
                include_once("./Services/RTE/classes/class.ilRTE.php");
                ilRTE::_cleanupMediaObjectUsage($this->question, "qpl:html",
                        $this->getId());

                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, complete, created, original_id, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, NULL)",
                                $ilDB->quote($question_type. ""),
                                $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($estw_time. ""),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $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_matching (question_fi, shuffle, matching_type) VALUES (%s, %s, %s)",
                                        $ilDB->quote($this->id . ""),
                                        $ilDB->quote($this->shuffle . ""),
                                        $ilDB->quote($this->matching_type. "")
                                );
                                $ilDB->query($query);

                                // 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, 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($estw_time. ""),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $ilDB->quote($complete. ""),
                                $ilDB->quote($this->id. "")
                        );
                        $result = $ilDB->query($query);
                        $query = sprintf("UPDATE qpl_question_matching SET shuffle = %s, matching_type = %s WHERE question_fi = %s",
                                $ilDB->quote($this->shuffle . ""),
                                $ilDB->quote($this->matching_type. ""),
                                $ilDB->quote($this->id . "")
                        );
                        $result = $ilDB->query($query);
                }

                if ($result == DB_OK)
                {
                        // Antworten schreiben
                        // alte Antworten löschen
                        $query = sprintf("DELETE FROM qpl_answer_matching WHERE question_fi = %s",
                                $ilDB->quote($this->id)
                        );
                        $result = $ilDB->query($query);

                        // Anworten wegschreiben
                        foreach ($this->matchingpairs as $key => $value)
                        {
                                $matching_obj = $this->matchingpairs[$key];
                                $query = sprintf("INSERT INTO qpl_answer_matching (answer_id, question_fi, answertext, points, aorder, matchingtext, matching_order) VALUES (NULL, %s, %s, %s, %s, %s, %s)",
                                        $ilDB->quote($this->id),
                                        $ilDB->quote($matching_obj->getTerm() . ""),
                                        $ilDB->quote($matching_obj->getPoints() . ""),
                                        $ilDB->quote($matching_obj->getTermId() . ""),
                                        $ilDB->quote($matching_obj->getDefinition() . ""),
                                        $ilDB->quote($matching_obj->getDefinitionId() . "")
                                );
                                $matching_result = $ilDB->query($query);
                        }
                }
                parent::saveToDb($original_id);
        }

Here is the call graph for this function:

Here is the caller graph for this function:

assMatchingQuestion::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 1298 of file class.assMatchingQuestion.php.

References $_POST, $key, $query, $result, ilObjAssessmentFolder::_enabledAssessmentLogging(), ilObjAssessmentFolder::_getLogLanguage(), ilObjTest::_getPass(), checkSaveData(), assQuestion::getId(), and assQuestion::logAction().

        {
                global $ilDB;
                global $ilUser;
                
                $saveWorkingDataResult = $this->checkSaveData();
                $entered_values = 0;
                if ($saveWorkingDataResult)
                {
                        include_once ("./assessment/classes/class.ilObjTest.php");
                        $activepass = ilObjTest::_getPass($active_id);
                        
                        $query = sprintf("DELETE FROM tst_solutions WHERE active_fi = %s AND question_fi = %s AND pass = %s",
                                $ilDB->quote($active_id . ""),
                                $ilDB->quote($this->getId() . ""),
                                $ilDB->quote($activepass . "")
                        );
                        $result = $ilDB->query($query);
                        foreach ($_POST as $key => $value)
                        {
                                if (preg_match("/^sel_matching_(\d+)/", $key, $matches))
                                {
                                        if (!(preg_match("/initial_value_\d+/", $value)))
                                        {
                                                if ($value > -1) // -1 is the unselected value in the non javascript version
                                                {
                                                        $entered_values++;
                                                        $query = sprintf("INSERT INTO tst_solutions (solution_id, active_fi, question_fi, value1, value2, pass, TIMESTAMP) VALUES (NULL, %s, %s, %s, %s, %s, NULL)",
                                                                $ilDB->quote($active_id),
                                                                $ilDB->quote($this->getId()),
                                                                $ilDB->quote(trim($value)),
                                                                $ilDB->quote(trim($matches[1])),
                                                                $ilDB->quote($activepass . "")
                                                        );
                                                        $result = $ilDB->query($query);
                                                }
                                        }
                                }
                        }
                        $saveWorkingDataResult = true;
                }
                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 $saveWorkingDataResult;
        }

Here is the call graph for this function:

assMatchingQuestion::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 1219 of file class.assMatchingQuestion.php.

References $result, 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 "./content/classes/Media/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:

assMatchingQuestion::setMatchingType ( matching_type = MT_TERMS_DEFINITIONS  ) 

Sets the matching question type.

Sets the matching question type

Parameters:
integer $matching_type The question matching type public
See also:
$matching_type

Definition at line 984 of file class.assMatchingQuestion.php.

References $matching_type.

Referenced by fromXML().

        {
                $this->matching_type = $matching_type;
        }

Here is the caller graph for this function:

assMatchingQuestion::setQuestion ( question = ""  ) 

Sets the matching question text.

Sets the matching question text

Parameters:
string $question The question text public
See also:
$question

Definition at line 970 of file class.assMatchingQuestion.php.

References $question.

Referenced by fromXML().

        {
                $this->question = $question;
        }

Here is the caller graph for this function:

assMatchingQuestion::syncWithOriginal (  ) 

Reimplemented from assQuestion.

Definition at line 1379 of file class.assMatchingQuestion.php.

References $key, $query, $result, assQuestion::getEstimatedWorkingTime(), getMaximumPoints(), and isComplete().

        {
                global $ilDB;
                
                if ($this->original_id)
                {
                        $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']);
        
                        $query = sprintf("UPDATE qpl_questions SET obj_fi = %s, title = %s, comment = %s, author = %s, question_text = %s, working_time=%s, points = %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($this->question. ""),
                                $ilDB->quote($estw_time. ""),
                                $ilDB->quote($this->getMaximumPoints() . ""),
                                $ilDB->quote($complete. ""),
                                $ilDB->quote($this->original_id. "")
                        );
                        $result = $ilDB->query($query);
                        $query = sprintf("UPDATE qpl_question_matching SET shuffle = %, matching_type = %s WHERE question_fi = %s",
                                $ilDB->quote($this->shuffle . ""),
                                $ilDB->quote($this->matching_type. ""),
                                $ilDB->quote($this->original_id . "")
                        );
                        $result = $ilDB->query($query);

                        if ($result == DB_OK)
                        {
                                // write answers
                                // delete old answers
                                $query = sprintf("DELETE FROM qpl_answer_matching WHERE question_fi = %s",
                                        $ilDB->quote($this->original_id)
                                );
                                $result = $ilDB->query($query);
        
                                foreach ($this->matchingpairs as $key => $value)
                                {
                                        $matching_obj = $this->matchingpairs[$key];
                                        $query = sprintf("INSERT INTO qpl_answer_matching (answer_id, question_fi, answertext, points, aorder, matchingtext, matching_order) VALUES (NULL, %s, %s, %s, %s, %s, %s)",
                                                $ilDB->quote($this->original_id . ""),
                                                $ilDB->quote($matching_obj->getTerm() . ""),
                                                $ilDB->quote($matching_obj->getPoints() . ""),
                                                $ilDB->quote($matching_obj->getTermId() . ""),
                                                $ilDB->quote($matching_obj->getDefinition() . ""),
                                                $ilDB->quote($matching_obj->getDefinitionId() . "")
                                        );
                                        $matching_result = $ilDB->query($query);
                                }
                        }
                        parent::syncWithOriginal();
                }
        }

Here is the call graph for this function:

assMatchingQuestion::to_xml ( a_include_header = true,
a_include_binary = true,
a_shuffle = false,
test_output = false,
force_image_references = 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 364 of file class.assMatchingQuestion.php.

References $pos, assQuestion::addQTIMaterial(), get_matching_type(), assQuestion::getAuthor(), assQuestion::getComment(), assQuestion::getEstimatedWorkingTime(), assQuestion::getImagePath(), assQuestion::getImagePathWeb(), assQuestion::getOutputType(), getQuestion(), assQuestion::getShuffle(), assQuestion::getSuggestedSolution(), assQuestion::getTitle(), assQuestion::isHTML(), and assQuestion::pcArrayShuffle().

        {
                include_once("./classes/class.ilXmlWriter.php");
                $a_xml_writer = new ilXmlWriter;
                // set xml header
                $a_xml_writer->xmlHeader();
                $a_xml_writer->xmlStartTag("questestinterop");
                $attrs = array(
                        "ident" => "il_".IL_INST_ID."_qst_".$this->getId(),
                        "title" => $this->getTitle()
                );
                $a_xml_writer->xmlStartTag("item", $attrs);
                // add question description
                $a_xml_writer->xmlElement("qticomment", NULL, $this->getComment());
                // add estimated working time
                $workingtime = $this->getEstimatedWorkingTime();
                $duration = sprintf("P0Y0M0DT%dH%dM%dS", $workingtime["h"], $workingtime["m"], $workingtime["s"]);
                $a_xml_writer->xmlElement("duration", NULL, $duration);
                // add ILIAS specific metadata
                $a_xml_writer->xmlStartTag("itemmetadata");
                $a_xml_writer->xmlStartTag("qtimetadata");
                $a_xml_writer->xmlStartTag("qtimetadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "ILIAS_VERSION");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->ilias->getSetting("ilias_version"));
                $a_xml_writer->xmlEndTag("qtimetadatafield");
                $a_xml_writer->xmlStartTag("qtimetadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "QUESTIONTYPE");
                $a_xml_writer->xmlElement("fieldentry", NULL, MATCHING_QUESTION_IDENTIFIER);
                $a_xml_writer->xmlEndTag("qtimetadatafield");
                $a_xml_writer->xmlStartTag("qtimetadatafield");
                $a_xml_writer->xmlElement("fieldlabel", NULL, "AUTHOR");
                $a_xml_writer->xmlElement("fieldentry", NULL, $this->getAuthor());
                $a_xml_writer->xmlEndTag("qtimetadatafield");
                $a_xml_writer->xmlEndTag("qtimetadata");
                $a_xml_writer->xmlEndTag("itemmetadata");

                // PART I: qti presentation
                $attrs = array(
                        "label" => $this->getTitle()
                );
                $a_xml_writer->xmlStartTag("presentation", $attrs);
                // add flow to presentation
                $a_xml_writer->xmlStartTag("flow");
                // add material with question text to presentation
                $this->addQTIMaterial($a_xml_writer, $this->getQuestion());
                // add answers to presentation
                $attrs = array();
                if ($this->get_matching_type() == MT_TERMS_PICTURES)
                {
                        $attrs = array(
                                "ident" => "MQP",
                                "rcardinality" => "Multiple"
                        );
                }
                else
                {
                        $attrs = array(
                                "ident" => "MQT",
                                "rcardinality" => "Multiple"
                        );
                }
                if ($this->getOutputType() == OUTPUT_JAVASCRIPT)
                {
                        $attrs["output"] = "javascript";
                }
                $a_xml_writer->xmlStartTag("response_grp", $attrs);
                $solution = $this->getSuggestedSolution(0);
                if (count($solution))
                {
                        if (preg_match("/il_(\d*?)_(\w+)_(\d+)/", $solution["internal_link"], $matches))
                        {
                                $a_xml_writer->xmlStartTag("material");
                                $intlink = "il_" . IL_INST_ID . "_" . $matches[2] . "_" . $matches[3];
                                if (strcmp($matches[1], "") != 0)
                                {
                                        $intlink = $solution["internal_link"];
                                }
                                $attrs = array(
                                        "label" => "suggested_solution"
                                );
                                $a_xml_writer->xmlElement("mattext", $attrs, $intlink);
                                $a_xml_writer->xmlEndTag("material");
                        }
                }
                // shuffle output
                $attrs = array();
                if ($this->getShuffle())
                {
                        $attrs = array(
                                "shuffle" => "Yes"
                        );
                }
                else
                {
                        $attrs = array(
                                "shuffle" => "No"
                        );
                }
                $a_xml_writer->xmlStartTag("render_choice", $attrs);
                // add answertext
                $matchingtext_orders = array();
                foreach ($this->matchingpairs as $index => $matchingpair)
                {
                        array_push($matchingtext_orders, $matchingpair->getTermId());
                }

                // shuffle it
                $pkeys = array_keys($this->matchingpairs);
                if ($this->getshuffle() && $a_shuffle)
                {
                        $pkeys = $this->pcArrayShuffle($pkeys);
                }
                // add answers
                foreach ($pkeys as $index)
                {
                        $matchingpair = $this->matchingpairs[$index];
                        $attrs = array(
                                "ident" => $matchingpair->getDefinitionId(),
                                "match_max" => "1",
                                "match_group" => join($matchingtext_orders, ",")
                        );
                        $a_xml_writer->xmlStartTag("response_label", $attrs);
                        if ($this->get_matching_type() == MT_TERMS_PICTURES)
                        {
                                $a_xml_writer->xmlStartTag("material");
                                if ($force_image_references)
                                {
                                        $attrs = array(
                                                "imagtype" => "image/jpeg",
                                                "label" => $matchingpair->getPicture(),
                                                "uri" => $this->getImagePathWeb() . $matchingpair->getPicture()
                                        );
                                        $a_xml_writer->xmlElement("matimage", $attrs);
                                }
                                else
                                {
                                        $imagepath = $this->getImagePath() . $matchingpair->getPicture();
                                        $fh = @fopen($imagepath, "rb");
                                        if ($fh != false)
                                        {
                                                $imagefile = fread($fh, filesize($imagepath));
                                                fclose($fh);
                                                $base64 = base64_encode($imagefile);
                                                $attrs = array(
                                                        "imagtype" => "image/jpeg",
                                                        "label" => $matchingpair->getPicture(),
                                                        "embedded" => "base64"
                                                );
                                                $a_xml_writer->xmlElement("matimage", $attrs, $base64, FALSE, FALSE);
                                        }
                                }
                                $a_xml_writer->xmlEndTag("material");
                        }
                        else
                        {
                                $a_xml_writer->xmlStartTag("material");
                                $this->addQTIMaterial($a_xml_writer, $matchingpair->getDefinition(), TRUE, FALSE);
                                $a_xml_writer->xmlEndTag("material");
                        }
                        $a_xml_writer->xmlEndTag("response_label");
                }
                // shuffle again to get another order for the terms or pictures
                if ($this->getshuffle() && $a_shuffle)
                {
                        $pkeys = $this->pcArrayShuffle($pkeys);
                }
                // add matchingtext
                foreach ($pkeys as $index)
                {
                        $matchingpair = $this->matchingpairs[$index];
                        $attrs = array(
                                "ident" => $matchingpair->getTermId()
                        );
                        $a_xml_writer->xmlStartTag("response_label", $attrs);
                        $a_xml_writer->xmlStartTag("material");
                        $attrs = array(
                                "texttype" => "text/plain"
                        );
                        if ($this->isHTML($matchingpair->getTerm()))
                        {
                                $attrs["texttype"] = "text/xhtml";
                        }
                        $a_xml_writer->xmlElement("mattext", $attrs, $matchingpair->getTerm());
                        $a_xml_writer->xmlEndTag("material");
                        $a_xml_writer->xmlEndTag("response_label");
                }
                $a_xml_writer->xmlEndTag("render_choice");
                $a_xml_writer->xmlEndTag("response_grp");
                $a_xml_writer->xmlEndTag("flow");
                $a_xml_writer->xmlEndTag("presentation");

                // PART II: qti resprocessing
                $a_xml_writer->xmlStartTag("resprocessing");
                $a_xml_writer->xmlStartTag("outcomes");
                $a_xml_writer->xmlStartTag("decvar");
                $a_xml_writer->xmlEndTag("decvar");
                $a_xml_writer->xmlEndTag("outcomes");
                // add response conditions
                foreach ($this->matchingpairs as $index => $matchingpair)
                {
                        $attrs = array(
                                "continue" => "Yes"
                        );
                        $a_xml_writer->xmlStartTag("respcondition", $attrs);
                        // qti conditionvar
                        $a_xml_writer->xmlStartTag("conditionvar");
                        $attrs = array();
                        if ($this->get_matching_type() == MT_TERMS_PICTURES)
                        {
                                $attrs = array(
                                        "respident" => "MQP"
                                );
                        }
                                else
                        {
                                $attrs = array(
                                        "respident" => "MQT"
                                );
                        }
                        $a_xml_writer->xmlElement("varsubset", $attrs, $matchingpair->getTermId() . "," . $matchingpair->getDefinitionId());
                        $a_xml_writer->xmlEndTag("conditionvar");

                        // qti setvar
                        $attrs = array(
                                "action" => "Add"
                        );
                        $a_xml_writer->xmlElement("setvar", $attrs, $matchingpair->getPoints());
                        // qti displayfeedback
                        $attrs = array(
                                "feedbacktype" => "Response",
                                "linkrefid" => "correct_" . $matchingpair->getTermId() . "_" . $matchingpair->getDefinitionId()
                        );
                        $a_xml_writer->xmlElement("displayfeedback", $attrs);
                        $a_xml_writer->xmlEndTag("respcondition");
                }
                $a_xml_writer->xmlEndTag("resprocessing");

                // PART III: qti itemfeedback
                foreach ($this->matchingpairs as $index => $matchingpair)
                {
                        $attrs = array(
                                "ident" => "correct_" . $matchingpair->getTermId() . "_" . $matchingpair->getDefinitionId(),
                                "view" => "All"
                        );
                        $a_xml_writer->xmlStartTag("itemfeedback", $attrs);
                        // qti flow_mat
                        $a_xml_writer->xmlStartTag("flow_mat");
                        $a_xml_writer->xmlStartTag("material");
                        $a_xml_writer->xmlElement("mattext");
                        $a_xml_writer->xmlEndTag("material");
                        $a_xml_writer->xmlEndTag("flow_mat");
                        $a_xml_writer->xmlEndTag("itemfeedback");
                }
                $a_xml_writer->xmlEndTag("item");
                $a_xml_writer->xmlEndTag("questestinterop");

                $xml = $a_xml_writer->xmlDumpMem(FALSE);
                if (!$a_include_header)
                {
                        $pos = strpos($xml, "?>");
                        $xml = substr($xml, $pos + 2);
                }
                return $xml;
        }

Here is the call graph for this function:


Field Documentation

assMatchingQuestion::$matching_type

Definition at line 65 of file class.assMatchingQuestion.php.

Referenced by assMatchingQuestion(), and setMatchingType().

assMatchingQuestion::$matchingpairs

Definition at line 55 of file class.assMatchingQuestion.php.

assMatchingQuestion::$question

Definition at line 46 of file class.assMatchingQuestion.php.

Referenced by assMatchingQuestion(), and setQuestion().


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