SurveySingleChoiceQuestionGUI Class Reference

SingleChoice survey question GUI representation. More...

Inheritance diagram for SurveySingleChoiceQuestionGUI:

Collaboration diagram for SurveySingleChoiceQuestionGUI:

Public Member Functions
	SurveySingleChoiceQuestionGUI ($id=-1)
	SurveySingleChoiceQuestionGUI constructor.
	writePostData ($always=false)
	Evaluates a posted edit form and writes the form data in the question object.
	editQuestion ($checkonly=FALSE)
	Creates an output of the edit form for the question.
	addanswers ()
	Add a new answer.
	removeanswers ()
	Remove an answer.
	upanswers ()
	Move an answer up.
	downanswers ()
	Move an answer down.
	wizardanswers ($save_post_data=true)
	Creates an output for the addition of phrases.
	cancelViewPhrase ()
	Cancels the form adding a phrase.
	addSelectedPhrase ()
	Adds a selected phrase.
	addStandardNumbers ()
	Creates an output for the addition of standard numbers.
	cancelStandardNumbers ()
	Cancels the form adding standard numbers.
	insertStandardNumbers ()
	Insert standard numbers to the question.
	savePhraseanswers ($haserror=false)
	Creates an output to save the current answers as a phrase.
	cancelSavePhrase ()
	Cancels the form saving a phrase.
	confirmSavePhrase ()
	Save a new phrase to the database.
	getWorkingForm ($working_data="", $question_title=1, $show_questiontext=1, $error_message="", $survey_id=null)
	Creates the question output form for the learner.
	getPrintView ($question_title=1, $show_questiontext=1, $survey_id=null)
	Creates a HTML representation of the question.
	preview ()
	Creates a preview of the question.
	setQuestionTabs ()
	getCumulatedResultsDetails ($survey_id, $counter)
	Creates the detailed output of the cumulated results for the question.
Public Member Functions inherited from SurveyQuestionGUI
	SurveyQuestionGUI ()
	SurveyQuestion constructor.
	addErrorMessage ($errormessage)
	outErrorMessages ()
&	executeCommand ()
	execute command
	getCommand ($cmd)
	_getGUIClassNameForId ($a_q_id)
	_getClassNameForQType ($q_type)
	originalSyncForm ()
	sync ()
	cancelSync ()
	save ()
	save question
	cancel ()
	cancelDeleteCategory ()
	Cancels the form adding a phrase.
	material ($checkonly=FALSE)
	Material tab of the survey questions.
	deleteMaterial ()
	addMaterial ()
	Add materials to a question.
	removeMaterial ()
	cancelExplorer ()
	addPG ()
	addST ()
	addGIT ()
	linkChilds ()
	getPrintView ($question_title=1, $show_questiontext=1)
	Creates a HTML representation of the question.
	setQuestionTabsForClass ($guiclass)
	getQuestionType ()
	Returns the question type string.
	getCumulatedResultRow ($counter, $css_class, $survey_id)
	Creates a the cumulated results row for the question.
	editQuestion ()

Additional Inherited Members
Static Public Member Functions inherited from SurveyQuestionGUI
static &	_getQuestionGUI ($questiontype, $question_id=-1)
	Creates a question gui representation.
Data Fields inherited from SurveyQuestionGUI
	$object
	$tpl
	$lng
	$cumulated
	An array containing the cumulated results of the question for a given survey.
Protected Member Functions inherited from SurveyQuestionGUI
	getMaterialOutput ()
	Creates the HTML output of the question material(s)

Detailed Description

SingleChoice survey question GUI representation.

The SurveySingleChoiceQuestionGUI class encapsulates the GUI representation for single choice survey question types.

Author

Helmut Schottmüller helmu.nosp@m.t.sc.nosp@m.hottm.nosp@m.uell.nosp@m.er@ma.nosp@m.c.co.nosp@m.m

Version

Id:

class.SurveySingleChoiceQuestionGUI.php 25757 2010-09-23 21:54:50Z hschottm

Definition at line 38 of file class.SurveySingleChoiceQuestionGUI.php.

Member Function Documentation

SurveySingleChoiceQuestionGUI::addanswers

(

)

Add a new answer.

Definition at line 200 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, SurveyQuestionGUI\editQuestion(), and writePostData().

        {
                $this->writePostData(true);
                $position = key($_POST['cmd']['addanswers']);
                $this->object->getCategories()->addCategoryAtPosition("", $position+1);
                $this->editQuestion();
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::addSelectedPhrase

(

)

Adds a selected phrase.

public

Definition at line 302 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, addStandardNumbers(), ilUtil\sendInfo(), ilUtil\sendSuccess(), and wizardanswers().

        {
                if (strcmp($_POST["phrases"], "") == 0)
                {
                        ilUtil::sendInfo($this->lng->txt("select_phrase_to_add"));
                        $this->wizardanswers(false);
                }
                else
                {
                        if (strcmp($this->object->getPhrase($_POST["phrases"]), "dp_standard_numbers") != 0)
                        {
                                $this->object->addPhrase($_POST["phrases"]);
                                $this->object->saveToDb();
                        }
                        else
                        {
                                $this->addStandardNumbers();
                                return;
                        }
                        ilUtil::sendSuccess($this->lng->txt('phrase_added'), true);
                        $this->ctrl->redirect($this, 'editQuestion');
                }
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::addStandardNumbers

(

)

Creates an output for the addition of standard numbers.

public

Definition at line 331 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST.

Referenced by addSelectedPhrase(), and insertStandardNumbers().

                {
                        $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_svy_qpl_addphrase_standard_numbers.html", "Modules/SurveyQuestionPool");

                        // set the id to return to the selected question
                        $this->tpl->setCurrentBlock("hidden");
                        $this->tpl->setVariable("HIDDEN_NAME", "id");
                        $this->tpl->setVariable("HIDDEN_VALUE", $this->object->getId());
                        $this->tpl->parseCurrentBlock();

                        $this->tpl->setCurrentBlock("adm_content");
                        $this->tpl->setVariable("ADD_STANDARD_NUMBERS", $this->lng->txt("add_standard_numbers"));
                        $this->tpl->setVariable("TEXT_ADD_LIMITS", $this->lng->txt("add_limits_for_standard_numbers"));
                        $this->tpl->setVariable("TEXT_LOWER_LIMIT",$this->lng->txt("lower_limit"));
                        $this->tpl->setVariable("TEXT_UPPER_LIMIT",$this->lng->txt("upper_limit"));
                        $this->tpl->setVariable("VALUE_LOWER_LIMIT", $_POST["lower_limit"]);
                        $this->tpl->setVariable("VALUE_UPPER_LIMIT", $_POST["upper_limit"]);
                        $this->tpl->setVariable("BTN_ADD",$this->lng->txt("add_phrase"));
                        $this->tpl->setVariable("BTN_CANCEL",$this->lng->txt("cancel"));
                        $this->tpl->setVariable("FORM_ACTION", $this->ctrl->getFormAction($this));
                        $this->tpl->parseCurrentBlock();
                }

Here is the caller graph for this function:

SurveySingleChoiceQuestionGUI::cancelSavePhrase

(

)

Cancels the form saving a phrase.

public

Definition at line 444 of file class.SurveySingleChoiceQuestionGUI.php.

References ilUtil\sendInfo().

        {
                ilUtil::sendInfo($this->lng->txt("msg_cancel"), true);
                $this->ctrl->redirect($this, "editQuestion");
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::cancelStandardNumbers

(

)

Cancels the form adding standard numbers.

public

Definition at line 359 of file class.SurveySingleChoiceQuestionGUI.php.

References ilUtil\sendInfo().

        {
                ilUtil::sendInfo($this->lng->txt("msg_cancel"), true);
                $this->ctrl->redirect($this, "editQuestion");
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::cancelViewPhrase

(

)

Cancels the form adding a phrase.

public

Definition at line 291 of file class.SurveySingleChoiceQuestionGUI.php.

References ilUtil\sendInfo().

        {
                ilUtil::sendInfo($this->lng->txt('msg_cancel'), true);
                $this->ctrl->redirect($this, 'editQuestion');
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::confirmSavePhrase

(

)

Save a new phrase to the database.

public

Definition at line 455 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, savePhraseanswers(), ilUtil\sendInfo(), and ilUtil\sendSuccess().

        {
                if (!$_POST["phrase_title"])
                {
                        ilUtil::sendInfo($this->lng->txt("qpl_savephrase_empty"));
                        $this->savePhraseanswers(true);
                        return;
                }

                if ($this->object->phraseExists($_POST["phrase_title"]))
                {
                        ilUtil::sendInfo($this->lng->txt("qpl_savephrase_exists"));
                        $this->savePhraseanswers(true);
                        return;
                }

                $this->object->savePhrase($_POST['answers']['answer'], $_POST["phrase_title"]);
                ilUtil::sendSuccess($this->lng->txt("phrase_saved"), true);
                $this->ctrl->redirect($this, "editQuestion");
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::downanswers

(

)

Move an answer down.

Definition at line 233 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, SurveyQuestionGUI\editQuestion(), and writePostData().

        {
                $this->writePostData(true);
                $position = key($_POST['cmd']['downanswers']);
                $this->object->getCategories()->moveCategoryDown($position);
                $this->editQuestion();
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::editQuestion

(

$checkonly = FALSE

)

Creates an output of the edit form for the question.

public

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

References $errors, $title, ilObjAdvancedEditing\_getUsedHTMLTags(), ilFormPropertyGUI\setRequired(), ilTextInputGUI\setValue(), ilCheckboxInputGUI\setValue(), and ilTextAreaInputGUI\setValue().

        {
                $save = ((strcmp($this->ctrl->getCmd(), "save") == 0) || 
                        (strcmp($this->ctrl->getCmd(), "wizardanswers") == 0) ||
                        (strcmp($this->ctrl->getCmd(), "savePhraseanswers") == 0)
                ) ? TRUE : FALSE;

                include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
                $form = new ilPropertyFormGUI();
                $form->setFormAction($this->ctrl->getFormAction($this));
                $form->setTitle($this->lng->txt($this->getQuestionType()));
                $form->setMultipart(FALSE);
                $form->setTableWidth("100%");
                $form->setId("singlechoice");

                // title
                $title = new ilTextInputGUI($this->lng->txt("title"), "title");
                $title->setValue($this->object->getTitle());
                $title->setRequired(TRUE);
                $form->addItem($title);
                
                // author
                $author = new ilTextInputGUI($this->lng->txt("author"), "author");
                $author->setValue($this->object->getAuthor());
                $author->setRequired(TRUE);
                $form->addItem($author);
                
                // description
                $description = new ilTextInputGUI($this->lng->txt("description"), "description");
                $description->setValue($this->object->getDescription());
                $description->setRequired(FALSE);
                $form->addItem($description);

                // questiontext
                $question = new ilTextAreaInputGUI($this->lng->txt("question"), "question");
                $question->setValue($this->object->prepareTextareaOutput($this->object->getQuestiontext()));
                $question->setRequired(TRUE);
                $question->setRows(10);
                $question->setCols(80);
                $question->setUseRte(TRUE);
                include_once "./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php";
                $question->setRteTags(ilObjAdvancedEditing::_getUsedHTMLTags("survey"));
                $question->addPlugin("latex");
                $question->addButton("latex");
                $question->addButton("pastelatex");
                $question->removePlugin("ibrowser");
                $question->setRTESupport($this->object->getId(), "spl", "survey");
                $form->addItem($question);
                
                // obligatory
                $shuffle = new ilCheckboxInputGUI($this->lng->txt("obligatory"), "obligatory");
                $shuffle->setValue(1);
                $shuffle->setChecked($this->object->getObligatory());
                $shuffle->setRequired(FALSE);
                $form->addItem($shuffle);

                // orientation
                $orientation = new ilRadioGroupInputGUI($this->lng->txt("orientation"), "orientation");
                $orientation->setRequired(false);
                $orientation->setValue($this->object->getOrientation());
                $orientation->addOption(new ilRadioOption($this->lng->txt('vertical'), 0));
                $orientation->addOption(new ilRadioOption($this->lng->txt('horizontal'), 1));
                $orientation->addOption(new ilRadioOption($this->lng->txt('combobox'), 2));
                $form->addItem($orientation);

                // Answers
                include_once "./Modules/SurveyQuestionPool/classes/class.ilCategoryWizardInputGUI.php";
                $answers = new ilCategoryWizardInputGUI($this->lng->txt("answers"), "answers");
                $answers->setRequired(false);
                $answers->setAllowMove(true);
                $answers->setShowWizard(true);
                $answers->setShowSavePhrase(true);
                if (!$this->object->getCategories()->getCategoryCount())
                {
                        $this->object->getCategories()->addCategory("");
                }
                $answers->setValues($this->object->getCategories());
                $form->addItem($answers);

                $form->addCommandButton("save", $this->lng->txt("save"));

                $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("ADM_CONTENT", $form->getHTML());
                return $errors;
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::getCumulatedResultsDetails	(		$survey_id,
			$counter
	)

Creates the detailed output of the cumulated results for the question.

Parameters

integer	$survey_id	The database ID of the survey
integer	$counter	The counter of the question position in the survey

Returns

string HTML text with the cumulated results private

Definition at line 760 of file class.SurveySingleChoiceQuestionGUI.php.

References $data, $key, and ilObjSurvey\_getNrOfParticipants().

        {
                if (count($this->cumulated) == 0)
                {
                        include_once "./Modules/Survey/classes/class.ilObjSurvey.php";
                        $nr_of_users = ilObjSurvey::_getNrOfParticipants($survey_id);
                        $this->cumulated =& $this->object->getCumulatedResults($survey_id, $nr_of_users);
                }
                $output = "";
                include_once "./classes/class.ilTemplate.php";
                $template = new ilTemplate("tpl.il_svy_svy_cumulated_results_detail.html", TRUE, TRUE, "Modules/Survey");

                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("question"));
                $questiontext = $this->object->getQuestiontext();
                $template->setVariable("TEXT_OPTION_VALUE", $this->object->prepareTextareaOutput($questiontext, TRUE));
                $template->parseCurrentBlock();
                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("question_type"));
                $template->setVariable("TEXT_OPTION_VALUE", $this->lng->txt($this->getQuestionType()));
                $template->parseCurrentBlock();
                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("users_answered"));
                $template->setVariable("TEXT_OPTION_VALUE", $this->cumulated["USERS_ANSWERED"]);
                $template->parseCurrentBlock();
                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("users_skipped"));
                $template->setVariable("TEXT_OPTION_VALUE", $this->cumulated["USERS_SKIPPED"]);
                $template->parseCurrentBlock();
                
                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("mode"));
                $template->setVariable("TEXT_OPTION_VALUE", $this->cumulated["MODE"]);
                $template->parseCurrentBlock();
                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("mode_nr_of_selections"));
                $template->setVariable("TEXT_OPTION_VALUE", $this->cumulated["MODE_NR_OF_SELECTIONS"]);
                $template->parseCurrentBlock();
                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("median"));
                $template->setVariable("TEXT_OPTION_VALUE", $this->cumulated["MEDIAN"]);
                $template->parseCurrentBlock();
                
                $template->setCurrentBlock("detail_row");
                $template->setVariable("TEXT_OPTION", $this->lng->txt("categories"));
                $categories = "";
                foreach ($this->cumulated["variables"] as $key => $value)
                {
                        $categories .= "<li>" . $this->lng->txt("title") . ":" . "<span class=\"bold\">" . $value["title"] . "</span><br />" .
                                $this->lng->txt("category_nr_selected") . ": " . "<span class=\"bold\">" . $value["selected"] . "</span><br />" .
                                $this->lng->txt("percentage_of_selections") . ": " . "<span class=\"bold\">" . sprintf("%.2f", 100*$value["percentage"]) . "</span></li>";
                }
                $categories = "<ol>$categories</ol>";
                $template->setVariable("TEXT_OPTION_VALUE", $categories);
                $template->parseCurrentBlock();
                
                // display chart for single choice question for array $eval["variables"]
                $template->setCurrentBlock("chart");
                $template->setVariable("TEXT_CHART", $this->lng->txt("chart"));
                $template->setVariable("ALT_CHART", $data["title"] . "( " . $this->lng->txt("chart") . ")");
                $charturl = "";
                include_once "./Services/Administration/classes/class.ilSetting.php";
                $surveySetting = new ilSetting("survey");
                if ($surveySetting->get("googlechart") == 1)
                {
                        $chartcolors = array("2A4BD7", "9DAFFF", "1D6914", "81C57A", "814A19", "E9DEBB", "8126C0", "AD2323", "29D0D0", "FFEE33", "FF9233", "FFCDF3", "A0A0A0", "575757", "000000");
                        $selections = array();
                        $values = array();
                        $maxselection = 0;
                        $char = 65;
                        foreach ($this->cumulated["variables"] as $val)
                        {
                                if ($val["selected"] > $maxselection) $maxselection = $val["selected"];
                                array_push($selections, $val["selected"]);
                                array_push($values, str_replace(" ", "+", $val["title"]));
                        }
                        $chartwidth = 800;
                        if ($maxselection % 2 == 0)
                        {
                                $selectionlabels = "0|" . ($maxselection / 2) . "|$maxselection";
                        }
                        else
                        {
                                $selectionlabels = "0|$maxselection";
                        }
                        $charturl = "http://chart.apis.google.com/chart?chco=" . implode("|", array_slice($chartcolors, 0, count($values))). "&cht=bvs&chs=" . $chartwidth . "x250&chd=t:" . implode(",", $selections) . "&chds=0,$maxselection&chxt=y,y&chxl=0:|".$selectionlabels."|1:||".str_replace(" ", "+", $this->lng->txt("mode_nr_of_selections"))."|" . "&chxr=1,0,$maxselection&chtt=" . str_replace(" ", "+", $this->object->getTitle()) . "&chbh=20," . (round($chartwidth/count($values))-25) . "&chdl=" . implode("|", $values) . "&chdlp=b";
                }
                else
                {
                        $this->ctrl->setParameterByClass("ilsurveyevaluationgui", "survey", $survey_id);
                        $this->ctrl->setParameterByClass("ilsurveyevaluationgui", "question", $this->object->getId());
                        $charturl = $this->ctrl->getLinkTargetByClass("ilsurveyevaluationgui", "outChart");
                }
                $template->setVariable("CHART", $charturl);
                $template->parseCurrentBlock();
                
                $template->setVariable("QUESTION_TITLE", "$counter. ".$this->object->getTitle());
                return $template->get();
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::getPrintView	(		$question_title = 1,
			$show_questiontext = 1,
			$survey_id = null
	)

Creates a HTML representation of the question.

private

Definition at line 596 of file class.SurveySingleChoiceQuestionGUI.php.

References ilUtil\getHtmlPath(), ilUtil\getImagePath(), and ilUtil\prepareFormOutput().

        {
                $template = new ilTemplate("tpl.il_svy_qpl_sc_printview.html", TRUE, TRUE, "Modules/SurveyQuestionPool");
                switch ($this->object->orientation)
                {
                        case 0:
                                // vertical orientation
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("row");
                                        $template->setVariable("IMAGE_RADIO", ilUtil::getHtmlPath(ilUtil::getImagePath("radiobutton_unchecked.gif")));
                                        $template->setVariable("ALT_RADIO", $this->lng->txt("unchecked"));
                                        $template->setVariable("TITLE_RADIO", $this->lng->txt("unchecked"));
                                        $template->setVariable("TEXT_SC", ilUtil::prepareFormOutput($category));
                                        $template->parseCurrentBlock();
                                }
                                break;
                        case 1:
                                // horizontal orientation
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("radio_col");
                                        $template->setVariable("IMAGE_RADIO", ilUtil::getHtmlPath(ilUtil::getImagePath("radiobutton_unchecked.gif")));
                                        $template->setVariable("ALT_RADIO", $this->lng->txt("unchecked"));
                                        $template->setVariable("TITLE_RADIO", $this->lng->txt("unchecked"));
                                        $template->parseCurrentBlock();
                                }
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("text_col");
                                        $template->setVariable("TEXT_SC", $category);
                                        $template->parseCurrentBlock();
                                }
                                break;
                        case 2:
                                // combobox output
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("comborow");
                                        $template->setVariable("TEXT_SC", ilUtil::prepareFormOutput($category));
                                        $template->setVariable("VALUE_SC", $i);
                                        if (is_array($working_data))
                                        {
                                                if (strcmp($working_data[0]["value"], "") != 0)
                                                {
                                                        if ($working_data[0]["value"] == $i)
                                                        {
                                                                $template->setVariable("SELECTED_SC", " selected=\"selected\"");
                                                        }
                                                }
                                        }
                                        $template->parseCurrentBlock();
                                }
                                $template->setCurrentBlock("combooutput");
                                $template->setVariable("QUESTION_ID", $this->object->getId());
                                $template->setVariable("SELECT_OPTION", $this->lng->txt("select_option"));
                                $template->setVariable("TEXT_SELECTION", $this->lng->txt("selection"));
                                $template->parseCurrentBlock();
                                break;
                }
                if ($question_title)
                {
                        $template->setVariable("QUESTION_TITLE", $this->object->getTitle());
                }
                if ($show_questiontext)
                {
                        $questiontext = $this->object->getQuestiontext();
                        $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
                }
                if (! $this->object->getObligatory($survey_id))
                {
                        $template->setVariable("OBLIGATORY_TEXT", $this->lng->txt("survey_question_optional"));
                }
                $template->parseCurrentBlock();
                return $template->get();
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::getWorkingForm	(		$working_data = "",
			$question_title = 1,
			$show_questiontext = 1,
			$error_message = "",
			$survey_id = null
	)

Creates the question output form for the learner.

public

Definition at line 482 of file class.SurveySingleChoiceQuestionGUI.php.

References SurveyQuestionGUI\getMaterialOutput(), and ilUtil\prepareFormOutput().

Referenced by preview().

        {
                $template = new ilTemplate("tpl.il_svy_out_sc.html", TRUE, TRUE, "Modules/SurveyQuestionPool");
                $template->setCurrentBlock("material");
                $template->setVariable("TEXT_MATERIAL", $this->getMaterialOutput());
                $template->parseCurrentBlock();
                switch ($this->object->orientation)
                {
                        case 0:
                                // vertical orientation
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("row");
                                        $template->setVariable("TEXT_SC", ilUtil::prepareFormOutput($category));
                                        $template->setVariable("VALUE_SC", $i);
                                        $template->setVariable("QUESTION_ID", $this->object->getId());
                                        if (is_array($working_data))
                                        {
                                                if (strcmp($working_data[0]["value"], "") != 0)
                                                {
                                                        if ($working_data[0]["value"] == $i)
                                                        {
                                                                $template->setVariable("CHECKED_SC", " checked=\"checked\"");
                                                        }
                                                }
                                        }
                                        $template->parseCurrentBlock();
                                }
                                break;
                        case 1:
                                // horizontal orientation
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("radio_col");
                                        $template->setVariable("VALUE_SC", $i);
                                        $template->setVariable("QUESTION_ID", $this->object->getId());
                                        if (is_array($working_data))
                                        {
                                                if (strcmp($working_data[0]["value"], "") != 0)
                                                {
                                                        if ($working_data[0]["value"] == $i)
                                                        {
                                                                $template->setVariable("CHECKED_SC", " checked=\"checked\"");
                                                        }
                                                }
                                        }
                                        $template->parseCurrentBlock();
                                }
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("text_col");
                                        $template->setVariable("VALUE_SC", $i);
                                        $template->setVariable("TEXT_SC", ilUtil::prepareFormOutput($category));
                                        $template->setVariable("QUESTION_ID", $this->object->getId());
                                        $template->parseCurrentBlock();
                                }
                                break;
                        case 2:
                                // combobox output
                                for ($i = 0; $i < $this->object->categories->getCategoryCount(); $i++) 
                                {
                                        $category = $this->object->categories->getCategory($i);
                                        $template->setCurrentBlock("comborow");
                                        $template->setVariable("TEXT_SC", $category);
                                        $template->setVariable("VALUE_SC", $i);
                                        if (is_array($working_data))
                                        {
                                                if (strcmp($working_data[0]["value"], "") != 0)
                                                {
                                                        if ($working_data[0]["value"] == $i)
                                                        {
                                                                $template->setVariable("SELECTED_SC", " selected=\"selected\"");
                                                        }
                                                }
                                        }
                                        $template->parseCurrentBlock();
                                }
                                $template->setCurrentBlock("combooutput");
                                $template->setVariable("QUESTION_ID", $this->object->getId());
                                $template->setVariable("SELECT_OPTION", $this->lng->txt("select_option"));
                                $template->setVariable("TEXT_SELECTION", $this->lng->txt("selection"));
                                $template->parseCurrentBlock();
                                break;
                }
                if ($question_title)
                {
                        $template->setVariable("QUESTION_TITLE", $this->object->getTitle());
                }
                $template->setCurrentBlock("question_data");
                if (strcmp($error_message, "") != 0)
                {
                        $template->setVariable("ERROR_MESSAGE", "<p class=\"warning\">$error_message</p>");
                }
                if ($show_questiontext)
                {
                        $questiontext = $this->object->getQuestiontext();
                        $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
                }
                if (! $this->object->getObligatory($survey_id))
                {
                        $template->setVariable("OBLIGATORY_TEXT", $this->lng->txt("survey_question_optional"));
                }
                $template->parseCurrentBlock();
                return $template->get();
        }

Here is the call graph for this function:

Here is the caller graph for this function:

SurveySingleChoiceQuestionGUI::insertStandardNumbers

(

)

Insert standard numbers to the question.

public

Definition at line 370 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, addStandardNumbers(), ilUtil\sendInfo(), and ilUtil\sendSuccess().

        {
                if ((strcmp($_POST["lower_limit"], "") == 0) or (strcmp($_POST["upper_limit"], "") == 0))
                {
                        ilUtil::sendInfo($this->lng->txt("missing_upper_or_lower_limit"));
                        $this->addStandardNumbers();
                }
                else if ((int)$_POST["upper_limit"] <= (int)$_POST["lower_limit"])
                {
                        ilUtil::sendInfo($this->lng->txt("upper_limit_must_be_greater"));
                        $this->addStandardNumbers();
                }
                else
                {
                        $this->object->addStandardNumbers($_POST["lower_limit"], $_POST["upper_limit"]);
                        $this->object->saveToDb();
                        ilUtil::sendSuccess($this->lng->txt('phrase_added'), true);
                        $this->ctrl->redirect($this, "editQuestion");
                }
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::preview

(

)

Creates a preview of the question.

private

Definition at line 682 of file class.SurveySingleChoiceQuestionGUI.php.

References getWorkingForm().

        {
                $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_svy_qpl_preview.html", "Modules/SurveyQuestionPool");
                $question_output = $this->getWorkingForm();
                $this->tpl->setVariable("QUESTION_OUTPUT", $question_output);
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::removeanswers

(

)

Remove an answer.

Definition at line 211 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, SurveyQuestionGUI\editQuestion(), and writePostData().

        {
                $this->writePostData(true);
                $position = key($_POST['cmd']['removeanswers']);
                $this->object->getCategories()->removeCategory($position);
                $this->editQuestion();
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::savePhraseanswers

(

$haserror = false

)

Creates an output to save the current answers as a phrase.

public

Definition at line 396 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, $key, $result, ilUtil\sendFailure(), ilUtil\stripSlashes(), and writePostData().

Referenced by confirmSavePhrase().

        {
                if (!$haserror) $result = $this->writePostData();
                if ($result == 0 || $haserror)
                {
                        if (!$haserror) $this->object->saveToDb();
                        $nothing_selected = true;
                        $nothing_selected = false;
                        $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_svy_qpl_savephrase.html", "Modules/SurveyQuestionPool");
                        $rowclass = array("tblrow1", "tblrow2");
                        $counter = 0;
                        foreach ($_POST['answers']['answer'] as $key => $value) 
                        {
                                if (strlen($value))
                                {
                                        $this->tpl->setCurrentBlock("row");
                                        $this->tpl->setVariable("TXT_TITLE", ilUtil::stripSlashes($value));
                                        $this->tpl->setVariable("COLOR_CLASS", $rowclass[$counter % 2]);
                                        $this->tpl->parseCurrentBlock();
                                        $this->tpl->setCurrentBlock("hidden");
                                        $this->tpl->setVariable("HIDDEN_NAME", "answers[answer][]");
                                        $this->tpl->setVariable("HIDDEN_VALUE", ilUtil::stripSlashes($value));
                                        $this->tpl->parseCurrentBlock();
                                        $counter++;
                                }
                        }
                        if ($counter == 0)
                        {
                                ilUtil::sendFailure($this->lng->txt("check_category_to_save_phrase"), true);
                                $this->ctrl->redirect($this, "editQuestion");
                        }
                        $this->tpl->setCurrentBlock("adm_content");
                        $this->tpl->setVariable("SAVE_PHRASE_INTRODUCTION", $this->lng->txt("save_phrase_introduction"));
                        $this->tpl->setVariable("TEXT_PHRASE_TITLE", $this->lng->txt("enter_phrase_title"));
                        $this->tpl->setVariable("TXT_TITLE", $this->lng->txt("category"));
                        $this->tpl->setVariable("VALUE_PHRASE_TITLE", $_POST["phrase_title"]);
                        $this->tpl->setVariable("BTN_CANCEL",$this->lng->txt("cancel"));
                        $this->tpl->setVariable("BTN_CONFIRM",$this->lng->txt("confirm"));
                        $this->tpl->setVariable("FORM_ACTION", $this->ctrl->getFormAction($this));
                        $this->tpl->parseCurrentBlock();
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

SurveySingleChoiceQuestionGUI::setQuestionTabs

(

)

Definition at line 689 of file class.SurveySingleChoiceQuestionGUI.php.

References $_GET, $_SESSION, $ref_id, $title, and SurveyQuestionGUI\getQuestionType().

        {
                global $rbacsystem,$ilTabs;
                $this->ctrl->setParameter($this, "sel_question_types", $this->getQuestionType());
                $this->ctrl->setParameter($this, "q_id", $_GET["q_id"]);

                if (($_GET["calling_survey"] > 0) || ($_GET["new_for_survey"] > 0))
                {
                        $ref_id = $_GET["calling_survey"];
                        if (!strlen($ref_id)) $ref_id = $_GET["new_for_survey"];
                        $addurl = "";
                        if (strlen($_GET["new_for_survey"]))
                        {
                                $addurl = "&new_id=" . $_GET["q_id"];
                        }
                        $ilTabs->setBackTarget($this->lng->txt("menubacktosurvey"), "ilias.php?baseClass=ilObjSurveyGUI&ref_id=$ref_id&cmd=questions" . $addurl);
                }
                else
                {
                        $this->ctrl->setParameterByClass("ilObjSurveyQuestionPoolGUI", "q_id_table_nav", $_SESSION['q_id_table_nav']);
                        $ilTabs->setBackTarget($this->lng->txt("spl"), $this->ctrl->getLinkTargetByClass("ilObjSurveyQuestionPoolGUI", "questions"));
                }
                if ($_GET["q_id"])
                {
                        $ilTabs->addTarget("preview",
                                $this->ctrl->getLinkTarget($this, "preview"), 
                                        "preview",
                                        "",
                                        ""
                        );
                }
                if ($rbacsystem->checkAccess('edit', $_GET["ref_id"])) {
                        $ilTabs->addTarget("edit_properties",
                                $this->ctrl->getLinkTarget($this, "editQuestion"), 
                                        array("editQuestion", "save", "cancel", "wizardanswers", "addSelectedPhrase",
                                                "insertStandardNumbers", "savePhraseanswers", "confirmSavePhrase"),
                                        "",
                                        ""
                        );
                }
                if ($_GET["q_id"])
                {
                        $ilTabs->addTarget("material",
                                $this->ctrl->getLinkTarget($this, "material"), 
                                        array("material", "cancelExplorer", "linkChilds", "addGIT", "addST",
                                                "addPG", "addMaterial", "removeMaterial"),
                                "",
                                ""
                        );
                }

                if ($this->object->getId() > 0) 
                {
                        $title = $this->lng->txt("edit") . " "" . $this->object->getTitle() . "&quot";
                } 
                else 
                {
                        $title = $this->lng->txt("create_new") . " " . $this->lng->txt($this->getQuestionType());
                }

                $this->tpl->setVariable("HEADER", $title);
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::SurveySingleChoiceQuestionGUI

(

$id = -1

)

SurveySingleChoiceQuestionGUI constructor.

The constructor takes possible arguments an creates an instance of the SurveySingleChoiceQuestionGUI object.

Parameters

integer

$id

The database id of a single choice question object public

Definition at line 49 of file class.SurveySingleChoiceQuestionGUI.php.

References SurveyQuestionGUI\SurveyQuestionGUI().

  {
                $this->SurveyQuestionGUI();
                include_once "./Modules/SurveyQuestionPool/classes/class.SurveySingleChoiceQuestion.php";
                $this->object = new SurveySingleChoiceQuestion();
                if ($id >= 0)
                {
                        $this->object->loadFromDb($id);
                }
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::upanswers

(

)

Move an answer up.

Definition at line 222 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, SurveyQuestionGUI\editQuestion(), and writePostData().

        {
                $this->writePostData(true);
                $position = key($_POST['cmd']['upanswers']);
                $this->object->getCategories()->moveCategoryUp($position);
                $this->editQuestion();
        }

Here is the call graph for this function:

SurveySingleChoiceQuestionGUI::wizardanswers

(

$save_post_data = true

)

Creates an output for the addition of phrases.

public

Definition at line 246 of file class.SurveySingleChoiceQuestionGUI.php.

References $result, ilSurveyPhrases\_getAvailablePhrases(), ilSurveyPhrases\_getCategoriesForPhrase(), and writePostData().

Referenced by addSelectedPhrase().

        {
                if ($save_post_data) $result = $this->writePostData();
                if ($result == 0 || !$save_post_data)
                {
                        if ($save_post_data) $this->object->saveToDb();
                        $this->tpl->addBlockFile("ADM_CONTENT", "adm_content", "tpl.il_svy_qpl_addphrase.html", "Modules/SurveyQuestionPool");

                        // set the id to return to the selected question
                        $this->tpl->setCurrentBlock("hidden");
                        $this->tpl->setVariable("HIDDEN_NAME", "id");
                        $this->tpl->setVariable("HIDDEN_VALUE", $this->object->getId());
                        $this->tpl->parseCurrentBlock();

                        include_once "./Modules/SurveyQuestionPool/classes/class.ilSurveyPhrases.php";
                        $phrases =& ilSurveyPhrases::_getAvailablePhrases();
                        $colors = array("tblrow1", "tblrow2");
                        $counter = 0;
                        foreach ($phrases as $phrase_id => $phrase_array)
                        {
                                $this->tpl->setCurrentBlock("phraserow");
                                $this->tpl->setVariable("COLOR_CLASS", $colors[$counter++ % 2]);
                                $this->tpl->setVariable("PHRASE_VALUE", $phrase_id);
                                $this->tpl->setVariable("PHRASE_NAME", $phrase_array["title"]);
                                $categories =& ilSurveyPhrases::_getCategoriesForPhrase($phrase_id);
                                $this->tpl->setVariable("PHRASE_CONTENT", join($categories, ","));
                                $this->tpl->parseCurrentBlock();
                        }

                        $this->tpl->setCurrentBlock("adm_content");
                        $this->tpl->setVariable("TEXT_CANCEL", $this->lng->txt("cancel"));
                        $this->tpl->setVariable("TEXT_PHRASE", $this->lng->txt("phrase"));
                        $this->tpl->setVariable("TEXT_CONTENT", $this->lng->txt("categories"));
                        $this->tpl->setVariable("TEXT_ADD_PHRASE", $this->lng->txt("add_phrase"));
                        $this->tpl->setVariable("TEXT_INTRODUCTION",$this->lng->txt("add_phrase_introduction"));
                        $this->tpl->setVariable("FORM_ACTION", $this->ctrl->getFormAction($this));
                        $this->tpl->parseCurrentBlock();
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

SurveySingleChoiceQuestionGUI::writePostData

(

$always = false

)

Evaluates a posted edit form and writes the form data in the question object.

Returns

integer A positive value, if one of the required fields wasn't set, else 0 private

Definition at line 69 of file class.SurveySingleChoiceQuestionGUI.php.

References $_POST, $key, and SurveyQuestionGUI\editQuestion().

Referenced by addanswers(), downanswers(), removeanswers(), savePhraseanswers(), upanswers(), and wizardanswers().

        {
                $hasErrors = (!$always) ? $this->editQuestion(true) : false;
                if (!$hasErrors)
                {
                        $this->object->setTitle($_POST["title"]);
                        $this->object->setAuthor($_POST["author"]);
                        $this->object->setDescription($_POST["description"]);
                        include_once "./Services/AdvancedEditing/classes/class.ilObjAdvancedEditing.php";
                        $questiontext = $_POST["question"];
                        $this->object->setQuestiontext($questiontext);
                        $this->object->setObligatory(($_POST["obligatory"]) ? 1 : 0);
                        $this->object->setOrientation($_POST["orientation"]);

            $this->object->categories->flushCategories();

                        foreach ($_POST['answers']['answer'] as $key => $value) 
                        {
                                if (strlen($value)) $this->object->getCategories()->addCategory($value);
                        }
                        return 0;
                }
                else
                {
                        return 1;
                }
        }

Here is the call graph for this function:

Here is the caller graph for this function:

---

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

• Modules/SurveyQuestionPool/classes/class.SurveySingleChoiceQuestionGUI.php