assessment/classes/class.assQuestionTypeTemplateGUI.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 "./assessment/classes/class.assQuestionGUI.php";
include_once "./assessment/classes/inc.AssessmentConstants.php";

class assQuestionTypeTemplateGUI extends assQuestionGUI
{
        function assQuestionTypeTemplateGUI(
                        $id = -1
        )
        {
                $this->assQuestionGUI();

                // instanciate the question type class, save it in the object attribute
                // and load the question type data from the database
                include_once "./assessment/classes/class.assQuestionTypeTemplate.php";
                $this->object = new assQuestionTypeTemplate();
                if ($id >= 0)
                {
                        $this->object->loadFromDb($id);
                }
        }

        function getCommand($cmd)
        {
                // do something here if you want to change certain commands
                return $cmd;
        }


        function getQuestionType()
        {
                return "assQuestionTypeTemplate";
        }

        function editQuestion()
        {
                // this method creates the output of the property edit form for your question
                // where the author adds all necessary information
                // Please have a look at one of the existing question GUI classes how to create a working output

                // 1. Load the template file of your question type (you have to create one)
                // The last parameter TRUE forces ILIAS to load the template from the assessment/templates/default directory
                $this->tpl->addBlockFile("QUESTION_DATA", "question_data", "tpl.il_as_qpl_mytype.html", TRUE);

                // 2. Do some output stuff
                
                // fill the form
                // use the language variables
                // enter the form action
                // ...
        }

        function mycommandObject()
        {
                // this method handles the cmd[mycommand] POST command in the edit form
        }
        
        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)
        {
                // Please have a look at the existing question types how to create a solution output for a question
                // you should use your own template for the output
                return $questionoutput;
        }
        
        function getPreview()
        {
                // Please have a look at the existing question types how to create a preview output for a question
                // you should use your own template for the output
        }

        function getTestOutput($active_id, $pass = NULL, $is_postponed = FALSE, $use_post_solutions = FALSE)
        {
                // Please have a look at the existing question types how to create an output for a question
                // you should use your own template for the output
        }

        function addSuggestedSolution()
        {
                // this method is inherited from assQuestionGUI
                
                // overwrite it here and define your own code which adds a suggested solution to the question
                // the following code is example code and you have to exchange it with your own code:
                $_SESSION["subquestion_index"] = 0;
                if ($_POST["cmd"]["addSuggestedSolution"])
                {
                        if ($this->writePostData())
                        {
                                sendInfo($this->getErrorMessage());
                                $this->editQuestion();
                                return;
                        }
                        if (!$this->checkInput())
                        {
                                sendInfo($this->lng->txt("fill_out_all_required_fields_add_answer"));
                                $this->editQuestion();
                                return;
                        }
                }
                $this->object->saveToDb();
                $_GET["q_id"] = $this->object->getId();
                $this->tpl->setVariable("HEADER", $this->object->getTitle());
                $this->getQuestionTemplate();
                parent::addSuggestedSolution();
        }
}
?>