class.assNumericGUI.php

Go to the documentation of this file.

<?php
 /*
   +----------------------------------------------------------------------------+
   | ILIAS open source                                                          |
   +----------------------------------------------------------------------------+
   | Copyright (c) 1998-2001 ILIAS open source, University of Cologne           |
   |                                                                            |
   | This program is free software; you can redistribute it and/or              |
   | modify it under the terms of the GNU General Public License                |
   | as published by the Free Software Foundation; either version 2             |
   | of the License, or (at your option) any later version.                     |
   |                                                                            |
   | This program is distributed in the hope that it will be useful,            |
   | but WITHOUT ANY WARRANTY; without even the implied warranty of             |
   | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the              |
   | GNU General Public License for more details.                               |
   |                                                                            |
   | You should have received a copy of the GNU General Public License          |
   | along with this program; if not, write to the Free Software                |
   | Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
   +----------------------------------------------------------------------------+
*/

include_once "./Modules/TestQuestionPool/classes/class.assQuestionGUI.php";
include_once "./Modules/Test/classes/inc.AssessmentConstants.php";

class assNumericGUI extends assQuestionGUI
{
        function __construct($id = -1)
        {
                parent::__construct();
                include_once "./Modules/TestQuestionPool/classes/class.assNumeric.php";
                $this->object = new assNumeric();
                if ($id >= 0)
                {
                        $this->object->loadFromDb($id);
                }
        }

        function getCommand($cmd)
        {
                if (substr($cmd, 0, 6) == "delete")
                {
                        $cmd = "delete";
                }

                return $cmd;
        }

        function writePostData($always = false)
        {
                $hasErrors = (!$always) ? $this->editQuestion(true) : false;
                if (!$hasErrors)
                {
                        $this->object->setTitle($_POST["title"]);
                        $this->object->setAuthor($_POST["author"]);
                        $this->object->setComment($_POST["comment"]);
                        include_once "./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php";
                        $questiontext = $_POST["question"];
                        $this->object->setQuestion($questiontext);
                        $this->object->setMaxChars($_POST["maxchars"]);
                        $this->object->setEstimatedWorkingTime(
                                $_POST["Estimated"]["hh"],
                                $_POST["Estimated"]["mm"],
                                $_POST["Estimated"]["ss"]
                        );
                        $this->object->setLowerLimit($_POST['lowerlimit']);
                        $this->object->setUpperLimit($_POST['upperlimit']);
                        $this->object->setPoints($_POST['points']);
                        return 0;
                }
                else
                {
                        return 1;
                }
        }

        public function editQuestion($checkonly = FALSE)
        {
                $save = ((strcmp($this->ctrl->getCmd(), "save") == 0) || (strcmp($this->ctrl->getCmd(), "saveEdit") == 0)) ? TRUE : FALSE;
                $this->getQuestionTemplate();

                include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
                $form = new ilPropertyFormGUI();
                $form->setFormAction($this->ctrl->getFormAction($this));
                $form->setTitle($this->outQuestionType());
                $form->setMultipart(TRUE);
                $form->setTableWidth("100%");
                $form->setId("assnumeric");

                $this->addBasicQuestionFormProperties($form);

                // maxchars
                $maxchars = new ilNumberInputGUI($this->lng->txt("maxchars"), "maxchars");
                $maxchars->setSize(10);
                $maxchars->setDecimals(0);
                $maxchars->setMinValue(1);
                $maxchars->setRequired(true);
                if ($this->object->getMaxChars() > 0) $maxchars->setValue($this->object->getMaxChars());
                $form->addItem($maxchars);

                // points
                $points = new ilNumberInputGUI($this->lng->txt("points"), "points");
                $points->setValue($this->object->getPoints() > 0 ? $this->object->getPoints() : '');
                $points->setRequired(TRUE);
                $points->setSize(3);
                $points->setMinValue(0.0);
                $points->setMinvalueShouldBeGreater(true);
                $form->addItem($points);

                $header = new ilFormSectionHeaderGUI();
                $header->setTitle($this->lng->txt("range"));
                $form->addItem($header);
                
                // lower bound
                $lower_limit = new ilFormulaInputGUI($this->lng->txt("range_lower_limit"), "lowerlimit");
                $lower_limit->setSize(25);
                $lower_limit->setMaxLength(20);
                $lower_limit->setRequired(true);
                $lower_limit->setValue($this->object->getLowerLimit());
                $form->addItem($lower_limit);

                // upper bound
                $upper_limit = new ilFormulaInputGUI($this->lng->txt("range_upper_limit"), "upperlimit");
                $upper_limit->setSize(25);
                $upper_limit->setMaxLength(20);
                $upper_limit->setRequired(true);
                $upper_limit->setValue($this->object->getUpperLimit());
                $form->addItem($upper_limit);

                $this->addQuestionFormCommandButtons($form);

                $errors = false;
        
                if ($save)
                {
                        $form->setValuesByPost();
                        $errors = !$form->checkInput();
                        $form->setValuesByPost(); // again, because checkInput now performs the whole stripSlashes handling and we need this if we don't want to have duplication of backslashes
                        if ($errors) $checkonly = false;
                }

                if (!$checkonly) $this->tpl->setVariable("QUESTION_DATA", $form->getHTML());
                return $errors;
        }

        function checkRange()
        {
                include_once "./Services/Math/classes/class.EvalMath.php";
                $eval = new EvalMath();
                $eval->suppress_errors = TRUE;
                if (($eval->e($_POST["rang_lower_limit"]) !== FALSE) AND ($eval->e($_POST ["range_upper_limit"]) !== FALSE))
                {
                        if ($eval->e($_POST["rang_lower_limit"]) < $eval->e($_POST["range_upper_limit"]))
                        {
                                return TRUE;
                        }
                        else 
                        {
                                return FALSE;
                        }
                }
                else 
                {
                        return FALSE;
                }
        }

        function outQuestionForTest($formaction, $active_id, $pass = NULL, $is_postponed = FALSE, $use_post_solutions = FALSE)
        {
                $test_output = $this->getTestOutput($active_id, $pass, $is_postponed, $use_post_solutions); 
                $this->tpl->setVariable("QUESTION_OUTPUT", $test_output);
                $this->tpl->setVariable("FORMACTION", $formaction);
        }

        function getSolutionOutput(
                $active_id,
                $pass = NULL,
                $graphicalOutput = FALSE,
                $result_output = FALSE,
                $show_question_only = TRUE,
                $show_feedback = FALSE,
                $show_correct_solution = FALSE,
                $show_manual_scoring = FALSE
        )
        {
                // get the solution of the user for the active pass or from the last pass if allowed
                $solutions = array();
                if (($active_id > 0) && (!$show_correct_solution))
                {
                        $solutions =& $this->object->getSolutionValues($active_id, $pass);
                }
                else
                {
                        array_push($solutions, array("value1" => sprintf($this->lng->txt("value_between_x_and_y"), $this->object->getLowerLimit(), $this->object->getUpperLimit())));
                }
                
                // generate the question output
                include_once "./classes/class.ilTemplate.php";
                $template = new ilTemplate("tpl.il_as_qpl_numeric_output_solution.html", TRUE, TRUE, "Modules/TestQuestionPool");
                $solutiontemplate = new ilTemplate("tpl.il_as_tst_solution_output.html",TRUE, TRUE, "Modules/TestQuestionPool");
                if (is_array($solutions))
                {
                        if (($active_id > 0) && (!$show_correct_solution))
                        {
                                if ($graphicalOutput)
                                {
                                        // output of ok/not ok icons for user entered solutions
                                        if ($this->object->getReachedPoints($active_id, $pass) == $this->object->getMaximumPoints())
                                        {
                                                $template->setCurrentBlock("icon_ok");
                                                $template->setVariable("ICON_OK", ilUtil::getImagePath("icon_ok.gif"));
                                                $template->setVariable("TEXT_OK", $this->lng->txt("answer_is_right"));
                                                $template->parseCurrentBlock();
                                        }
                                        else
                                        {
                                                $template->setCurrentBlock("icon_ok");
                                                $template->setVariable("ICON_NOT_OK", ilUtil::getImagePath("icon_not_ok.gif"));
                                                $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_wrong"));
                                                $template->parseCurrentBlock();
                                        }
                                }
                        }
                        foreach ($solutions as $solution)
                        {
                                $template->setVariable("NUMERIC_VALUE", $solution["value1"]);
                        }
                        if (count($solutions) == 0)
                        {
                                $template->setVariable("NUMERIC_VALUE", "&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;");
                        }
                }
                $template->setVariable("NUMERIC_SIZE", $this->object->getMaxChars());
                $questiontext = $this->object->getQuestion();
                $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
                $questionoutput = $template->get();
                $feedback = ($show_feedback) ? $this->getAnswerFeedbackOutput($active_id, $pass) : "";
                if (strlen($feedback)) $solutiontemplate->setVariable("FEEDBACK", $feedback);
                $solutiontemplate->setVariable("SOLUTION_OUTPUT", $questionoutput);

                $solutionoutput = $solutiontemplate->get(); 
                if (!$show_question_only)
                {
                        // get page object output
                        $solutionoutput = $this->getILIASPage($solutionoutput);
                }
                return $solutionoutput;
        }
        
        function getPreview($show_question_only = FALSE)
        {
                // generate the question output
                include_once "./classes/class.ilTemplate.php";
                $template = new ilTemplate("tpl.il_as_qpl_numeric_output.html", TRUE, TRUE, "Modules/TestQuestionPool");
                $template->setVariable("NUMERIC_SIZE", $this->object->getMaxChars());
                $questiontext = $this->object->getQuestion();
                $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
                $questionoutput = $template->get();
                if (!$show_question_only)
                {
                        // get page object output
                        $questionoutput = $this->getILIASPage($questionoutput);
                }
                return $questionoutput;
        }
        
        function getTestOutput($active_id, $pass = NULL, $is_postponed = FALSE, $use_post_solutions = FALSE)
        {
                // get the solution of the user for the active pass or from the last pass if allowed
                if ($active_id)
                {
                        $solutions = NULL;
                        include_once "./Modules/Test/classes/class.ilObjTest.php";
                        if (!ilObjTest::_getUsePreviousAnswers($active_id, true))
                        {
                                if (is_null($pass)) $pass = ilObjTest::_getPass($active_id);
                        }
                        $solutions =& $this->object->getSolutionValues($active_id, $pass);
                }
                
                // generate the question output
                include_once "./classes/class.ilTemplate.php";
                $template = new ilTemplate("tpl.il_as_qpl_numeric_output.html", TRUE, TRUE, "Modules/TestQuestionPool");
                if (is_array($solutions))
                {
                        foreach ($solutions as $solution)
                        {
                                $template->setVariable("NUMERIC_VALUE", " value=\"".$solution["value1"]."\"");
                        }
                }
                $template->setVariable("NUMERIC_SIZE", $this->object->getMaxChars());
                $questiontext = $this->object->getQuestion();
                $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
                $questionoutput = $template->get();
                $pageoutput = $this->outQuestionPage("", $is_postponed, $active_id, $questionoutput);
                return $pageoutput;
        }
        
        function saveFeedback()
        {
                include_once "./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php";
                $errors = $this->feedback(true);
                $this->object->saveFeedbackGeneric(0, $_POST["feedback_incomplete"]);
                $this->object->saveFeedbackGeneric(1, $_POST["feedback_complete"]);
                $this->object->cleanupMediaObjectUsage();
                parent::saveFeedback();
        }

        function setQuestionTabs()
        {
                global $rbacsystem, $ilTabs;
                
                $this->ctrl->setParameterByClass("ilpageobjectgui", "q_id", $_GET["q_id"]);
                include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
                $q_type = $this->object->getQuestionType();

                if (strlen($q_type))
                {
                        $classname = $q_type . "GUI";
                        $this->ctrl->setParameterByClass(strtolower($classname), "sel_question_types", $q_type);
                        $this->ctrl->setParameterByClass(strtolower($classname), "q_id", $_GET["q_id"]);
                }

                if ($_GET["q_id"])
                {
                        if ($rbacsystem->checkAccess('write', $_GET["ref_id"]))
                        {
                                // edit page
                                $ilTabs->addTarget("edit_content",
                                        $this->ctrl->getLinkTargetByClass("ilPageObjectGUI", "edit"),
                                        array("edit", "insert", "exec_pg"),
                                        "", "", $force_active);
                        }
        
                        // edit page
                        $ilTabs->addTarget("preview",
                                $this->ctrl->getLinkTargetByClass("ilPageObjectGUI", "preview"),
                                array("preview"),
                                "ilPageObjectGUI", "", $force_active);
                }

                $force_active = false;
                if ($rbacsystem->checkAccess('write', $_GET["ref_id"]))
                {
                        $url = "";
                        if ($classname) $url = $this->ctrl->getLinkTargetByClass($classname, "editQuestion");
                        // edit question properties
                        $ilTabs->addTarget("edit_properties",
                                $url,
                                array("editQuestion", "save", "cancel", "saveEdit", "originalSyncForm"),
                                $classname, "", $force_active);
                }

                if ($_GET["q_id"])
                {
                        $ilTabs->addTarget("feedback",
                                $this->ctrl->getLinkTargetByClass($classname, "feedback"),
                                array("feedback", "saveFeedback"),
                                $classname, "");
                }
                
                if ($_GET["q_id"])
                {
                        $ilTabs->addTarget("solution_hint",
                                $this->ctrl->getLinkTargetByClass($classname, "suggestedsolution"),
                                array("suggestedsolution", "saveSuggestedSolution", "outSolutionExplorer", "cancel", 
                                "addSuggestedSolution","cancelExplorer", "linkChilds", "removeSuggestedSolution"
                                ),
                                $classname, 
                                ""
                        );
                }

                // Assessment of questions sub menu entry
                if ($_GET["q_id"])
                {
                        $ilTabs->addTarget("statistics",
                                $this->ctrl->getLinkTargetByClass($classname, "assessment"),
                                array("assessment"),
                                $classname, "");
                }
                
                if (($_GET["calling_test"] > 0) || ($_GET["test_ref_id"] > 0))
                {
                        $ref_id = $_GET["calling_test"];
                        if (strlen($ref_id) == 0) $ref_id = $_GET["test_ref_id"];
                        $ilTabs->setBackTarget($this->lng->txt("backtocallingtest"), "ilias.php?baseClass=ilObjTestGUI&cmd=questions&ref_id=$ref_id");
                }
                else
                {
                        $ilTabs->setBackTarget($this->lng->txt("qpl"), $this->ctrl->getLinkTargetByClass("ilobjquestionpoolgui", "questions"));
                }
        }
}
?>