ILIAS  release_6 Revision v6.24-5-g0c8bfefb3b8
assMultipleChoiceGUI Class Reference

Multiple choice question GUI representation. More...

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

Public Member Functions

 __construct ($id=-1)
 assMultipleChoiceGUI constructor More...
 
 hasInlineFeedback ()
 
 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...
 
 supportsIntermediateSolutionOutput ()
 Question type specific support of intermediate solution output The function getSolutionOutput respects getUseIntermediateSolution() 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)
 
 isUseEmptySolutionInputChecked ()
 
 setUseEmptySolutionInputChecked ($useEmptySolutionInputChecked)
 
 getPresentationJavascripts ()
 
 setQuestionTabs ()
 Sets the ILIAS tabs for this question type. More...
 
 getChoiceKeys ()
 Create the key index numbers for the array of choices. More...
 
 getSpecificFeedbackOutput ($userSolution)
 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)
 
 getAnswersFrequency ($relevantAnswers, $questionIndex)
 
 populateCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 saveCorrectionsFormProperties (ilPropertyFormGUI $form)
 
- Public Member Functions inherited from assQuestionGUI
 __construct ()
 assQuestionGUI constructor More...
 
 hasInlineFeedback ()
 this method can be overwritten per question type More...
 
 addHeaderAction ()
 
 redrawHeaderAction ()
 
 getHeaderAction ()
 
 getNotesHTML ()
 
 executeCommand ()
 execute command More...
 
 getCommand ($cmd)
 
 getType ()
 needed for page editor compliance More...
 
 getPresentationContext ()
 
 setPresentationContext ($presentationContext)
 
 isTestPresentationContext ()
 
 isPreviousSolutionPrefilled ()
 
 setPreviousSolutionPrefilled ($previousSolutionPrefilled)
 
 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 (ilGlobalTemplateInterface $tpl)
 
 getPresentationJavascripts ()
 
 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="", $inlineFeedbackEnabled=false)
 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 ($userSolution)
 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)
 
 supportsIntermediateSolutionOutput ()
 Question type specific support of intermediate solution output The function getSolutionOutput respects getUseIntermediateSolution() More...
 
 hasIntermediateSolution ($activeId, $passIndex)
 Check if the question has an intermediate solution. More...
 
 setUseIntermediateSolution ($use)
 
 getUseIntermediateSolution ()
 Get if intermediate solution should be used for solution output. More...
 
 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 ()
 
 buildFocusAnchorHtml ()
 
 isAnswerFreuqencyStatisticSupported ()
 
 getSubQuestionsIndex ()
 
 getAnswersFrequency ($relevantAnswers, $questionIndex)
 
 getAnswerFrequencyTableGUI ($parentGui, $parentCmd, $relevantAnswers, $questionIndex)
 
 prepareReprintableCorrectionsForm (ilPropertyFormGUI $form)
 
 populateCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 saveCorrectionsFormProperties (ilPropertyFormGUI $form)
 
- 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...
 
 getUseUnchangedAnswerCheckboxHtml ()
 
 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)
 
 getUseUnchangedAnswerCheckboxHtml ()
 
 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 ()
 

Protected Attributes

 $useEmptySolutionInputChecked = false
 
- Protected Attributes inherited from assQuestionGUI
 $editForm
 
 $use_intermediate_solution = false
 

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...
 

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 {
38 include_once "./Modules/TestQuestionPool/classes/class.assMultipleChoice.php";
39 $this->object = new assMultipleChoice();
40 if ($id >= 0) {
41 $this->object->loadFromDb($id);
42 }
43 }
Class for multiple choice tests.
__construct(Container $dic, ilPlugin $plugin)
@inheritDoc

References ILIAS\GlobalScreen\Provider\__construct().

+ Here is the call graph for this function:

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 136 of file class.assMultipleChoiceGUI.php.

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

Referenced by buildEditForm().

+ Here is the caller graph for this function:

◆ addchoice()

assMultipleChoiceGUI::addchoice ( )

Add a new answer.

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

168 {
169 $this->writePostData(true);
170 $position = key($_POST['cmd']['addchoice']);
171 $this->object->addAnswer("", 0, 0, $position + 1);
172 $this->editQuestion();
173 }
$_POST["username"]
editQuestion($checkonly=false)
Creates an output of the edit form for the question.
writePostData($always=false)
{Evaluates a posted edit form and writes the form data in the question object.integer A positive valu...

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 949 of file class.assMultipleChoiceGUI.php.

950 {
951 $aggregate = array();
952 foreach ($answers_defined_on_question as $answer) {
953 $aggregated_info_for_answer = array();
954 $aggregated_info_for_answer['answertext'] = $answer->getAnswerText();
955 $aggregated_info_for_answer['count_checked'] = 0;
956
957 foreach ($relevant_answers_chosen as $relevant_answer) {
958 if ($relevant_answer['value1'] == $answer->getOrder()) {
959 $aggregated_info_for_answer['count_checked']++;
960 }
961 }
962 $aggregated_info_for_answer['count_unchecked'] =
963 ceil(count($relevant_answers_chosen) / count($answers_defined_on_question))
964 - $aggregated_info_for_answer['count_checked'];
965
966 $aggregate[] = $aggregated_info_for_answer;
967 }
968 return $aggregate;
969 }

Referenced by getAggregatedAnswersView(), and getAnswersFrequency().

+ Here is the caller graph for this function:

◆ buildEditForm()

assMultipleChoiceGUI::buildEditForm ( )
protected
Returns
ilPropertyFormGUI

Reimplemented from assQuestionGUI.

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

1049 {
1050 include_once("./Services/Form/classes/class.ilPropertyFormGUI.php");
1051 $form = new ilPropertyFormGUI();
1052 $form->setFormAction($this->ctrl->getFormAction($this));
1053 $form->setTitle($this->outQuestionType());
1054 $form->setTableWidth("100%");
1055 $form->setId("assmultiplechoice");
1056
1057 // title, author, description, question, working time (assessment mode)
1058 $this->addBasicQuestionFormProperties($form);
1060 $this->populateAnswerSpecificFormPart($form);
1061 $this->populateTaxonomyFormSection($form);
1062 $this->addQuestionFormCommandButtons($form);
1063 return $form;
1064 }
addBasicQuestionFormProperties($form)
Add basic question form properties: assessment: title, author, description, question,...
populateQuestionSpecificFormPart(\ilPropertyFormGUI $form)
populateAnswerSpecificFormPart(\ilPropertyFormGUI $form)
populateTaxonomyFormSection(ilPropertyFormGUI $form)
addQuestionFormCommandButtons($form)
Add the command buttons of a question properties form.
This class represents a property form user interface.

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 103 of file class.assMultipleChoiceGUI.php.

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

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 915 of file class.assMultipleChoiceGUI.php.

916 {
917 return array();
918 }

◆ 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 929 of file class.assMultipleChoiceGUI.php.

930 {
931 return array();
932 }

◆ 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 942 of file class.assMultipleChoiceGUI.php.

943 {
944 return $this->renderAggregateView(
945 $this->aggregateAnswers($relevant_answers, $this->object->getAnswers())
946 )->get();
947 }
aggregateAnswers($relevant_answers_chosen, $answers_defined_on_question)

References aggregateAnswers(), and renderAggregateView().

+ Here is the call graph for this function:

◆ getAnswersFrequency()

assMultipleChoiceGUI::getAnswersFrequency (   $relevantAnswers,
  $questionIndex 
)

Reimplemented from assQuestionGUI.

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

1067 {
1068 $agg = $this->aggregateAnswers($relevantAnswers, $this->object->getAnswers());
1069
1070 $answers = array();
1071
1072 foreach ($agg as $ans) {
1073 $answers[] = array(
1074 'answer' => $ans['answertext'],
1075 'frequency' => $ans['count_checked']
1076 );
1077 }
1078
1079 return $answers;
1080 }

References aggregateAnswers().

+ 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 744 of file class.assMultipleChoiceGUI.php.

745 {
746 $choiceKeys = array_keys($this->object->answers);
747
748 if ($this->object->getShuffle()) {
749 $choiceKeys = $this->object->getShuffler()->shuffle($choiceKeys);
750 }
751
752 return $choiceKeys;
753 }

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 79 of file class.assMultipleChoiceGUI.php.

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

References $_POST.

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

+ Here is the caller graph for this function:

◆ getPresentationJavascripts()

assMultipleChoiceGUI::getPresentationJavascripts ( )

Reimplemented from assQuestionGUI.

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

656 {
657 return array('Modules/TestQuestionPool/js/ilAssMultipleChoice.js');
658 }

◆ getPreview()

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

Reimplemented from assQuestionGUI.

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

420 {
421 $user_solution = is_object($this->getPreviewSession()) ? (array) $this->getPreviewSession()->getParticipantsSolution() : array();
422 // shuffle output
423 $keys = $this->getChoiceKeys();
424
425 // generate the question output
426 include_once "./Services/UICore/classes/class.ilTemplate.php";
427 $template = new ilTemplate("tpl.il_as_qpl_mc_mr_output.html", true, true, "Modules/TestQuestionPool");
428 foreach ($keys as $answer_id) {
429 $answer = $this->object->answers[$answer_id];
430 if (strlen($answer->getImage())) {
431 if ($this->object->getThumbSize()) {
432 $template->setCurrentBlock("preview");
433 $template->setVariable("URL_PREVIEW", $this->object->getImagePathWeb() . $answer->getImage());
434 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
435 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
436 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
437 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
438 $alt = $answer->getImage();
439 if (strlen($answer->getAnswertext())) {
440 $alt = $answer->getAnswertext();
441 }
442 $alt = preg_replace("/<[^>]*?>/", "", $alt);
443 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
444 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
445 $template->parseCurrentBlock();
446 } else {
447 $template->setCurrentBlock("answer_image");
448 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
449 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
450 $alt = $answer->getImage();
451 if (strlen($answer->getAnswertext())) {
452 $alt = $answer->getAnswertext();
453 }
454 $alt = preg_replace("/<[^>]*?>/", "", $alt);
455 $template->setVariable("ATTR", $attr);
456 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
457 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
458 $template->parseCurrentBlock();
459 }
460 }
461
462 if ($showInlineFeedback) {
463 $this->populateSpecificFeedbackInline($user_solution, $answer_id, $template);
464 }
465
466 $template->setCurrentBlock("answer_row");
467 $template->setVariable("QID", $this->object->getId());
468 $template->setVariable("ANSWER_ID", $answer_id);
469 $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), true));
470 foreach ($user_solution as $mc_solution) {
471 if (strcmp($mc_solution, $answer_id) == 0) {
472 $template->setVariable("CHECKED_ANSWER", " checked=\"checked\"");
473 }
474 }
475 $template->parseCurrentBlock();
476 }
477 if ($this->object->getSelectionLimit()) {
478 $template->setVariable('SELECTION_LIMIT_HINT', sprintf(
479 $this->lng->txt('ass_mc_sel_lim_hint'),
480 $this->object->getSelectionLimit(),
481 $this->object->getAnswerCount()
482 ));
483
484 $template->setVariable('SELECTION_LIMIT_VALUE', $this->object->getSelectionLimit());
485 } else {
486 $template->setVariable('SELECTION_LIMIT_VALUE', 'null');
487 }
488 $template->setVariable("QUESTION_ID", $this->object->getId());
489 $questiontext = $this->object->getQuestion();
490 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, true));
491 $questionoutput = $template->get();
492 if (!$show_question_only) {
493 // get page object output
494 $questionoutput = $this->getILIASPage($questionoutput);
495 }
496 return $questionoutput;
497 }
getChoiceKeys()
Create the key index numbers for the array of choices.
populateSpecificFeedbackInline($user_solution, $answer_id, $template)
getILIASPage($html="")
Returns the ILIAS Page around a question.
special template class to simplify handling of ITX/PEAR
static getImagePath($img, $module_path="", $mode="output", $offline=false)
get image path (for images located in a template directory)
static prepareFormOutput($a_str, $a_strip=false)
prepares string output for html forms @access public
$keys
Definition: metadata.php:187
$type

References $keys, $type, getChoiceKeys(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), assQuestionGUI\getPreviewSession(), populateSpecificFeedbackInline(), and ilUtil\prepareFormOutput().

+ 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 211 of file class.assMultipleChoiceGUI.php.

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

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

+ Here is the call graph for this function:

◆ getSpecificFeedbackOutput()

assMultipleChoiceGUI::getSpecificFeedbackOutput (   $userSolution)

Returns the answer specific feedback for the question.

This method should be overwritten by the actual question.

Todo:
Mark this method abstract!
Parameters
array$userSolution($userSolution[<value1>] = <value2>)
Returns
string HTML Code with the answer specific feedback @access public

Reimplemented from assQuestionGUI.

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

756 {
757 // No return value, this question type supports inline specific feedback.
758 $output = "";
759 return $this->object->prepareTextareaOutput($output, true);
760 }

◆ 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 508 of file class.assMultipleChoiceGUI.php.

516 {
517 // shuffle output
518 $keys = $this->getChoiceKeys();
519
520 // get the solution of the user for the active pass or from the last pass if allowed
521 $user_solution = array();
522 if ($active_id) {
523 // hey: prevPassSolutions - obsolete due to central check
524 #$solutions = NULL;
525 #include_once "./Modules/Test/classes/class.ilObjTest.php";
526 #if (!ilObjTest::_getUsePreviousAnswers($active_id, true))
527 #{
528 # if (is_null($pass)) $pass = ilObjTest::_getPass($active_id);
529 #}
530 $solutions = $this->object->getTestOutputSolutions($active_id, $pass);
531 // hey.
532 foreach ($solutions as $idx => $solution_value) {
533 // fau: testNav - don't add the dummy entry for 'none of the above' to the user options
534 if ($solution_value["value1"] == 'mc_none_above') {
536 continue;
537 }
538
539 $user_solution[] = $solution_value["value1"];
540 // fau.
541 }
542
543 if (empty($user_solution) && $this->object->getTestPresentationConfig()->isWorkedThrough()) {
545 }
546 }
547 // generate the question output
548 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/ilAssMultipleChoice.js');
549 include_once "./Services/UICore/classes/class.ilTemplate.php";
550 $template = new ilTemplate("tpl.il_as_qpl_mc_mr_output.html", true, true, "Modules/TestQuestionPool");
551 foreach ($keys as $answer_id) {
552 $answer = $this->object->answers[$answer_id];
553 if (strlen($answer->getImage())) {
554 if ($this->object->getThumbSize()) {
555 $template->setCurrentBlock("preview");
556 $template->setVariable("URL_PREVIEW", $this->object->getImagePathWeb() . $answer->getImage());
557 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
558 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('enlarge.svg'));
559 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $this->object->getThumbPrefix() . $answer->getImage());
560 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
561 $alt = $answer->getImage();
562 if (strlen($answer->getAnswertext())) {
563 $alt = $answer->getAnswertext();
564 }
565 $alt = preg_replace("/<[^>]*?>/", "", $alt);
566 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
567 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
568 $template->parseCurrentBlock();
569 } else {
570 $template->setCurrentBlock("answer_image");
571 $template->setVariable("ANSWER_IMAGE_URL", $this->object->getImagePathWeb() . $answer->getImage());
572 list($width, $height, $type, $attr) = getimagesize($this->object->getImagePath() . $answer->getImage());
573 $alt = $answer->getImage();
574 if (strlen($answer->getAnswertext())) {
575 $alt = $answer->getAnswertext();
576 }
577 $alt = preg_replace("/<[^>]*?>/", "", $alt);
578 $template->setVariable("ATTR", $attr);
579 $template->setVariable("ANSWER_IMAGE_ALT", ilUtil::prepareFormOutput($alt));
580 $template->setVariable("ANSWER_IMAGE_TITLE", ilUtil::prepareFormOutput($alt));
581 $template->parseCurrentBlock();
582 }
583 }
584
585 if ($show_feedback) {
586 $this->populateSpecificFeedbackInline($user_solution, $answer_id, $template);
587 }
588
589 $template->setCurrentBlock("answer_row");
590 $template->setVariable("QID", $this->object->getId());
591 $template->setVariable("ANSWER_ID", $answer_id);
592 $template->setVariable("ANSWER_TEXT", $this->object->prepareTextareaOutput($answer->getAnswertext(), true));
593 foreach ($user_solution as $mc_solution) {
594 if (strcmp($mc_solution, $answer_id) == 0) {
595 $template->setVariable("CHECKED_ANSWER", " checked=\"checked\"");
596 }
597 }
598 $template->parseCurrentBlock();
599 }
600
601 $questiontext = $this->object->getQuestion();
602 $template->setVariable("QUESTIONTEXT", $this->object->prepareTextareaOutput($questiontext, true));
603 $template->setVariable("QUESTION_ID", $this->object->getId());
604 if ($this->object->getSelectionLimit()) {
605 $template->setVariable('SELECTION_LIMIT_HINT', sprintf(
606 $this->lng->txt('ass_mc_sel_lim_hint'),
607 $this->object->getSelectionLimit(),
608 $this->object->getAnswerCount()
609 ));
610
611 $template->setVariable('SELECTION_LIMIT_VALUE', $this->object->getSelectionLimit());
612 } else {
613 $template->setVariable('SELECTION_LIMIT_VALUE', 'null');
614 }
615 $questionoutput = $template->get();
616 $pageoutput = $this->outQuestionPage("", $is_postponed, $active_id, $questionoutput, $show_feedback);
617 return $pageoutput;
618 }
setUseEmptySolutionInputChecked($useEmptySolutionInputChecked)
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="", $inlineFeedbackEnabled=false)
output question page

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

+ Here is the call graph for this function:

◆ getUseUnchangedAnswerCheckboxHtml()

assMultipleChoiceGUI::getUseUnchangedAnswerCheckboxHtml ( )
protected

Reimplemented from assQuestionGUI.

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

633 {
634 // hey: prevPassSolutions - use abstracted template to share with other purposes of this kind
635 $this->tpl->addJavaScript('Modules/TestQuestionPool/js/ilAssMultipleChoice.js');
636
637 $tpl = new ilTemplate('tpl.tst_question_additional_behaviour_checkbox.html', true, true, 'Modules/TestQuestionPool');
638
639 // HEY: affects next if (!) /// noneAboveChecked repaired but disabled because the checked input ..
640 if (false) { // .. makes the qstEditController initialize the "edit" instead of the "answered" state
641 if ($this->isUseEmptySolutionInputChecked()) {
642 $tpl->setCurrentBlock('checked');
643 $tpl->touchBlock('checked');
644 $tpl->parseCurrentBlock();
645 }
646 }
647
648 $tpl->setCurrentBlock('checkbox');
649 $tpl->setVariable('TXT_FORCE_FORM_DIFF_LABEL', $this->object->getTestPresentationConfig()->getUseUnchangedAnswerLabel());
650 $tpl->parseCurrentBlock();
651 // hey.
652 return $tpl->get();
653 }

References assQuestionGUI\$tpl, and isUseEmptySolutionInputChecked().

+ Here is the call graph for this function:

◆ hasInlineFeedback()

assMultipleChoiceGUI::hasInlineFeedback ( )
Returns
bool

Reimplemented from assQuestionGUI.

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

49 {
50 return $this->object->feedbackOBJ->isSpecificAnswerFeedbackAvailable($this->object->getId());
51 }

Referenced by getSolutionOutput().

+ Here is the caller graph for this function:

◆ isUseEmptySolutionInputChecked()

assMultipleChoiceGUI::isUseEmptySolutionInputChecked ( )

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

References $useEmptySolutionInputChecked.

Referenced by getUseUnchangedAnswerCheckboxHtml().

+ Here is the caller graph for this function:

◆ populateAnswerSpecificFormPart()

assMultipleChoiceGUI::populateAnswerSpecificFormPart ( \ilPropertyFormGUI  $form)

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

886 {
887 // Choices
888 include_once "./Modules/TestQuestionPool/classes/class.ilMultipleChoiceWizardInputGUI.php";
889 $choices = new ilMultipleChoiceWizardInputGUI($this->lng->txt("answers"), "choice");
890 $choices->setRequired(true);
891 $choices->setQuestionObject($this->object);
892 $isSingleline = $this->getEditAnswersSingleLine();
893 $choices->setSingleline($isSingleline);
894 $choices->setAllowMove(false);
895 if ($this->object->getSelfAssessmentEditingMode()) {
896 $choices->setSize(40);
897 }
898 $choices->setMaxLength(800);
899 if ($this->object->getAnswerCount() == 0) {
900 $this->object->addAnswer("", 0, 0, 0);
901 }
902 $choices->setValues($this->object->getAnswers());
903 $form->addItem($choices);
904 }
This class represents a multiple choice wizard property in a property form.

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

Referenced by buildEditForm().

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

◆ populateCorrectionsFormProperties()

assMultipleChoiceGUI::populateCorrectionsFormProperties ( ilPropertyFormGUI  $form)
Parameters
ilPropertyFormGUI$form

Reimplemented from assQuestionGUI.

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

1083 {
1084 require_once 'Modules/TestQuestionPool/classes/forms/class.ilAssMultipleChoiceCorrectionsInputGUI.php';
1085 $choices = new ilAssMultipleChoiceCorrectionsInputGUI($this->lng->txt("answers"), "choice");
1086 $choices->setRequired(true);
1087 $choices->setQuestionObject($this->object);
1088 $choices->setValues($this->object->getAnswers());
1089 $form->addItem($choices);
1090 }
addItem($a_item)
Add Item (Property, SectionHeader).

References ilPropertyFormGUI\addItem().

+ Here is the call graph for this function:

◆ populateQuestionSpecificFormPart()

assMultipleChoiceGUI::populateQuestionSpecificFormPart ( \ilPropertyFormGUI  $form)

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

826 {
827 // shuffle
828 $shuffle = new ilCheckboxInputGUI($this->lng->txt("shuffle_answers"), "shuffle");
829 $shuffle->setValue(1);
830 $shuffle->setChecked($this->object->getShuffle());
831 $shuffle->setRequired(false);
832 $form->addItem($shuffle);
833
834 require_once 'Services/Form/classes/class.ilNumberInputGUI.php';
835 $selLim = new ilNumberInputGUI($this->lng->txt('ass_mc_sel_lim_setting'), 'selection_limit');
836 $selLim->setInfo($this->lng->txt('ass_mc_sel_lim_setting_desc'));
837 $selLim->setSize(2);
838 $selLim->setRequired(false);
839 $selLim->allowDecimals(false);
840 $selLim->setMinvalueShouldBeGreater(false);
841 $selLim->setMaxvalueShouldBeLess(false);
842 $selLim->setMinValue(1);
843 $selLim->setMaxValue($this->object->getAnswerCount());
844 $selLim->setValue($this->object->getSelectionLimit());
845 $form->addItem($selLim);
846
847 if ($this->object->getId()) {
848 $hidden = new ilHiddenInputGUI("", "ID");
849 $hidden->setValue($this->object->getId());
850 $form->addItem($hidden);
851 }
852
853 $isSingleline = $this->getEditAnswersSingleLine();
854
855 if (!$this->object->getSelfAssessmentEditingMode()) {
856 // Answer types
857 $types = new ilSelectInputGUI($this->lng->txt("answer_types"), "types");
858 $types->setRequired(false);
859 $types->setValue(($isSingleline) ? 0 : 1);
860 $types->setOptions(
861 array(
862 0 => $this->lng->txt('answers_singleline'),
863 1 => $this->lng->txt('answers_multiline'),
864 )
865 );
866 $form->addItem($types);
867 }
868
869 if ($isSingleline) {
870 // thumb size
871 $thumb_size = new ilNumberInputGUI($this->lng->txt("thumb_size"), "thumb_size");
872 $thumb_size->setSuffix($this->lng->txt("thumb_size_unit_pixel"));
873 $thumb_size->setMinValue(20);
874 $thumb_size->setDecimals(0);
875 $thumb_size->setSize(6);
876 $thumb_size->setInfo($this->lng->txt('thumb_size_info'));
877 $thumb_size->setValue($this->object->getThumbSize());
878 $thumb_size->setRequired(false);
879 $form->addItem($thumb_size);
880 return $isSingleline;
881 }
882 return $isSingleline;
883 }
This class represents a checkbox property in a property form.
This class represents a hidden form property in a property form.
This class represents a number property in a property form.
This class represents a selection list property in a property form.

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 1003 of file class.assMultipleChoiceGUI.php.

1004 {
1005 if ($this->object->getSpecificFeedbackSetting() == 2) {
1006 foreach ($user_solution as $mc_solution) {
1007 if (strcmp($mc_solution, $answer_id) == 0) {
1008 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), 0, $answer_id);
1009 if (strlen($fb)) {
1010 $template->setCurrentBlock("feedback");
1011 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
1012 $template->parseCurrentBlock();
1013 }
1014 }
1015 }
1016 }
1017
1018 if ($this->object->getSpecificFeedbackSetting() == 1) {
1019 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), 0, $answer_id);
1020 if (strlen($fb)) {
1021 $template->setCurrentBlock("feedback");
1022 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
1023 $template->parseCurrentBlock();
1024 }
1025 }
1026
1027 if ($this->object->getSpecificFeedbackSetting() == 3) {
1028 $answer = $this->object->getAnswer($answer_id);
1029
1030 if ($answer->getPoints() > 0) {
1031 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), 0, $answer_id);
1032 if (strlen($fb)) {
1033 $template->setCurrentBlock("feedback");
1034 $template->setVariable("FEEDBACK", $this->object->prepareTextareaOutput($fb, true));
1035 $template->parseCurrentBlock();
1036 }
1037 }
1038 }
1039 }

Referenced by getPreview(), and getTestOutput().

+ Here is the caller graph for this function:

◆ removechoice()

assMultipleChoiceGUI::removechoice ( )

Remove an answer.

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

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

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

+ Here is the call graph for this function:

◆ removeimagechoice()

assMultipleChoiceGUI::removeimagechoice ( )

Remove an image.

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

156 {
157 $this->writePostData(true);
158 $position = key($_POST['cmd']['removeimagechoice']);
159 $filename = $_POST['choice']['imagename'][$position];
160 $this->object->removeAnswerImage($position);
161 $this->editQuestion();
162 }
$filename
Definition: buildRTE.php:89

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 976 of file class.assMultipleChoiceGUI.php.

977 {
978 $tpl = new ilTemplate('tpl.il_as_aggregated_answers_table.html', true, true, "Modules/TestQuestionPool");
979
980 $tpl->setCurrentBlock('headercell');
981 $tpl->setVariable('HEADER', $this->lng->txt('tst_answer_aggr_answer_header'));
982 $tpl->parseCurrentBlock();
983
984 $tpl->setCurrentBlock('headercell');
985 $tpl->setVariable('HEADER', $this->lng->txt('tst_answer_aggr_frequency_header'));
986 $tpl->parseCurrentBlock();
987
988 foreach ($aggregate as $line_data) {
989 $tpl->setCurrentBlock('aggregaterow');
990 $tpl->setVariable('OPTION', $line_data['answertext']);
991 $tpl->setVariable('COUNT', $line_data['count_checked']);
992 $tpl->parseCurrentBlock();
993 }
994 return $tpl;
995 }

References assQuestionGUI\$tpl.

Referenced by getAggregatedAnswersView().

+ Here is the caller graph for this function:

◆ saveCorrectionsFormProperties()

assMultipleChoiceGUI::saveCorrectionsFormProperties ( ilPropertyFormGUI  $form)
Parameters
ilPropertyFormGUI$form

Reimplemented from assQuestionGUI.

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

1096 {
1097 $pointsChecked = $form->getInput('choice')['points'];
1098 $pointsUnchecked = $form->getInput('choice')['points_unchecked'];
1099
1100 foreach ($this->object->getAnswers() as $index => $answer) {
1101 /* @var ASS_AnswerMultipleResponseImage $answer */
1102 $answer->setPointsChecked((float) $pointsChecked[$index]);
1103 $answer->setPointsUnchecked((float) $pointsUnchecked[$index]);
1104 }
1105 }
getInput($a_post_var, $ensureValidation=true)
Returns the value of a HTTP-POST variable, identified by the passed id.

References $index, and ilPropertyFormGUI\getInput().

+ Here is the call graph for this function:

◆ 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 665 of file class.assMultipleChoiceGUI.php.

666 {
667 global $DIC;
668 $rbacsystem = $DIC['rbacsystem'];
669 $ilTabs = $DIC['ilTabs'];
670
671 $ilTabs->clearTargets();
672
673 $this->ctrl->setParameterByClass("ilAssQuestionPageGUI", "q_id", $_GET["q_id"]);
674 include_once "./Modules/TestQuestionPool/classes/class.assQuestion.php";
675 $q_type = $this->object->getQuestionType();
676
677 if (strlen($q_type)) {
678 $classname = $q_type . "GUI";
679 $this->ctrl->setParameterByClass(strtolower($classname), "sel_question_types", $q_type);
680 $this->ctrl->setParameterByClass(strtolower($classname), "q_id", $_GET["q_id"]);
681 }
682
683 if ($_GET["q_id"]) {
684 if ($rbacsystem->checkAccess('write', $_GET["ref_id"])) {
685 // edit page
686 $ilTabs->addTarget(
687 "edit_page",
688 $this->ctrl->getLinkTargetByClass("ilAssQuestionPageGUI", "edit"),
689 array("edit", "insert", "exec_pg"),
690 "",
691 "",
692 $force_active
693 );
694 }
695
696 $this->addTab_QuestionPreview($ilTabs);
697 }
698 $force_active = false;
699 if ($rbacsystem->checkAccess('write', $_GET["ref_id"])) {
700 $url = "";
701 if ($classname) {
702 $url = $this->ctrl->getLinkTargetByClass($classname, "editQuestion");
703 }
704 $force_active = false;
705 // edit question properties
706 $ilTabs->addTarget(
707 "edit_question",
708 $url,
709 array("editQuestion", "save", "saveEdit", "addchoice", "removechoice", "removeimagechoice", "uploadchoice", "originalSyncForm"),
710 $classname,
711 "",
712 $force_active
713 );
714 }
715
716 // add tab for question feedback within common class assQuestionGUI
717 $this->addTab_QuestionFeedback($ilTabs);
718
719 // add tab for question hint within common class assQuestionGUI
720 $this->addTab_QuestionHints($ilTabs);
721
722 // add tab for question's suggested solution within common class assQuestionGUI
723 $this->addTab_SuggestedSolution($ilTabs, $classname);
724
725 // Assessment of questions sub menu entry
726 if ($_GET["q_id"]) {
727 $ilTabs->addTarget(
728 "statistics",
729 $this->ctrl->getLinkTargetByClass($classname, "assessment"),
730 array("assessment"),
731 $classname,
732 ""
733 );
734 }
735
736 $this->addBackTab($ilTabs);
737 }
$_GET["client_id"]
addTab_QuestionHints(ilTabsGUI $tabs)
adds the hints tab to ilTabsGUI
addTab_SuggestedSolution(ilTabsGUI $tabs, $classname)
addBackTab(ilTabsGUI $ilTabs)
addTab_QuestionFeedback(ilTabsGUI $tabs)
adds the feedback tab to ilTabsGUI
addTab_QuestionPreview(ilTabsGUI $tabsGUI)
$url
$DIC
Definition: xapitoken.php:46

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

+ Here is the call graph for this function:

◆ setUseEmptySolutionInputChecked()

assMultipleChoiceGUI::setUseEmptySolutionInputChecked (   $useEmptySolutionInputChecked)

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

628 {
629 $this->useEmptySolutionInputChecked = $useEmptySolutionInputChecked;
630 }

References $useEmptySolutionInputChecked.

Referenced by getTestOutput().

+ Here is the caller graph for this function:

◆ supportsIntermediateSolutionOutput()

assMultipleChoiceGUI::supportsIntermediateSolutionOutput ( )

Question type specific support of intermediate solution output The function getSolutionOutput respects getUseIntermediateSolution()

Returns
bool

Reimplemented from assQuestionGUI.

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

192 {
193 return true;
194 }

◆ uploadchoice()

assMultipleChoiceGUI::uploadchoice ( )

Upload an image.

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

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

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 781 of file class.assMultipleChoiceGUI.php.

782 {
783 // Delete all existing answers and create new answers from the form data
784 $this->object->flushAnswers();
785 if ($this->object->isSingleline) {
786 foreach ($_POST['choice']['answer'] as $index => $answertext) {
787 $answertext = ilUtil::secureString($answertext);
788
789 $picturefile = $_POST['choice']['imagename'][$index];
790 $file_org_name = $_FILES['choice']['name']['image'][$index];
791 $file_temp_name = $_FILES['choice']['tmp_name']['image'][$index];
792
793 if (strlen($file_temp_name)) {
794 // check suffix
795 $suffix = strtolower(array_pop(explode(".", $file_org_name)));
796 if (in_array($suffix, array( "jpg", "jpeg", "png", "gif" ))) {
797 // upload image
798 $filename = $this->object->buildHashedImageFilename($file_org_name);
799 if ($this->object->setImageFile($filename, $file_temp_name) == 0) {
800 $picturefile = $filename;
801 }
802 }
803 }
804 $this->object->addAnswer(
805 $answertext,
806 $_POST['choice']['points'][$index],
807 $_POST['choice']['points_unchecked'][$index],
808 $index,
809 $picturefile
810 );
811 }
812 } else {
813 foreach ($_POST['choice']['answer'] as $index => $answer) {
814 $answertext = $answer;
815 $this->object->addAnswer(
816 $answertext,
817 $_POST['choice']['points'][$index],
818 $_POST['choice']['points_unchecked'][$index],
819 $index
820 );
821 }
822 }
823 }
static secureString($a_str, $a_strip_html=true, $a_allow="")
Remove unsecure tags.

References $_POST, $filename, $index, 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 56 of file class.assMultipleChoiceGUI.php.

57 {
58 $hasErrors = (!$always) ? $this->editQuestion(true) : false;
59 if (!$hasErrors) {
60 $form = $this->buildEditForm();
61 $form->setValuesByPost();
62 require_once 'Services/Form/classes/class.ilPropertyFormGUI.php';
65 $this->writeAnswerSpecificPostData($form);
67 return 0;
68 }
69 return 1;
70 }
writeAnswerSpecificPostData(ilPropertyFormGUI $form)
Extracts the answer specific values from $_POST and applies them to the data object.
writeQuestionSpecificPostData(ilPropertyFormGUI $form)
Extracts the question specific values from $_POST and applies them to the data object.

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 762 of file class.assMultipleChoiceGUI.php.

763 {
764 $this->object->setShuffle($_POST["shuffle"]);
765
766 $selectionLimit = (int) $form->getItemByPostVar('selection_limit')->getValue();
767 $this->object->setSelectionLimit($selectionLimit > 0 ? $selectionLimit : null);
768
769 $this->object->setSpecificFeedbackSetting($_POST['feedback_setting']);
770
771 $this->object->setMultilineAnswerSetting($_POST["types"]);
772 if (is_array($_POST['choice']['imagename']) && $_POST["types"] == 1) {
773 $this->object->isSingleline = true;
774 ilUtil::sendInfo($this->lng->txt('info_answer_type_change'), true);
775 } else {
776 $this->object->isSingleline = ($_POST["types"] == 0) ? true : false;
777 }
778 $this->object->setThumbSize((strlen($_POST["thumb_size"])) ? $_POST["thumb_size"] : "");
779 }
getItemByPostVar($a_post_var)
Get Item by POST variable.
static sendInfo($a_info="", $a_keep=false)
Send Info Message to Screen.

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().

◆ $useEmptySolutionInputChecked

assMultipleChoiceGUI::$useEmptySolutionInputChecked = false
protected

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