ILIAS  release_5-2 Revision v5.2.25-18-g3f80b828510
Public Member Functions | Data Fields | Protected Member Functions | Private Member Functions
assMultipleChoiceGUI Class Reference
Modules/TestQuestionPool

Multiple choice question GUI representation. More...

+ Inheritance diagram for assMultipleChoiceGUI:
+ Collaboration diagram for assMultipleChoiceGUI:

Public Member Functions

 __construct ($id=-1)
 assMultipleChoiceGUI constructor More...
 
 editQuestion ($checkonly=FALSE)
 Creates an output of the edit form for the question. More...
 
 addBasicQuestionFormProperties ($form)
 Add basic question form properties: assessment: title, author, description, question, working time. More...
 
 uploadchoice ()
 Upload an image. More...
 
 removeimagechoice ()
 Remove an image. More...
 
 addchoice ()
 Add a new answer. More...
 
 removechoice ()
 Remove an answer. More...
 
 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, $show_question_text=TRUE)
 Get the question solution output. More...
 
 getPreview ($show_question_only=FALSE, $showInlineFeedback=false)
 
 getTestOutput ( $active_id, $pass, $is_postponed=FALSE, $use_post_solutions=FALSE, $show_feedback=FALSE)
 
 populateJavascriptFilesRequiredForWorkForm (ilTemplate $tpl)
 
 setQuestionTabs ()
 Sets the ILIAS tabs for this question type. More...
 
 getChoiceKeys ()
 Create the key index numbers for the array of choices. More...
 
 getSpecificFeedbackOutput ($active_id, $pass)
 Returns the answer specific feedback for the question. More...
 
 writeQuestionSpecificPostData (ilPropertyFormGUI $form)
 Extracts the question specific values from $_POST and applies them to the data object. More...
 
 writeAnswerSpecificPostData (ilPropertyFormGUI $form)
 Extracts the answer specific values from $_POST and applies them to the data object. More...
 
 populateQuestionSpecificFormPart (\ilPropertyFormGUI $form)
 
 populateAnswerSpecificFormPart (\ilPropertyFormGUI $form)
 
 getAfterParticipationSuppressionAnswerPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 
 getAfterParticipationSuppressionQuestionPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 
 getAggregatedAnswersView ($relevant_answers)
 Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface. More...
 
 aggregateAnswers ($relevant_answers_chosen, $answers_defined_on_question)
 
 renderAggregateView ($aggregate)
 
 setWithNoneAbove ($a_with_none_above)
 Enable the 'None above' addition in a test run. More...
 
 setIsAnswered ($a_is_answered)
 Show the question as answered in a test run. More...
 
- Public Member Functions inherited from assQuestionGUI
 __construct ()
 assQuestionGUI constructor More...
 
 executeCommand ()
 execute command More...
 
 getCommand ($cmd)
 
 getType ()
 needed for page editor compliance More...
 
 getPresentationContext ()
 
 setPresentationContext ($presentationContext)
 
 isTestPresentationContext ()
 
 getRenderPurpose ()
 
 setRenderPurpose ($renderPurpose)
 
 isRenderPurposePrintPdf ()
 
 isRenderPurposePreview ()
 
 isRenderPurposeInputValue ()
 
 isRenderPurposePlayback ()
 
 isRenderPurposeDemoplay ()
 
 renderPurposeSupportsFormHtml ()
 
 getEditContext ()
 
 setEditContext ($editContext)
 
 isAuthoringEditContext ()
 
 isAdjustmentEditContext ()
 
 setAdjustmentEditContext ()
 
 getNavigationGUI ()
 
 setNavigationGUI ($navigationGUI)
 
 setTaxonomyIds ($taxonomyIds)
 
 getTaxonomyIds ()
 
 setTargetGui ($linkTargetGui)
 
 setTargetGuiClass ($targetGuiClass)
 
 getTargetGuiClass ()
 
 setQuestionHeaderBlockBuilder ($questionHeaderBlockBuilder)
 
 getQuestionHeaderBlockBuilder ()
 
 setQuestionActionCmd ($questionActionCmd)
 
 getQuestionActionCmd ()
 
& createQuestionGUI ($question_type, $question_id=-1)
 Creates a question gui representation. More...
 
 populateJavascriptFilesRequiredForWorkForm (ilTemplate $tpl)
 
 getQuestionTemplate ()
 get question template More...
 
 getILIASPage ($html="")
 Returns the ILIAS Page around a question. More...
 
 outQuestionPage ($a_temp_var, $a_postponed=false, $active_id="", $html="")
 output question page More...
 
 cancel ()
 cancel action More...
 
 originalSyncForm ($return_to="", $return_to_feedback='')
 
 sync ()
 
 cancelSync ()
 
 saveEdit ()
 save question More...
 
 save ()
 save question More...
 
 saveReturn ()
 save question More...
 
 apply ()
 apply changes More...
 
 getContextPath ($cont_obj, $a_endnode_id, $a_startnode_id=1)
 get context path in content object tree More...
 
 setSequenceNumber ($nr)
 
 getSequenceNumber ()
 
 setQuestionCount ($a_question_count)
 
 getQuestionCount ()
 
 getErrorMessage ()
 
 setErrorMessage ($errormessage)
 
 addErrorMessage ($errormessage)
 
 outAdditionalOutput ()
 
 getQuestionType ()
 Returns the question type string. More...
 
 getAsValueAttribute ($a_value)
 Returns a HTML value attribute. More...
 
 addNewIdListener (&$a_object, $a_method, $a_parameters="")
 Add a listener that is notified with the new question ID, when a new question is saved. More...
 
 callNewIdListeners ($a_new_id)
 Call the new id listeners. More...
 
 addQuestionFormCommandButtons ($form)
 Add the command buttons of a question properties form. More...
 
 addBasicQuestionFormProperties ($form)
 Add basic question form properties: assessment: title, author, description, question, working time. More...
 
 getAnswerFeedbackOutput ($active_id, $pass)
 Returns the answer generic feedback depending on the results of the question. More...
 
 getGenericFeedbackOutput ($active_id, $pass)
 Returns the answer specific feedback for the question. More...
 
 getGenericFeedbackOutputForCorrectSolution ()
 
 getGenericFeedbackOutputForIncorrectSolution ()
 
 getSpecificFeedbackOutput ($active_id, $pass)
 Returns the answer specific feedback for the question. More...
 
 outQuestionType ()
 
 showSuggestedSolution ()
 
 suggestedsolution ()
 Allows to add suggested solutions for questions. More...
 
 outSolutionExplorer ()
 
 saveSuggestedSolution ()
 
 cancelExplorer ()
 
 outPageSelector ()
 
 outChapterSelector ()
 
 outGlossarySelector ()
 
 linkChilds ()
 
 addPG ()
 
 addST ()
 
 addGIT ()
 
 isSaveCommand ()
 
 setQuestionTabs ()
 
 addTab_SuggestedSolution (ilTabsGUI $tabs, $classname)
 
 getEditQuestionTabCommands ()
 
 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, $show_question_text=TRUE)
 
 isAutosaveable ()
 
 getPreview ($show_question_only=FALSE, $showInlineFeedback=false)
 
 outQuestionForTest ( $formaction, $active_id, $pass, $is_question_postponed=FALSE, $user_post_solutions=FALSE, $show_specific_inline_feedback=FALSE)
 
 magicAfterTestOutput ()
 
 getTestOutput ( $active_id, $pass, $is_question_postponed, $user_post_solutions, $show_specific_inline_feedback)
 
 getFormEncodingType ()
 
 setPreviewSession ($previewSession)
 
 getPreviewSession ()
 
 showHints ()
 
- Public Member Functions inherited from ilGuiQuestionScoringAdjustable
 populateQuestionSpecificFormPart (ilPropertyFormGUI $form)
 Adds the question specific forms parts to a question property form gui. More...
 
 writeQuestionSpecificPostData (ilPropertyFormGUI $form)
 Extracts the question specific values from $_POST and applies them to the data object. More...
 
 getAfterParticipationSuppressionQuestionPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 
 getAggregatedAnswersView ($relevant_answers)
 Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface. More...
 
- Public Member Functions inherited from ilGuiAnswerScoringAdjustable
 populateAnswerSpecificFormPart (ilPropertyFormGUI $form)
 Adds the answer specific form parts to a question property form gui. More...
 
 writeAnswerSpecificPostData (ilPropertyFormGUI $form)
 Extracts the answer specific values from $_POST and applies them to the data object. More...
 
 getAfterParticipationSuppressionAnswerPostVars ()
 Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. More...
 

Data Fields

 $choiceKeys
 
- Data Fields inherited from assQuestionGUI
const FORM_MODE_EDIT = 'edit'
 
const FORM_MODE_ADJUST = 'adjust'
 
const FORM_ENCODING_URLENCODE = 'application/x-www-form-urlencoded'
 
const FORM_ENCODING_MULTIPART = 'multipart/form-data'
 
const SESSION_PREVIEW_DATA_BASE_INDEX = 'ilAssQuestionPreviewAnswers'
 
 $object
 
 $tpl
 
 $lng
 
 $error
 
 $errormessage
 
 $sequence_no
 sequence number in test More...
 
 $question_count
 question count in test More...
 
const PRESENTATION_CONTEXT_TEST = 'pContextTest'
 
const PRESENTATION_CONTEXT_RESULTS = 'pContextResults'
 
const RENDER_PURPOSE_PLAYBACK = 'renderPurposePlayback'
 
const RENDER_PURPOSE_DEMOPLAY = 'renderPurposeDemoplay'
 
const RENDER_PURPOSE_PREVIEW = 'renderPurposePreview'
 
const RENDER_PURPOSE_PRINT_PDF = 'renderPurposePrintPdf'
 
const RENDER_PURPOSE_INPUT_VALUE = 'renderPurposeInputValue'
 
const EDIT_CONTEXT_AUTHORING = 'authoring'
 
const EDIT_CONTEXT_ADJUSTMENT = 'adjustment'
 

Protected Member Functions

 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
} More...
 
 getEditAnswersSingleLine ($checkonly=false)
 Get the single/multiline editing of answers. More...
 
 buildEditForm ()
 
- Protected Member Functions inherited from assQuestionGUI
 writePostData ($always=false)
 Evaluates a posted edit form and writes the form data in the question object. More...
 
 renderEditForm ($form)
 
 getPreviousSolutionProvidedMessage ()
 
 getPreviousSolutionConfirmationCheckboxHtml ()
 
 saveTaxonomyAssignments ()
 
 populateTaxonomyFormSection (ilPropertyFormGUI $form)
 
 getBasicEditQuestionTabCommands ()
 
 getAdditionalEditQuestionCommands ()
 
 addTab_QuestionFeedback (ilTabsGUI $tabs)
 adds the feedback tab to ilTabsGUI More...
 
 addTab_QuestionHints (ilTabsGUI $tabs)
 adds the hints tab to ilTabsGUI More...
 
 addTab_QuestionPreview (ilTabsGUI $tabsGUI)
 
 hasCorrectSolution ($activeId, $passIndex)
 
 writeQuestionGenericPostData ()
 
 completeTestOutputFormAction ($formAction, $active_id, $pass)
 
 addBackTab (ilTabsGUI $ilTabs)
 
 buildBasicEditFormObject ()
 
 buildEditForm ()
 

Private Member Functions

 populateSpecificFeedbackInline ($user_solution, $answer_id, $template)
 

Additional Inherited Members

- Static Public Member Functions inherited from assQuestionGUI
static _getQuestionGUI ($question_type, $question_id=-1)
 Creates a question gui representation and returns the alias to the question gui note: please do not use $this inside this method to allow static calls. More...
 
static _getGUIClassNameForId ($a_q_id)
 
static _getClassNameForQType ($q_type)
 
static getCommandsFromClassConstants ($guiClassName, $cmdConstantNameBegin='CMD_')
 extracts values of all constants of given class with given prefix as array can be used to get all possible commands in case of these commands are defined as constants More...
 
- Protected Attributes inherited from assQuestionGUI
 $editForm
 

Detailed Description

Multiple choice question GUI representation.

The assMultipleChoiceGUI class encapsulates the GUI representation for multiple choice questions.

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
Björn Heyser bheys.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de
Maximilian Becker mbeck.nosp@m.er@d.nosp@m.ataba.nosp@m.y.de
Version
$Id$

@ilCtrl_Calls assMultipleChoiceGUI: ilFormPropertyDispatchGUI

Definition at line 23 of file class.assMultipleChoiceGUI.php.

Constructor & Destructor Documentation

◆ __construct()

assMultipleChoiceGUI::__construct (   $id = -1)

assMultipleChoiceGUI constructor

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

Parameters
integer$idThe database id of a multiple choice question object @access public

Definition at line 35 of file class.assMultipleChoiceGUI.php.

36 {
37 parent::__construct();
38 include_once "./Modules/TestQuestionPool/classes/class.assMultipleChoice.php";
39 $this->object = new assMultipleChoice();
40 if ($id >= 0)
41 {
42 $this->object->loadFromDb($id);
43 }
44 }
assMultipleChoice
Class for multiple choice tests.
Definition: class.assMultipleChoice.php:28

Member Function Documentation

◆ addBasicQuestionFormProperties()

assMultipleChoiceGUI::addBasicQuestionFormProperties (   $form)

Add basic question form properties: assessment: title, author, description, question, working time.

Returns
int Default Nr of Tries

Reimplemented from assQuestionGUI.

Definition at line 134 of file class.assMultipleChoiceGUI.php.

135 {
136 parent::addBasicQuestionFormProperties($form);
137 $form->getItemByPostVar('question')->setInitialRteWidth('100');
138 }

Referenced by buildEditForm().

+ Here is the caller graph for this function:

◆ addchoice()

assMultipleChoiceGUI::addchoice ( )

Add a new answer.

Definition at line 165 of file class.assMultipleChoiceGUI.php.

166 {
167 $this->writePostData(true);
168 $position = key($_POST['cmd']['addchoice']);
169 $this->object->addAnswer("", 0, 0, $position+1);
170 $this->editQuestion();
171 }
$_POST
$_POST["username"]
Definition: cfg.phpunit.template.php:11
assMultipleChoiceGUI\editQuestion
editQuestion($checkonly=FALSE)
Creates an output of the edit form for the question.
Definition: class.assMultipleChoiceGUI.php:101
assMultipleChoiceGUI\writePostData
writePostData($always=false)
{Evaluates a posted edit form and writes the form data in the question object.integer A positive valu...
Definition: class.assMultipleChoiceGUI.php:49

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

+ Here is the call graph for this function:

◆ aggregateAnswers()

assMultipleChoiceGUI::aggregateAnswers (   $relevant_answers_chosen,
  $answers_defined_on_question 
)

Definition at line 981 of file class.assMultipleChoiceGUI.php.

982 {
983 $aggregate = array();
984 foreach ($answers_defined_on_question as $answer)
985 {
986 $aggregated_info_for_answer = array();
987 $aggregated_info_for_answer['answertext'] = $answer->getAnswerText();
988 $aggregated_info_for_answer['count_checked'] = 0;
989
990 foreach ($relevant_answers_chosen as $relevant_answer)
991 {
992 if ($relevant_answer['value1'] == $answer->getOrder())
993 {
994 $aggregated_info_for_answer['count_checked']++;
995 }
996 }
997 $aggregated_info_for_answer['count_unchecked'] =
998 ceil(count($relevant_answers_chosen) / count($answers_defined_on_question))
999 - $aggregated_info_for_answer['count_checked'];
1000
1001 $aggregate[] = $aggregated_info_for_answer;
1002 }
1003 return $aggregate;
1004 }

Referenced by getAggregatedAnswersView().

+ Here is the caller graph for this function:

◆ buildEditForm()

assMultipleChoiceGUI::buildEditForm ( )
protected
Returns
ilPropertyFormGUI

Reimplemented from assQuestionGUI.

Definition at line 1110 of file class.assMultipleChoiceGUI.php.

1111 {
1112 include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
1113 $form = new ilPropertyFormGUI();
1114 $form->setFormAction($this->ctrl->getFormAction($this));
1115 $form->setTitle($this->outQuestionType());
1116 $form->setTableWidth("100%");
1117 $form->setId("assmultiplechoice");
1118
1119 // title, author, description, question, working time (assessment mode)
1120 $this->addBasicQuestionFormProperties($form);
1121 $this->populateQuestionSpecificFormPart($form);
1122 $this->populateAnswerSpecificFormPart($form);
1123 $this->populateTaxonomyFormSection($form);
1124 $this->addQuestionFormCommandButtons($form);
1125 return $form;
1126 }
assMultipleChoiceGUI\addBasicQuestionFormProperties
addBasicQuestionFormProperties($form)
Add basic question form properties: assessment: title, author, description, question,...
Definition: class.assMultipleChoiceGUI.php:134
assMultipleChoiceGUI\populateQuestionSpecificFormPart
populateQuestionSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMultipleChoiceGUI.php:856
assMultipleChoiceGUI\populateAnswerSpecificFormPart
populateAnswerSpecificFormPart(\ilPropertyFormGUI $form)
Definition: class.assMultipleChoiceGUI.php:918
assQuestionGUI\populateTaxonomyFormSection
populateTaxonomyFormSection(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:1277
assQuestionGUI\addQuestionFormCommandButtons
addQuestionFormCommandButtons($form)
Add the command buttons of a question properties form.
Definition: class.assQuestionGUI.php:1140
ilPropertyFormGUI
This class represents a property form user interface.
Definition: class.ilPropertyFormGUI.php:48

References addBasicQuestionFormProperties(), assQuestionGUI\addQuestionFormCommandButtons(), assQuestionGUI\outQuestionType(), populateAnswerSpecificFormPart(), populateQuestionSpecificFormPart(), and assQuestionGUI\populateTaxonomyFormSection().

Referenced by editQuestion(), and writePostData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ editQuestion()

assMultipleChoiceGUI::editQuestion (   $checkonly = FALSE)

Creates an output of the edit form for the question.

Parameters
bool$checkonly
Returns
bool

Definition at line 101 of file class.assMultipleChoiceGUI.php.

102 {
103 $save = $this->isSaveCommand();
104 $this->getQuestionTemplate();
105
106 $form = $this->buildEditForm();
107
108 $isSingleline = $this->getEditAnswersSingleLine($checkonly);
109 if ($isSingleline)
110 {
111 $form->setMultipart(TRUE);
112 }
113 else
114 {
115 $form->setMultipart(FALSE);
116 }
117
118 $errors = false;
119
120 if ($save)
121 {
122 $form->getItemByPostVar('selection_limit')->setMaxValue(count((array)$_POST['choice']['answer']));
123
124 $form->setValuesByPost();
125 $errors = !$form->checkInput();
126 $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
127 if ($errors) $checkonly = false;
128 }
129
130 if (!$checkonly) $this->tpl->setVariable("QUESTION_DATA", $form->getHTML());
131 return $errors;
132 }
assMultipleChoiceGUI\getEditAnswersSingleLine
getEditAnswersSingleLine($checkonly=false)
Get the single/multiline editing of answers.
Definition: class.assMultipleChoiceGUI.php:73
assQuestionGUI\getQuestionTemplate
getQuestionTemplate()
get question template
Definition: class.assQuestionGUI.php:480
$errors
$errors
Definition: tcpdf_addfont.php:246

References $_POST, $errors, buildEditForm(), getEditAnswersSingleLine(), assQuestionGUI\getQuestionTemplate(), and assQuestionGUI\isSaveCommand().

Referenced by addchoice(), removechoice(), removeimagechoice(), uploadchoice(), and writePostData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ getAfterParticipationSuppressionAnswerPostVars()

assMultipleChoiceGUI::getAfterParticipationSuppressionAnswerPostVars ( )

Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.

The form elements will be shown disabled, so the users see the usual form but can only edit the settings, which make sense in the given context.

E.g. array('cloze_type', 'image_filename')

Returns
string[]

Implements ilGuiAnswerScoringAdjustable.

Definition at line 948 of file class.assMultipleChoiceGUI.php.

949 {
950 return array();
951 }

◆ getAfterParticipationSuppressionQuestionPostVars()

assMultipleChoiceGUI::getAfterParticipationSuppressionQuestionPostVars ( )

Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.

The form elements will be shown disabled, so the users see the usual form but can only edit the settings, which make sense in the given context.

E.g. array('cloze_type', 'image_filename')

Returns
string[]

Implements ilGuiQuestionScoringAdjustable.

Definition at line 962 of file class.assMultipleChoiceGUI.php.

963 {
964 return array();
965 }

◆ getAggregatedAnswersView()

assMultipleChoiceGUI::getAggregatedAnswersView (   $relevant_answers)

Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface.

Parameters
array$relevant_answers
Returns
string

Implements ilGuiQuestionScoringAdjustable.

Definition at line 975 of file class.assMultipleChoiceGUI.php.

976 {
977 return $this->renderAggregateView(
978 $this->aggregateAnswers( $relevant_answers, $this->object->getAnswers() ) )->get();
979 }
assMultipleChoiceGUI\aggregateAnswers
aggregateAnswers($relevant_answers_chosen, $answers_defined_on_question)
Definition: class.assMultipleChoiceGUI.php:981

References aggregateAnswers(), and renderAggregateView().

+ Here is the call graph for this function:

◆ getChoiceKeys()

assMultipleChoiceGUI::getChoiceKeys ( )

Create the key index numbers for the array of choices.

Returns
array

Definition at line 767 of file class.assMultipleChoiceGUI.php.

768 {
769 $choiceKeys = array_keys($this->object->answers);
770
771 if( $this->object->getShuffle() )
772 {
773 $choiceKeys = $this->object->getShuffler()->shuffle($choiceKeys);
774 }
775
776 return $choiceKeys;
777 }

References $choiceKeys.

Referenced by getPreview(), getSolutionOutput(), and getTestOutput().

+ Here is the caller graph for this function:

◆ getEditAnswersSingleLine()

assMultipleChoiceGUI::getEditAnswersSingleLine (   $checkonly = false)
protected

Get the single/multiline editing of answers.

  • The settings of an already saved question is preferred
  • A new question will use the setting of the last edited question by the user
    Parameters
    bool$checkonlyget the setting for checking a POST
    Returns
    bool

Definition at line 73 of file class.assMultipleChoiceGUI.php.

74 {
75 if ($checkonly)
76 {
77 // form posting is checked
78 return ($_POST['types'] == 0) ? true : false;
79 }
80
81 $lastChange = $this->object->getLastChange();
82 if (empty($lastChange) && !isset($_POST['types']))
83 {
84 // a new question is edited
85 return $this->object->getMultilineAnswerSetting() ? false : true;
86 }
87 else
88 {
89 // a saved question is edited
90 return $this->object->isSingleline;
91 }
92 }

References $_POST.

Referenced by editQuestion(), populateAnswerSpecificFormPart(), and populateQuestionSpecificFormPart().

+ Here is the caller graph for this function:

◆ getPreview()

assMultipleChoiceGUI::getPreview (   $show_question_only = FALSE,
  $showInlineFeedback = false 
)

Reimplemented from assQuestionGUI.

Definition at line 450 of file class.assMultipleChoiceGUI.php.

451 {
452 $user_solution = is_object($this->getPreviewSession()) ? (array)$this->getPreviewSession()->getParticipantsSolution() : array();
453 // shuffle output
454 $keys = $this->getChoiceKeys();
455
456 // generate the question output
457 include_once "./Services/UICore/classes/class.ilTemplate.php";
458 $template = new ilTemplate("tpl.il_as_qpl_mc_mr_output.html", TRUE, TRUE, "Modules/TestQuestionPool");
459 foreach ($keys as $answer_id)
460 {
461 $answer = $this->object->answers[$answer_id];
462 if (strlen($answer->getImage()))
463 {
464 if ($this->object->getThumbSize())
465 {
466 $template->setCurrentBlock("preview");
467 $template->setVariable("URL_PREVIEW", $this->object->getImagePathWeb() . $answer->getImage());
468 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
469 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
470 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
471 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
472 $alt = $answer->getImage();
473 if (strlen($answer->getAnswertext()))
474 {
475 $alt = $answer->getAnswertext();
476 }
477 $alt = preg_replace("/<[^>]*?>/", "", $alt);
478 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
479 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
480 $template->parseCurrentBlock();
481 }
482 else
483 {
484 $template->setCurrentBlock("answer_image");
485 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
486 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
487 $alt = $answer->getImage();
488 if (strlen($answer->getAnswertext()))
489 {
490 $alt = $answer->getAnswertext();
491 }
492 $alt = preg_replace("/<[^>]*?>/", "", $alt);
493 $template->setVariable("ATTR", $attr);
494 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
495 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
496 $template->parseCurrentBlock();
497 }
498 }
499
500 if( $showInlineFeedback )
501 {
502 $this->populateSpecificFeedbackInline($user_solution, $answer_id, $template);
503 }
504
505 $template->setCurrentBlock("answer_row");
506 $template->setVariable("QID", $this->object->getId());
507 $template->setVariable("ANSWER_ID", $answer_id);
508 $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), TRUE));
509 foreach ($user_solution as $mc_solution)
510 {
511 if (strcmp($mc_solution, $answer_id) == 0)
512 {
513 $template->setVariable("CHECKED_ANSWER", " checked=\"checked\"");
514 }
515 }
516 $template->parseCurrentBlock();
517 }
518 if($this->object->getSelectionLimit())
519 {
520 $template->setVariable('SELECTION_LIMIT_HINT', sprintf(
521 $this->lng->txt('ass_mc_sel_lim_hint'),
522 $this->object->getSelectionLimit(),
523 $this->object->getAnswerCount()
524 ));
525
526 $template->setVariable('SELECTION_LIMIT_VALUE', $this->object->getSelectionLimit());
527 }
528 else
529 {
530 $template->setVariable('SELECTION_LIMIT_VALUE', 'null');
531 }
532 $template->setVariable("QUESTION_ID", $this->object->getId());
533 $questiontext = $this->object->getQuestion();
534 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
535 $questionoutput = $template->get();
536 if (!$show_question_only)
537 {
538 // get page object output
539 $questionoutput = $this->getILIASPage($questionoutput);
540 }
541 return $questionoutput;
542 }
sprintf
sprintf('%.4f', $callTime)
Definition: 01pharSimple.php:87
assMultipleChoiceGUI\getChoiceKeys
getChoiceKeys()
Create the key index numbers for the array of choices.
Definition: class.assMultipleChoiceGUI.php:767
assMultipleChoiceGUI\populateSpecificFeedbackInline
populateSpecificFeedbackInline($user_solution, $answer_id, $template)
Definition: class.assMultipleChoiceGUI.php:1039
assQuestionGUI\getILIASPage
getILIASPage($html="")
Returns the ILIAS Page around a question.
Definition: class.assQuestionGUI.php:514
ilTemplate
special template class to simplify handling of ITX/PEAR
Definition: class.ilTemplate.php:14
ilUtil\getImagePath
static getImagePath($img, $module_path="", $mode="output", $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:71
ilUtil\prepareFormOutput
static prepareFormOutput($a_str, $a_strip=false)
prepares string output for html forms @access public
Definition: class.ilUtil.php:3060

References getChoiceKeys(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), assQuestionGUI\getPreviewSession(), populateSpecificFeedbackInline(), ilUtil\prepareFormOutput(), and sprintf.

+ Here is the call graph for this function:

◆ getSolutionOutput()

assMultipleChoiceGUI::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,
  $show_question_text = TRUE 
)

Get the question solution output.

Parameters
integer$active_idThe active user id
integer$passThe test pass
boolean$graphicalOutputShow visual feedback for right/wrong answers
boolean$result_outputShow the reached points for parts of the question
boolean$show_question_onlyShow the question without the ILIAS content around
boolean$show_feedbackShow the question feedback
boolean$show_correct_solutionShow the correct solution instead of the user solution
boolean$show_manual_scoringShow specific information for the manual scoring output
bool$show_question_text
Returns
string The solution output of the question as HTML code

Reimplemented from assQuestionGUI.

Definition at line 199 of file class.assMultipleChoiceGUI.php.

210 {
211 // shuffle output
212 $keys = $this->getChoiceKeys();
213
214 // get the solution of the user for the active pass or from the last pass if allowed
215 $user_solution = array();
216 if (($active_id > 0) && (!$show_correct_solution))
217 {
218 $solutions =& $this->object->getSolutionValues($active_id, $pass);
219 foreach ($solutions as $idx => $solution_value)
220 {
221 array_push($user_solution, $solution_value["value1"]);
222 }
223 }
224 else
225 {
226 // take the correct solution instead of the user solution
227 foreach ($this->object->answers as $index => $answer)
228 {
229 $points_checked = $answer->getPointsChecked();
230 $points_unchecked = $answer->getPointsUnchecked();
231 if ($points_checked > $points_unchecked)
232 {
233 if ($points_checked > 0)
234 {
235 array_push($user_solution, $index);
236 }
237 }
238 }
239 }
240
241 // generate the question output
242 include_once "./Services/UICore/classes/class.ilTemplate.php";
243 $template = new ilTemplate("tpl.il_as_qpl_mc_mr_output_solution.html", TRUE, TRUE, "Modules/TestQuestionPool");
244 $solutiontemplate = new ilTemplate("tpl.il_as_tst_solution_output.html",TRUE, TRUE, "Modules/TestQuestionPool");
245 foreach ($keys as $answer_id)
246 {
247 $answer = $this->object->answers[$answer_id];
248 if (($active_id > 0) && (!$show_correct_solution))
249 {
250 if ($graphicalOutput)
251 {
252 // output of ok/not ok icons for user entered solutions
253 $ok = FALSE;
254 $checked = FALSE;
255 foreach ($user_solution as $mc_solution)
256 {
257 if (strcmp($mc_solution, $answer_id) == 0)
258 {
259 $checked = TRUE;
260 }
261 }
262 if ($checked)
263 {
264 if ($answer->getPointsChecked() > $answer->getPointsUnchecked())
265 {
266 $ok = TRUE;
267 }
268 else
269 {
270 $ok = FALSE;
271 }
272 }
273 else
274 {
275 if ($answer->getPointsChecked() > $answer->getPointsUnchecked())
276 {
277 $ok = FALSE;
278 }
279 else
280 {
281 $ok = TRUE;
282 }
283 }
284 if ($ok)
285 {
286 $template->setCurrentBlock("icon_ok");
287 $template->setVariable("ICON_OK", ilUtil::getImagePath("icon_ok.svg"));
288 $template->setVariable("TEXT_OK", $this->lng->txt("answer_is_right"));
289 $template->parseCurrentBlock();
290 }
291 else
292 {
293 $template->setCurrentBlock("icon_ok");
294 $template->setVariable("ICON_NOT_OK", ilUtil::getImagePath("icon_not_ok.svg"));
295 $template->setVariable("TEXT_NOT_OK", $this->lng->txt("answer_is_wrong"));
296 $template->parseCurrentBlock();
297 }
298 }
299 }
300 if (strlen($answer->getImage()))
301 {
302 $template->setCurrentBlock("answer_image");
303 if ($this->object->getThumbSize())
304 {
305 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
306 }
307 else
308 {
309 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
310 }
311 $alt = $answer->getImage();
312 if (strlen($answer->getAnswertext()))
313 {
314 $alt = $answer->getAnswertext();
315 }
316 $alt = preg_replace("/<[^>]*?>/", "", $alt);
317 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
318 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
319 $template->parseCurrentBlock();
320 }
321
322 if ($show_feedback)
323 {
324
325 if ($this->object->getSpecificFeedbackSetting() == 2)
326 {
327 foreach ($user_solution as $mc_solution)
328 {
329 if (strcmp($mc_solution, $answer_id) == 0)
330 {
331 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
332 $this->object->getId(), $answer_id
333 );
334 if (strlen($fb))
335 {
336 $template->setCurrentBlock("feedback");
337 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput( $fb, true ));
338 $template->parseCurrentBlock();
339 }
340 }
341 }
342 }
343
344 if ($this->object->getSpecificFeedbackSetting() == 1)
345 {
346 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
347 $this->object->getId(), $answer_id
348 );
349 if (strlen($fb))
350 {
351 $template->setCurrentBlock("feedback");
352 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput( $fb, true ));
353 $template->parseCurrentBlock();
354 }
355 }
356
357 if ($this->object->getSpecificFeedbackSetting() == 3)
358 {
359 $answer = $this->object->getAnswer($answer_id);
360
361 if ($answer->getPoints() > 0)
362 {
363 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation(
364 $this->object->getId(), $answer_id
365 );
366 if (strlen($fb))
367 {
368 $template->setCurrentBlock("feedback");
369 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput( $fb, true ));
370 $template->parseCurrentBlock();
371 }
372 }
373
374 }
375 }
376 $template->setCurrentBlock("answer_row");
377 $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), TRUE));
378 $checked = FALSE;
379 if ($result_output)
380 {
381 $pointschecked = $this->object->answers[$answer_id]->getPointsChecked();
382 $pointsunchecked = $this->object->answers[$answer_id]->getPointsUnchecked();
383 $resulttextchecked = ($pointschecked == 1) || ($pointschecked == -1) ? "%s " . $this->lng->txt("point") : "%s " . $this->lng->txt("points");
384 $resulttextunchecked = ($pointsunchecked == 1) || ($pointsunchecked == -1) ? "%s " . $this->lng->txt("point") : "%s " . $this->lng->txt("points");
385 $template->setVariable("RESULT_OUTPUT", sprintf("(" . $this->lng->txt("checkbox_checked") . " = $resulttextchecked, " . $this->lng->txt("checkbox_unchecked") . " = $resulttextunchecked)", $pointschecked, $pointsunchecked));
386 }
387 foreach ($user_solution as $mc_solution)
388 {
389 if (strcmp($mc_solution, $answer_id) == 0)
390 {
391 if( $this->renderPurposeSupportsFormHtml() || $this->isRenderPurposePrintPdf() )
392 {
393 $template->setVariable("SOLUTION_IMAGE", ilUtil::getHtmlPath(ilUtil::getImagePath("checkbox_checked.png")));
394 $template->setVariable("SOLUTION_ALT", $this->lng->txt("checked"));
395 }
396 else
397 {
398 $template->setVariable('QID', $this->object->getId());
399 $template->setVariable('SUFFIX', $show_correct_solution ? 'bestsolution' : 'usersolution');
400 $template->setVariable('SOLUTION_VALUE', $answer_id);
401 $template->setVariable('SOLUTION_CHECKED', 'checked');
402 }
403 $checked = TRUE;
404 }
405 }
406 if (!$checked)
407 {
408 if( $this->renderPurposeSupportsFormHtml() || $this->isRenderPurposePrintPdf() )
409 {
410 $template->setVariable("SOLUTION_IMAGE", ilUtil::getHtmlPath(ilUtil::getImagePath("checkbox_unchecked.png")));
411 $template->setVariable("SOLUTION_ALT", $this->lng->txt("unchecked"));
412 }
413 else
414 {
415 $template->setVariable('QID', $this->object->getId());
416 $template->setVariable('SUFFIX', $show_correct_solution ? 'bestsolution' : 'usersolution');
417 $template->setVariable('SOLUTION_VALUE', $answer_id);
418 }
419 }
420 $template->parseCurrentBlock();
421 }
422 $questiontext = $this->object->getQuestion();
423 if ($show_question_text==true)
424 {
425 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
426 }
427 $questionoutput = $template->get();
428 $feedback = ($show_feedback && !$this->isTestPresentationContext()) ? $this->getAnswerFeedbackOutput($active_id, $pass) : "";
429
430 if (strlen($feedback))
431 {
432 $cssClass = ( $this->hasCorrectSolution($active_id, $pass) ?
433 ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_CORRECT : ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_WRONG
434 );
435
436 $solutiontemplate->setVariable("ILC_FB_CSS_CLASS", $cssClass);
437 $solutiontemplate->setVariable("FEEDBACK", $this->object->prepareTextareaOutput( $feedback , true ));
438 }
439 $solutiontemplate->setVariable("SOLUTION_OUTPUT", $questionoutput);
440
441 $solutionoutput = $solutiontemplate->get();
442 if (!$show_question_only)
443 {
444 // get page object output
445 $solutionoutput = $this->getILIASPage($solutionoutput);
446 }
447 return $solutionoutput;
448 }
assQuestionGUI\hasCorrectSolution
hasCorrectSolution($activeId, $passIndex)
Definition: class.assQuestionGUI.php:2135
assQuestionGUI\getAnswerFeedbackOutput
getAnswerFeedbackOutput($active_id, $pass)
Returns the answer generic feedback depending on the results of the question.
Definition: class.assQuestionGUI.php:1317
ilUtil\getHtmlPath
static getHtmlPath($relative_path)
get url of path
Definition: class.ilUtil.php:148

References $ok, $pass, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_CORRECT, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_WRONG, assQuestionGUI\getAnswerFeedbackOutput(), getChoiceKeys(), ilUtil\getHtmlPath(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), assQuestionGUI\hasCorrectSolution(), assQuestionGUI\isRenderPurposePrintPdf(), assQuestionGUI\isTestPresentationContext(), ilUtil\prepareFormOutput(), assQuestionGUI\renderPurposeSupportsFormHtml(), and sprintf.

+ Here is the call graph for this function:

◆ getSpecificFeedbackOutput()

assMultipleChoiceGUI::getSpecificFeedbackOutput (   $active_id,
  $pass 
)

Returns the answer specific feedback for the question.

This method should be overwritten by the actual question.

Todo:
Mark this method abstract!
Parameters
integer$active_idActive ID of the user
integer$passActive pass
Returns
string HTML Code with the answer specific feedback @access public

Reimplemented from assQuestionGUI.

Definition at line 779 of file class.assMultipleChoiceGUI.php.

780 {
781 // No return value, this question type supports inline specific feedback.
782 $output = "";
783 return $this->object->prepareTextareaOutput($output, TRUE);
784 }
$output
if(!is_dir( $entity_dir)) exit("Fatal Error ([A-Za-z0-9]+)\s+" &#(? foreach( $entity_files as $file) $output
Definition: generate-entity-file.php:67

References $output.

◆ getTestOutput()

assMultipleChoiceGUI::getTestOutput (   $active_id,
  $pass,
  $is_postponed = FALSE,
  $use_post_solutions = FALSE,
  $show_feedback = FALSE 
)
Parameters
integer$active_id
integer | null$pass
bool$is_postponed
bool$use_post_solutions
bool$show_feedback
Returns
string

Reimplemented from assQuestionGUI.

Definition at line 553 of file class.assMultipleChoiceGUI.php.

562 {
563 // shuffle output
564 $keys = $this->getChoiceKeys();
565
566 // get the solution of the user for the active pass or from the last pass if allowed
567 $user_solution = array();
568 if ($active_id)
569 {
570 // hey: prevPassSolutions - obsolete due to central check
571 #$solutions = NULL;
572 #include_once "./Modules/Test/classes/class.ilObjTest.php";
573 #if (!ilObjTest::_getUsePreviousAnswers($active_id, true))
574 #{
575 # if (is_null($pass)) $pass = ilObjTest::_getPass($active_id);
576 #}
577 $solutions = $this->object->getTestOutputSolutions($active_id, $pass);
578 // hey.
579 foreach ($solutions as $idx => $solution_value)
580 {
581// fau: testNav - don't add the dummy entry for 'none of the above' to the user options
582 if ( $solution_value["value1"] != 'mc_none_above')
583 {
584 array_push($user_solution, $solution_value["value1"]);
585 }
586// fau.
587 }
588 }
589 // generate the question output
590 include_once "./Services/UICore/classes/class.ilTemplate.php";
591 $template = new ilTemplate("tpl.il_as_qpl_mc_mr_output.html", TRUE, TRUE, "Modules/TestQuestionPool");
592 foreach ($keys as $answer_id)
593 {
594 $answer = $this->object->answers[$answer_id];
595 if (strlen($answer->getImage()))
596 {
597 if ($this->object->getThumbSize())
598 {
599 $template->setCurrentBlock("preview");
600 $template->setVariable("URL_PREVIEW", $this->object->getImagePathWeb() . $answer->getImage());
601 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
602 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
603 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
604 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
605 $alt = $answer->getImage();
606 if (strlen($answer->getAnswertext()))
607 {
608 $alt = $answer->getAnswertext();
609 }
610 $alt = preg_replace("/<[^>]*?>/", "", $alt);
611 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
612 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
613 $template->parseCurrentBlock();
614 }
615 else
616 {
617 $template->setCurrentBlock("answer_image");
618 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
619 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
620 $alt = $answer->getImage();
621 if (strlen($answer->getAnswertext()))
622 {
623 $alt = $answer->getAnswertext();
624 }
625 $alt = preg_replace("/<[^>]*?>/", "", $alt);
626 $template->setVariable("ATTR", $attr);
627 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
628 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
629 $template->parseCurrentBlock();
630 }
631 }
632
633 if( $show_feedback )
634 {
635 $this->populateSpecificFeedbackInline($user_solution, $answer_id, $template);
636 }
637
638 $template->setCurrentBlock("answer_row");
639 $template->setVariable("QID", $this->object->getId());
640 $template->setVariable("ANSWER_ID", $answer_id);
641 $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), TRUE));
642 foreach ($user_solution as $mc_solution)
643 {
644 if (strcmp($mc_solution, $answer_id) == 0)
645 {
646 $template->setVariable("CHECKED_ANSWER", " checked=\"checked\"");
647 }
648 }
649 $template->parseCurrentBlock();
650 }
651
652// fau: testNav - add 'none of the above', if needed by the deprecated test setting to score empty answers
653 if ($this->withNoneAbove)
654 {
655 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/ilAssMultipleChoice.js');
656 $template->setCurrentBlock('none_above');
657 $template->setVariable('LABEL_NONE_ABOVE', $this->lng->txt('tst_mc_label_none_above'));
658 if ($this->isAnswered && empty($user_solution))
659 {
660 $template->setVariable('CHECKED_NONE_ABOVE', " checked=\"checked\"");
661 }
662 $template->parseCurrentBlock();
663 }
664// fau.
665
666 $questiontext = $this->object->getQuestion();
667 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, TRUE));
668 $template->setVariable("QUESTION_ID", $this->object->getId());
669 if($this->object->getSelectionLimit())
670 {
671 $template->setVariable('SELECTION_LIMIT_HINT', sprintf(
672 $this->lng->txt('ass_mc_sel_lim_hint'),
673 $this->object->getSelectionLimit(),
674 $this->object->getAnswerCount()
675 ));
676
677 $template->setVariable('SELECTION_LIMIT_VALUE', $this->object->getSelectionLimit());
678 }
679 else
680 {
681 $template->setVariable('SELECTION_LIMIT_VALUE', 'null');
682 }
683 $questionoutput = $template->get();
684 $pageoutput = $this->outQuestionPage("", $is_postponed, $active_id, $questionoutput);
685 return $pageoutput;
686 }
assQuestionGUI\outQuestionPage
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="")
output question page
Definition: class.assQuestionGUI.php:528

References $pass, getChoiceKeys(), ilUtil\getImagePath(), assQuestionGUI\outQuestionPage(), populateSpecificFeedbackInline(), ilUtil\prepareFormOutput(), and sprintf.

+ Here is the call graph for this function:

◆ populateAnswerSpecificFormPart()

assMultipleChoiceGUI::populateAnswerSpecificFormPart ( \ilPropertyFormGUI  $form)

Definition at line 918 of file class.assMultipleChoiceGUI.php.

919 {
920 // Choices
921 include_once "./Modules/TestQuestionPool/classes/class.ilMultipleChoiceWizardInputGUI.php";
922 $choices = new ilMultipleChoiceWizardInputGUI($this->lng->txt( "answers" ), "choice");
923 $choices->setRequired( true );
924 $choices->setQuestionObject( $this->object );
925 $isSingleline = $this->getEditAnswersSingleLine();
926 $choices->setSingleline( $isSingleline );
927 $choices->setAllowMove( false );
928 if ($this->object->getSelfAssessmentEditingMode())
929 {
930 $choices->setSize( 40 );
931 }
932 $choices->setMaxLength( 800 );
933 if ($this->object->getAnswerCount() == 0)
934 $this->object->addAnswer( "", 0, 0, 0 );
935 $choices->setValues( $this->object->getAnswers() );
936 $form->addItem( $choices );
937 }
ilMultipleChoiceWizardInputGUI
This class represents a multiple choice wizard property in a property form.
Definition: class.ilMultipleChoiceWizardInputGUI.php:14

References ilPropertyFormGUI\addItem(), and getEditAnswersSingleLine().

Referenced by buildEditForm().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateJavascriptFilesRequiredForWorkForm()

assMultipleChoiceGUI::populateJavascriptFilesRequiredForWorkForm ( ilTemplate  $tpl)

Reimplemented from assQuestionGUI.

Definition at line 688 of file class.assMultipleChoiceGUI.php.

689 {
690 $tpl->addJavaScript('Modules/TestQuestionPool/js/ilAssMultipleChoice.js');
691 }

References assQuestionGUI\$tpl.

◆ populateQuestionSpecificFormPart()

assMultipleChoiceGUI::populateQuestionSpecificFormPart ( \ilPropertyFormGUI  $form)

Definition at line 856 of file class.assMultipleChoiceGUI.php.

857 {
858 // shuffle
859 $shuffle = new ilCheckboxInputGUI($this->lng->txt( "shuffle_answers" ), "shuffle");
860 $shuffle->setValue( 1 );
861 $shuffle->setChecked( $this->object->getShuffle() );
862 $shuffle->setRequired( FALSE );
863 $form->addItem( $shuffle );
864
865 require_once 'Services/Form/classes/class.ilNumberInputGUI.php';
866 $selLim = new ilNumberInputGUI($this->lng->txt('ass_mc_sel_lim_setting'), 'selection_limit');
867 $selLim->setInfo($this->lng->txt('ass_mc_sel_lim_setting_desc'));
868 $selLim->setSize(2);
869 $selLim->setRequired(false);
870 $selLim->allowDecimals(false);
871 $selLim->setMinvalueShouldBeGreater(false);
872 $selLim->setMaxvalueShouldBeLess(false);
873 $selLim->setMinValue(1);
874 $selLim->setMaxValue($this->object->getAnswerCount());
875 $selLim->setValue($this->object->getSelectionLimit());
876 $form->addItem($selLim);
877
878 if ($this->object->getId())
879 {
880 $hidden = new ilHiddenInputGUI("", "ID");
881 $hidden->setValue( $this->object->getId() );
882 $form->addItem( $hidden );
883 }
884
885 $isSingleline = $this->getEditAnswersSingleLine();
886
887 if (!$this->object->getSelfAssessmentEditingMode())
888 {
889 // Answer types
890 $types = new ilSelectInputGUI($this->lng->txt( "answer_types" ), "types");
891 $types->setRequired( false );
892 $types->setValue( ($isSingleline) ? 0 : 1 );
893 $types->setOptions( array(
894 0 => $this->lng->txt( 'answers_singleline' ),
895 1 => $this->lng->txt( 'answers_multiline' ),
896 )
897 );
898 $form->addItem( $types );
899 }
900
901 if ($isSingleline)
902 {
903 // thumb size
904 $thumb_size = new ilNumberInputGUI($this->lng->txt( "thumb_size" ), "thumb_size");
905 $thumb_size->setSuffix($this->lng->txt("thumb_size_unit_pixel"));
906 $thumb_size->setMinValue( 20 );
907 $thumb_size->setDecimals( 0 );
908 $thumb_size->setSize( 6 );
909 $thumb_size->setInfo( $this->lng->txt( 'thumb_size_info' ) );
910 $thumb_size->setValue( $this->object->getThumbSize() );
911 $thumb_size->setRequired( false );
912 $form->addItem( $thumb_size );
913 return $isSingleline;
914 }
915 return $isSingleline;
916 }
ilCheckboxInputGUI
This class represents a checkbox property in a property form.
Definition: class.ilCheckboxInputGUI.php:34
ilHiddenInputGUI
This class represents a hidden form property in a property form.
Definition: class.ilHiddenInputGUI.php:32
ilNumberInputGUI
This class represents a number property in a property form.
Definition: class.ilNumberInputGUI.php:15
ilSelectInputGUI
This class represents a selection list property in a property form.
Definition: class.ilSelectInputGUI.php:18

References ilPropertyFormGUI\addItem(), and getEditAnswersSingleLine().

Referenced by buildEditForm().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ populateSpecificFeedbackInline()

assMultipleChoiceGUI::populateSpecificFeedbackInline (   $user_solution,
  $answer_id,
  $template 
)
private
Parameters
$user_solution
$answer_id
$template
Returns
array

Definition at line 1039 of file class.assMultipleChoiceGUI.php.

1040 {
1041 if($this->object->getSpecificFeedbackSetting() == 2)
1042 {
1043 foreach($user_solution as $mc_solution)
1044 {
1045 if(strcmp($mc_solution, $answer_id) == 0)
1046 {
1047 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), $answer_id);
1048 if(strlen($fb))
1049 {
1050 $template->setCurrentBlock("feedback");
1051 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
1052 $template->parseCurrentBlock();
1053 }
1054 }
1055 }
1056 }
1057
1058 if($this->object->getSpecificFeedbackSetting() == 1)
1059 {
1060 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), $answer_id);
1061 if(strlen($fb))
1062 {
1063 $template->setCurrentBlock("feedback");
1064 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
1065 $template->parseCurrentBlock();
1066 }
1067 }
1068
1069 if($this->object->getSpecificFeedbackSetting() == 3)
1070 {
1071 $answer = $this->object->getAnswer($answer_id);
1072
1073 if($answer->getPoints() > 0)
1074 {
1075 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), $answer_id);
1076 if(strlen($fb))
1077 {
1078 $template->setCurrentBlock("feedback");
1079 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
1080 $template->parseCurrentBlock();
1081 }
1082 }
1083 }
1084 }

Referenced by getPreview(), and getTestOutput().

+ Here is the caller graph for this function:

◆ removechoice()

assMultipleChoiceGUI::removechoice ( )

Remove an answer.

Definition at line 176 of file class.assMultipleChoiceGUI.php.

177 {
178 $this->writePostData(true);
179 $position = key($_POST['cmd']['removechoice']);
180 $this->object->deleteAnswer($position);
181 $this->editQuestion();
182 }

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

+ Here is the call graph for this function:

◆ removeimagechoice()

assMultipleChoiceGUI::removeimagechoice ( )

Remove an image.

Definition at line 153 of file class.assMultipleChoiceGUI.php.

154 {
155 $this->writePostData(true);
156 $position = key($_POST['cmd']['removeimagechoice']);
157 $filename = $_POST['choice']['imagename'][$position];
158 $this->object->removeAnswerImage($position);
159 $this->editQuestion();
160 }

References $_POST, $filename, editQuestion(), and writePostData().

+ Here is the call graph for this function:

◆ renderAggregateView()

assMultipleChoiceGUI::renderAggregateView (   $aggregate)
Parameters
$aggregate
Returns
ilTemplate

Definition at line 1011 of file class.assMultipleChoiceGUI.php.

1012 {
1013 $tpl = new ilTemplate('tpl.il_as_aggregated_answers_table.html', true, true, "Modules/TestQuestionPool");
1014
1015 $tpl->setCurrentBlock('headercell');
1016 $tpl->setVariable('HEADER', $this->lng->txt('tst_answer_aggr_answer_header'));
1017 $tpl->parseCurrentBlock();
1018
1019 $tpl->setCurrentBlock('headercell');
1020 $tpl->setVariable('HEADER', $this->lng->txt('tst_answer_aggr_frequency_header'));
1021 $tpl->parseCurrentBlock();
1022
1023 foreach ($aggregate as $line_data)
1024 {
1025 $tpl->setCurrentBlock( 'aggregaterow' );
1026 $tpl->setVariable( 'OPTION', $line_data['answertext'] );
1027 $tpl->setVariable( 'COUNT', $line_data['count_checked'] );
1028 $tpl->parseCurrentBlock();
1029 }
1030 return $tpl;
1031 }

References assQuestionGUI\$tpl.

Referenced by getAggregatedAnswersView().

+ Here is the caller graph for this function:

◆ setIsAnswered()

assMultipleChoiceGUI::setIsAnswered (   $a_is_answered)

Show the question as answered in a test run.

Parameters
bool

Definition at line 1101 of file class.assMultipleChoiceGUI.php.

1102 {
1103 $this->isAnswered = (bool) $a_is_answered;
1104 }

◆ setQuestionTabs()

assMultipleChoiceGUI::setQuestionTabs ( )

Sets the ILIAS tabs for this question type.

Todo:
: MOVE THIS STEPS TO COMMON QUESTION CLASS assQuestionGUI

Reimplemented from assQuestionGUI.

Definition at line 698 of file class.assMultipleChoiceGUI.php.

699 {
700 global $rbacsystem, $ilTabs;
701
702 $ilTabs->clearTargets();
703
704 $this->ctrl->setParameterByClass("ilAssQuestionPageGUI", "q_id", $_GET["q_id"]);
705 include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
706 $q_type = $this->object->getQuestionType();
707
708 if (strlen($q_type))
709 {
710 $classname = $q_type . "GUI";
711 $this->ctrl->setParameterByClass(strtolower($classname), "sel_question_types", $q_type);
712 $this->ctrl->setParameterByClass(strtolower($classname), "q_id", $_GET["q_id"]);
713 }
714
715 if ($_GET["q_id"])
716 {
717 if ($rbacsystem->checkAccess('write', $_GET["ref_id"]))
718 {
719 // edit page
720 $ilTabs->addTarget("edit_page",
721 $this->ctrl->getLinkTargetByClass("ilAssQuestionPageGUI", "edit"),
722 array("edit", "insert", "exec_pg"),
723 "", "", $force_active);
724 }
725
726 $this->addTab_QuestionPreview($ilTabs);
727 }
728 $force_active = false;
729 if ($rbacsystem->checkAccess('write', $_GET["ref_id"]))
730 {
731 $url = "";
732 if ($classname) $url = $this->ctrl->getLinkTargetByClass($classname, "editQuestion");
733 $force_active = false;
734 // edit question properties
735 $ilTabs->addTarget("edit_question",
736 $url,
737 array("editQuestion", "save", "saveEdit", "addchoice", "removechoice", "removeimagechoice", "uploadchoice", "originalSyncForm"),
738 $classname, "", $force_active);
739 }
740
741 // add tab for question feedback within common class assQuestionGUI
742 $this->addTab_QuestionFeedback($ilTabs);
743
744 // add tab for question hint within common class assQuestionGUI
745 $this->addTab_QuestionHints($ilTabs);
746
747 // add tab for question's suggested solution within common class assQuestionGUI
748 $this->addTab_SuggestedSolution($ilTabs, $classname);
749
750 // Assessment of questions sub menu entry
751 if ($_GET["q_id"])
752 {
753 $ilTabs->addTarget("statistics",
754 $this->ctrl->getLinkTargetByClass($classname, "assessment"),
755 array("assessment"),
756 $classname, "");
757 }
758
759 $this->addBackTab($ilTabs);
760 }
$_GET
$_GET["client_id"]
Definition: cfg.phpunit.template.php:12
assQuestionGUI\addTab_QuestionHints
addTab_QuestionHints(ilTabsGUI $tabs)
adds the hints tab to ilTabsGUI
Definition: class.assQuestionGUI.php:2082
assQuestionGUI\addTab_SuggestedSolution
addTab_SuggestedSolution(ilTabsGUI $tabs, $classname)
Definition: class.assQuestionGUI.php:2015
assQuestionGUI\addBackTab
addBackTab(ilTabsGUI $ilTabs)
Definition: class.assQuestionGUI.php:2232
assQuestionGUI\addTab_QuestionFeedback
addTab_QuestionFeedback(ilTabsGUI $tabs)
adds the feedback tab to ilTabsGUI
Definition: class.assQuestionGUI.php:2051
assQuestionGUI\addTab_QuestionPreview
addTab_QuestionPreview(ilTabsGUI $tabsGUI)
Definition: class.assQuestionGUI.php:2111
$url
$url
Definition: shib_logout.php:72

References $_GET, $url, assQuestionGUI\addBackTab(), assQuestionGUI\addTab_QuestionFeedback(), assQuestionGUI\addTab_QuestionHints(), assQuestionGUI\addTab_QuestionPreview(), and assQuestionGUI\addTab_SuggestedSolution().

+ Here is the call graph for this function:

◆ setWithNoneAbove()

assMultipleChoiceGUI::setWithNoneAbove (   $a_with_none_above)

Enable the 'None above' addition in a test run.

Parameters
bool

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

1093 {
1094 $this->withNoneAbove = (bool) $a_with_none_above;
1095 }

◆ uploadchoice()

assMultipleChoiceGUI::uploadchoice ( )

Upload an image.

Definition at line 143 of file class.assMultipleChoiceGUI.php.

144 {
145 $this->writePostData(true);
146 $position = key($_POST['cmd']['uploadchoice']);
147 $this->editQuestion();
148 }

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

+ Here is the call graph for this function:

◆ writeAnswerSpecificPostData()

assMultipleChoiceGUI::writeAnswerSpecificPostData ( ilPropertyFormGUI  $form)

Extracts the answer specific values from $_POST and applies them to the data object.

Parameters
bool$alwaysIf true, a check for form validity is omitted.
Returns
void

Implements ilGuiAnswerScoringAdjustable.

Definition at line 806 of file class.assMultipleChoiceGUI.php.

807 {
808 // Delete all existing answers and create new answers from the form data
809 $this->object->flushAnswers();
810 if ($this->object->isSingleline)
811 {
812 foreach ($_POST['choice']['answer'] as $index => $answertext)
813 {
814 $answertext = ilUtil::secureString($answertext);
815
816 $picturefile = $_POST['choice']['imagename'][$index];
817 $file_org_name = $_FILES['choice']['name']['image'][$index];
818 $file_temp_name = $_FILES['choice']['tmp_name']['image'][$index];
819
820 if (strlen( $file_temp_name ))
821 {
822 // check suffix
823 $suffix = strtolower( array_pop( explode( ".", $file_org_name ) ) );
824 if (in_array( $suffix, array( "jpg", "jpeg", "png", "gif" ) ))
825 {
826 // upload image
827 $filename = $this->object->buildHashedImageFilename( $file_org_name );
828 if ($this->object->setImageFile( $filename, $file_temp_name ) == 0)
829 {
830 $picturefile = $filename;
831 }
832 }
833 }
834 $this->object->addAnswer( $answertext,
835 $_POST['choice']['points'][$index],
836 $_POST['choice']['points_unchecked'][$index],
837 $index,
838 $picturefile
839 );
840 }
841 }
842 else
843 {
844 foreach ($_POST['choice']['answer'] as $index => $answer)
845 {
846 $answertext = $answer;
847 $this->object->addAnswer( $answertext,
848 $_POST['choice']['points'][$index],
849 $_POST['choice']['points_unchecked'][$index],
850 $index
851 );
852 }
853 }
854 }
ilUtil\secureString
static secureString($a_str, $a_strip_html=true, $a_allow="")
Remove unsecure tags.
Definition: class.ilUtil.php:2673

References $_POST, $filename, and ilUtil\secureString().

Referenced by writePostData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ writePostData()

assMultipleChoiceGUI::writePostData (   $always = false)
protected

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

Reimplemented from assQuestionGUI.

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

50 {
51 $hasErrors = (!$always) ? $this->editQuestion(true) : false;
52 if (!$hasErrors)
53 {
54 $form = $this->buildEditForm();
55 $form->setValuesByPost();
56 require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
57 $this->writeQuestionGenericPostData();
58 $this->writeQuestionSpecificPostData($form);
59 $this->writeAnswerSpecificPostData($form);
60 $this->saveTaxonomyAssignments();
61 return 0;
62 }
63 return 1;
64 }
assMultipleChoiceGUI\writeAnswerSpecificPostData
writeAnswerSpecificPostData(ilPropertyFormGUI $form)
Extracts the answer specific values from $_POST and applies them to the data object.
Definition: class.assMultipleChoiceGUI.php:806
assMultipleChoiceGUI\writeQuestionSpecificPostData
writeQuestionSpecificPostData(ilPropertyFormGUI $form)
Extracts the question specific values from $_POST and applies them to the data object.
Definition: class.assMultipleChoiceGUI.php:786

References buildEditForm(), editQuestion(), assQuestionGUI\saveTaxonomyAssignments(), writeAnswerSpecificPostData(), assQuestionGUI\writeQuestionGenericPostData(), and writeQuestionSpecificPostData().

Referenced by addchoice(), removechoice(), removeimagechoice(), and uploadchoice().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ writeQuestionSpecificPostData()

assMultipleChoiceGUI::writeQuestionSpecificPostData ( ilPropertyFormGUI  $form)

Extracts the question specific values from $_POST and applies them to the data object.

Parameters
bool$alwaysIf true, a check for form validity is omitted.
Returns
void

Implements ilGuiQuestionScoringAdjustable.

Definition at line 786 of file class.assMultipleChoiceGUI.php.

787 {
788 $this->object->setShuffle( $_POST["shuffle"] );
789
790 $selectionLimit = (int)$form->getItemByPostVar('selection_limit')->getValue();
791 $this->object->setSelectionLimit($selectionLimit > 0 ? $selectionLimit : null);
792
793 $this->object->setMultilineAnswerSetting( $_POST["types"] );
794 if (is_array( $_POST['choice']['imagename'] ) && $_POST["types"] == 1)
795 {
796 $this->object->isSingleline = true;
797 ilUtil::sendInfo( $this->lng->txt( 'info_answer_type_change' ), true );
798 }
799 else
800 {
801 $this->object->isSingleline = ($_POST["types"] == 0) ? true : false;
802 }
803 $this->object->setThumbSize( (strlen( $_POST["thumb_size"] )) ? $_POST["thumb_size"] : "" );
804 }
ilPropertyFormGUI\getItemByPostVar
getItemByPostVar($a_post_var)
Get Item by POST variable.
Definition: class.ilPropertyFormGUI.php:275
ilUtil\sendInfo
static sendInfo($a_info="", $a_keep=false)
Send Info Message to Screen.
Definition: class.ilUtil.php:4757

References $_POST, ilPropertyFormGUI\getItemByPostVar(), and ilUtil\sendInfo().

Referenced by writePostData().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Field Documentation

◆ $choiceKeys

assMultipleChoiceGUI::$choiceKeys

Definition at line 25 of file class.assMultipleChoiceGUI.php.

Referenced by getChoiceKeys().

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