ILIAS  trunk Revision v12.0_alpha-377-g3641b37b9db
Public Member Functions | Protected Member Functions | Private Member Functions | Private Attributes
assKprimChoiceGUI Class Reference
+ Inheritance diagram for assKprimChoiceGUI:
+ Collaboration diagram for assKprimChoiceGUI:

Public Member Functions

 __construct ($qId=-1)
 
 hasInlineFeedback ()
 
 editQuestion (bool $checkonly=false, ?bool $is_save_cmd=null)
 
 uploadImage ()
 
 removeImage ()
 
 downkprimanswers ()
 
 upkprimanswers ()
 
 populateQuestionSpecificFormPart (ilPropertyFormGUI $form, ?string $answer_type=null)
 
 writeQuestionSpecificPostData (ilPropertyFormGUI $form)
 
 populateAnswerSpecificFormPart (ilPropertyFormGUI $form, ?string $answer_type=null)
 
 writeAnswerSpecificPostData (ilPropertyFormGUI $form)
 
 getSpecificFeedbackOutput (array $userSolution)
 
 getTestOutput (int $active_id, int $pass, bool $is_question_postponed=false, array|bool $user_post_solutions=false, bool $show_specific_inline_feedback=false)
 
 getPreview (bool $show_question_only=false, bool $show_inline_feedback=false)
 
 getSolutionOutput (int $active_id, ?int $pass=null, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_inline_feedback=true)
 
 renderSolutionOutput (mixed $user_solutions, int $active_id, ?int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false,)
 
 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...
 
 getAnswersFrequency ($relevantAnswers, $questionIndex)
 
 getAnswerFrequencyTableGUI ($parentGui, $parentCmd, $relevantAnswers, $questionIndex)
 
 populateCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 saveCorrectionsFormProperties (ilPropertyFormGUI $form)
 
- Public Member Functions inherited from assQuestionGUI
 editQuestion (bool $checkonly=false, ?bool $is_save_cmd=null)
 
 getSpecificFeedbackOutput (array $userSolution)
 Returns the answer specific feedback for the question. More...
 
 getSolutionOutput (int $active_id, ?int $pass=null, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_inline_feedback=true)
 
 getPreview (bool $show_question_only=false, bool $show_inline_feedback=false)
 
 getTestOutput (int $active_id, int $pass, bool $is_question_postponed=false, array|bool $user_post_solutions=false, bool $show_specific_inline_feedback=false)
 
 renderSolutionOutput (mixed $user_solutions, int $active_id, ?int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false,)
 
 getObject ()
 
 setObject (assQuestion $question)
 
 setCopyToExistingPoolOnSave (?int $pool_ref_id)
 
 getCopyToExistingPoolOnSave ()
 
 setCopyToNewPoolOnSave (?string $pool_title)
 
 getCopyToNewPoolOnSave ()
 
 setMoveAfterQuestionId (?int $question_id)
 
 getMoveAfterQuestionId ()
 
 hasInlineFeedback ()
 
 addHeaderAction ()
 
 redrawHeaderAction ()
 
 getHeaderAction ()
 
 getCommentsPanelHTML ()
 
 executeCommand ()
 
 getType ()
 needed for page editor compliance More...
 
 getPresentationContext ()
 
 setPresentationContext (string $presentationContext)
 
 isTestPresentationContext ()
 
 isPreviousSolutionPrefilled ()
 
 setPreviousSolutionPrefilled (bool $previousSolutionPrefilled)
 
 getRenderPurpose ()
 
 setRenderPurpose (string $renderPurpose)
 
 isRenderPurposePrintPdf ()
 
 isRenderPurposePreview ()
 
 isRenderPurposeInputValue ()
 
 isRenderPurposePlayback ()
 
 isRenderPurposeDemoplay ()
 
 renderPurposeSupportsFormHtml ()
 
 getEditContext ()
 
 setEditContext (string $editContext)
 
 isAuthoringEditContext ()
 
 isAdjustmentEditContext ()
 
 setAdjustmentEditContext ()
 
 getNavigationGUI ()
 
 setNavigationGUI (?ilTestQuestionNavigationGUI $navigationGUI)
 
 setTaxonomyIds (array $taxonomyIds)
 
 getTaxonomyIds ()
 
 setTargetGui ($linkTargetGui)
 
 setTargetGuiClass (string $targetGuiClass)
 
 getTargetGuiClass ()
 
 setQuestionHeaderBlockBuilder (\ilQuestionHeaderBlockBuilder $questionHeaderBlockBuilder)
 
 getQuestionHeaderBlockBuilder ()
 
 setQuestionActionCmd (string $questionActionCmd)
 
 getQuestionActionCmd ()
 
 assessment ()
 
 populateJavascriptFilesRequiredForWorkForm (ilGlobalTemplateInterface $tpl)
 
 getPresentationJavascripts ()
 
 getQuestionTemplate ()
 
 getILIASPage (string $html="")
 Returns the ILIAS Page around a question. More...
 
 outQuestionPage ($a_temp_var, $a_postponed=false, $active_id="", $html="", $inlineFeedbackEnabled=false)
 
 syncQuestion ()
 
 saveReturn ()
 
 saveQuestion ()
 
 setAdditionalContentEditingModeFromPost ()
 
 getContextPath ($cont_obj, int $a_endnode_id, int $a_startnode_id=1)
 get context path in content object tree More...
 
 setSequenceNumber (int $nr)
 
 getSequenceNumber ()
 
 setQuestionCount (int $a_question_count)
 
 getQuestionCount ()
 
 getErrorMessage ()
 
 setErrorMessage (string $errormessage)
 
 addErrorMessage (string $errormessage)
 
 getQuestionType ()
 
 getAsValueAttribute (string $a_value)
 
 addQuestionFormCommandButtons (ilPropertyFormGUI $form)
 
 addBasicQuestionFormProperties (ilPropertyFormGUI $form)
 
 getGenericFeedbackOutput (int $active_id, ?int $pass)
 
 getGenericFeedbackOutputForCorrectSolution ()
 
 getGenericFeedbackOutputForIncorrectSolution ()
 
 outQuestionType ()
 
 saveSuggestedSolution ()
 
 cancelSuggestedSolution ()
 
 suggestedsolution (bool $save=false)
 
 outSolutionExplorer ()
 
 saveSuggestedSolutionType ()
 
 cancelExplorer ()
 
 outPageSelector ()
 
 outChapterSelector ()
 
 outGlossarySelector ()
 
 linkChilds ()
 
 addPG ()
 
 addST ()
 
 addGIT ()
 
 isSaveCommand ()
 
 setQuestionTabs ()
 
 addTab_SuggestedSolution (ilTabsGUI $tabs, string $classname)
 
 getEditQuestionTabCommands ()
 
 isAutosaveable ()
 
 outQuestionForTest (string $formaction, int $active_id, ?int $pass, bool $is_question_postponed=false, array|bool $user_post_solutions=false, bool $show_specific_inline_feedback=false)
 
 magicAfterTestOutput ()
 
 getFormEncodingType ()
 
 setPreviewSession (ilAssQuestionPreviewSession $preview_session)
 
 getPreviewSession ()
 
 buildFocusAnchorHtml ()
 
 isAnswerFrequencyStatisticSupported ()
 
 getSubQuestionsIndex ()
 
 getAnswersFrequency ($relevantAnswers, $questionIndex)
 
 getAnswerFrequencyTableGUI ($parentGui, $parentCmd, $relevantAnswers, $questionIndex)
 
 prepareReprintableCorrectionsForm (ilPropertyFormGUI $form)
 
 populateCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 saveCorrectionsFormProperties (ilPropertyFormGUI $form)
 
 isInLearningModuleContext ()
 
 setInLearningModuleContext (bool $flag)
 
 cmdNeedsExistingQuestion (string $cmd)
 
 setContextAllowsSyncToPool (bool $sync_allowed)
 
 needsSyncQuery ()
 
 getQuestionSyncModal (string $cmd, string $cmd_class='')
 
 getAutoSavedSolutionOutput (int $active_id, int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false)
 
 buildFileDownloadLink ()
 
- 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 the request 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...
 
- 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 the request 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...
 

Protected Member Functions

 getAdditionalEditQuestionCommands ()
 
 writePostData (bool $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...
 
 buildEditForm ()
 
 getParticipantsAnswerKeySequence ()
 
- Protected Member Functions inherited from assQuestionGUI
 hasSpecialQuestionCommands ()
 
 writePostData (bool $always=false)
 Evaluates a posted edit form and writes the form data in the question object. More...
 
 renderEditForm (ilPropertyFormGUI $form)
 
 getUseUnchangedAnswerCheckboxHtml ()
 
 getPreviousSolutionProvidedMessage ()
 
 getPreviousSolutionConfirmationCheckboxHtml ()
 
 setTestSpecificProperties ()
 
 addNumberOfTriesToFormIfNecessary (ilPropertyFormGUI $form)
 
 saveTaxonomyAssignments ()
 
 populateTaxonomyFormSection (ilPropertyFormGUI $form)
 
 genericFeedbackOutputBuilder (int $active_id, ?int $pass)
 
 getTypeOptions ()
 
 createSuggestedSolutionLinkingTo (string $type, string $target)
 
 setDefaultTabs (ilTabsGUI $tabs_gui)
 
 setQuestionSpecificTabs (ilTabsGUI $tabs_gui)
 
 getBasicEditQuestionTabCommands ()
 
 getAdditionalEditQuestionCommands ()
 
 addTab_QuestionFeedback (ilTabsGUI $tabs)
 
 addTab_Question (ilTabsGUI $tabs_gui)
 
 hasCorrectSolution ($activeId, $passIndex)
 
 writeQuestionGenericPostData ()
 
 completeTestOutputFormAction (string $form_action, int $active_id, int $pass)
 
 addBackTab (ilTabsGUI $tabs_gui)
 
 buildBasicEditFormObject ()
 
 escapeTemplatePlaceholders (string $text)
 
 buildEditForm ()
 
 generateCorrectnessIconsForCorrectness (int $correctness)
 
 renderLatex ($content)
 Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in the browser. More...
 
 getSuggestedSolutionsRepo ()
 
 cleanupAnswerText (array $answer_text, bool $is_rte)
 sk - 12.05.2023: This is one more of those that we need, but don't want. More...
 
 addSaveOnEnterOnLoadCode ()
 
 resetSavedPreviewSession ()
 

Private Member Functions

 handleAnswerTextsSubmit ($answers)
 
 populateSpecificFeedbackInline ($user_solution, $answer_id, $template)
 
 aggregateAnswers ($rawSolutionData, $answers)
 

Private Attributes

bool $rebuild_thumbnails = false
 
ilPropertyFormGUI $edit_form = null
 

Additional Inherited Members

- Static Public Member Functions inherited from assQuestionGUI
static _getQuestionGUI (string $question_type='', int $question_id=-1)
 Creates a question gui representation and returns the alias to the question gui. More...
 
static getCommandsFromClassConstants (string $guiClassName, string $cmdConstantNameBegin='CMD_')
 
static prepareTextareaOutput (?string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
 Prepares a string for a text area output where latex code may be in it If the text is HTML-free, CHR(13) will be converted to a line break. More...
 
- Data Fields inherited from assQuestionGUI
const ALLOWED_PLAIN_TEXT_TAGS = "<em>, <strong>"
 sk - 12.05.2023: This const is also used in ilKprimChoiceWizardInputGUI. More...
 
const SESSION_PREVIEW_DATA_BASE_INDEX = 'ilAssQuestionPreviewAnswers'
 
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 CORRECTNESS_NOT_OK = 0
 
const CORRECTNESS_MOSTLY_OK = 1
 
const CORRECTNESS_OK = 2
 
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'
 
const PRESENTATION_CONTEXT_TEST = 'pContextTest'
 
const PRESENTATION_CONTEXT_RESULTS = 'pContextResults'
 
const CMD_SYNC_QUESTION_AND_RETURN = 'syncQuestionReturn'
 
- Protected Attributes inherited from assQuestionGUI
const HAS_SPECIAL_QUESTION_COMMANDS = false
 
const SUGGESTED_SOLUTION_COMMANDS_CANCEL = 'cancelSuggestedSolution'
 
const SUGGESTED_SOLUTION_COMMANDS_SAVE = 'saveSuggestedSolution'
 
const SUGGESTED_SOLUTION_COMMANDS_DEFAULT = 'suggestedsolution'
 
const QUESTION_SAVE_CMDS
 
const ADDITIONAL_CMDS_NEEDING_EXISTING_QST
 There are functions that need an existing question. More...
 
ilLogger $logger
 
GeneralQuestionPropertiesRepository $questionrepository
 
GUIService $notes_gui
 
ilCtrl $ctrl
 
assQuestion $object
 
ilGlobalPageTemplate $tpl
 
ilLanguage $lng
 
Refinery $refinery
 
 $error
 
string $errormessage
 
int $sequence_no
 sequence number in test More...
 
int $question_count
 question count in test More...
 
ilPropertyFormGUI $editForm = null
 
readonly ilTestLegacyFormsHelper $forms_helper
 
readonly RequestDataCollector $request_data_collector
 
bool $parent_type_is_lm = false
 
SuggestedSolutionsDatabaseRepository $suggestedsolution_repo = null
 

Detailed Description

Definition at line 27 of file class.assKprimChoiceGUI.php.

Constructor & Destructor Documentation

◆ __construct()

assKprimChoiceGUI::__construct (   $qId = -1)
Parameters
$qId

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

36 {
37 parent::__construct();
38
39 $this->object = new assKprimChoice();
40
41 if ($qId > 0) {
42 $this->object->loadFromDb($qId);
43 }
44 }
ILIAS\GlobalScreen\Provider\__construct
__construct(Container $dic, ilPlugin $plugin)
@inheritDoc
Definition: PluginProviderHelper.php:38

References ILIAS\GlobalScreen\Provider\__construct().

+ Here is the call graph for this function:

Member Function Documentation

◆ aggregateAnswers()

assKprimChoiceGUI::aggregateAnswers (   $rawSolutionData,
  $answers 
)
private

Definition at line 836 of file class.assKprimChoiceGUI.php.

836 : array
837 {
838 $aggregate = [];
839
840 foreach ($answers as $answer) {
841 $answerAgg = [
842 'answertext' => $answer->getAnswerText(), 'count_true' => 0, 'count_false' => 0
843 ];
844
845 foreach ($rawSolutionData as $solutionRecord) {
846 if ($solutionRecord['value1'] == $answer->getPosition()) {
847 if ($solutionRecord['value2']) {
848 $answerAgg['count_true']++;
849 } else {
850 $answerAgg['count_false']++;
851 }
852 }
853 }
854
855 $aggregate[] = $answerAgg;
856 }
857
858 return $aggregate;
859 }

◆ buildEditForm()

assKprimChoiceGUI::buildEditForm ( )
protected
Returns
ilPropertyFormGUI

Reimplemented from assQuestionGUI.

Definition at line 150 of file class.assKprimChoiceGUI.php.

150 : ilPropertyFormGUI
151 {
152 $form = $this->buildBasicEditFormObject();
153
154 $this->addQuestionFormCommandButtons($form);
155
156 $this->addBasicQuestionFormProperties($form);
157
158 $answer_type = $this->request_data_collector->string('answer_type') ?: null;
159 $this->populateQuestionSpecificFormPart($form, $answer_type);
160 $this->populateAnswerSpecificFormPart($form, $answer_type);
161
162 $this->populateTaxonomyFormSection($form);
163
164 return $form;
165 }
assKprimChoiceGUI\populateAnswerSpecificFormPart
populateAnswerSpecificFormPart(ilPropertyFormGUI $form, ?string $answer_type=null)
Definition: class.assKprimChoiceGUI.php:282
assKprimChoiceGUI\populateQuestionSpecificFormPart
populateQuestionSpecificFormPart(ilPropertyFormGUI $form, ?string $answer_type=null)
Definition: class.assKprimChoiceGUI.php:167
assQuestionGUI\populateTaxonomyFormSection
populateTaxonomyFormSection(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:976
assQuestionGUI\addBasicQuestionFormProperties
addBasicQuestionFormProperties(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:855
assQuestionGUI\addQuestionFormCommandButtons
addQuestionFormCommandButtons(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:847
ilPropertyFormGUI
This class represents a property form user interface.
Definition: class.ilPropertyFormGUI.php:32

Referenced by editQuestion().

+ Here is the caller graph for this function:

◆ downkprimanswers()

assKprimChoiceGUI::downkprimanswers ( )

Definition at line 88 of file class.assKprimChoiceGUI.php.

88 : void
89 {
90 $index = $this->request_data_collector->getCmdIndex(__FUNCTION__);
91 if (!empty($index)) {
92 $this->object->moveAnswerDown($index);
93 $this->object->saveToDb();
94 }
95
96 $this->editQuestion();
97 }
assKprimChoiceGUI\editQuestion
editQuestion(bool $checkonly=false, ?bool $is_save_cmd=null)
Definition: class.assKprimChoiceGUI.php:59

◆ editQuestion()

assKprimChoiceGUI::editQuestion ( bool  $checkonly = false,
?bool  $is_save_cmd = null 
)

Reimplemented from assQuestionGUI.

Definition at line 59 of file class.assKprimChoiceGUI.php.

62 : bool {
63 $form = $this->edit_form;
64 if ($form === null) {
65 $form = $this->buildEditForm();
66 }
67
68 $this->renderEditForm($form);
69 return false;
70 }
assKprimChoiceGUI\$edit_form
ilPropertyFormGUI $edit_form
Definition: class.assKprimChoiceGUI.php:30
assQuestionGUI\renderEditForm
renderEditForm(ilPropertyFormGUI $form)
Definition: class.assQuestionGUI.php:621

References buildEditForm().

+ Here is the call graph for this function:

◆ getAdditionalEditQuestionCommands()

assKprimChoiceGUI::getAdditionalEditQuestionCommands ( )
protected

Reimplemented from assQuestionGUI.

Definition at line 54 of file class.assKprimChoiceGUI.php.

54 : array
55 {
56 return ['uploadImage', 'removeImage'];
57 }

◆ getAfterParticipationSuppressionAnswerPostVars()

assKprimChoiceGUI::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 817 of file class.assKprimChoiceGUI.php.

817 : array
818 {
819 return [];
820 }

◆ getAfterParticipationSuppressionQuestionPostVars()

assKprimChoiceGUI::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 831 of file class.assKprimChoiceGUI.php.

831 : array
832 {
833 return [];
834 }

◆ getAnswerFrequencyTableGUI()

assKprimChoiceGUI::getAnswerFrequencyTableGUI (   $parentGui,
  $parentCmd,
  $relevantAnswers,
  $questionIndex 
)
Parameters
$parentGui
$parentCmd
$relevantAnswers
$questionIndex
Returns
ilKprimChoiceAnswerFreqStatTableGUI

Reimplemented from assQuestionGUI.

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

885 : ilAnswerFrequencyStatisticTableGUI
886 {
887 $table = new ilKprimChoiceAnswerFreqStatTableGUI($parentGui, $parentCmd, $this->object);
888 $table->setQuestionIndex($questionIndex);
889 $table->setData($this->getAnswersFrequency($relevantAnswers, $questionIndex));
890 $table->initColumns();
891
892 return $table;
893 }
assKprimChoiceGUI\getAnswersFrequency
getAnswersFrequency($relevantAnswers, $questionIndex)
Definition: class.assKprimChoiceGUI.php:861
ilAnswerFrequencyStatisticTableGUI
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
Definition: class.ilAnswerFrequencyStatisticTableGUI.php:24

◆ getAnswersFrequency()

assKprimChoiceGUI::getAnswersFrequency (   $relevantAnswers,
  $questionIndex 
)

Reimplemented from assQuestionGUI.

Definition at line 861 of file class.assKprimChoiceGUI.php.

861 : array
862 {
863 $agg = $this->aggregateAnswers($relevantAnswers, $this->object->getAnswers());
864
865 $answers = [];
866
867 foreach ($agg as $ans) {
868 $answers[] = [
869 'answer' => $ans['answertext'],
870 'frequency_true' => $ans['count_true'],
871 'frequency_false' => $ans['count_false']
872 ];
873 }
874
875 return $answers;
876 }
assKprimChoiceGUI\aggregateAnswers
aggregateAnswers($rawSolutionData, $answers)
Definition: class.assKprimChoiceGUI.php:836

References ILIAS\Repository\object().

+ Here is the call graph for this function:

◆ getParticipantsAnswerKeySequence()

assKprimChoiceGUI::getParticipantsAnswerKeySequence ( )
protected

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

756 {
757 $choice_keys = array_keys($this->object->getAnswers());
758
759 if ($this->object->isShuffleAnswersEnabled()) {
760 $choice_keys = $this->object->getShuffler()->transform($choice_keys);
761 }
762
763 return $choice_keys;
764 }

References ILIAS\Repository\object().

+ Here is the call graph for this function:

◆ getPreview()

assKprimChoiceGUI::getPreview ( bool  $show_question_only = false,
bool  $show_inline_feedback = false 
)

Reimplemented from assQuestionGUI.

Definition at line 453 of file class.assKprimChoiceGUI.php.

456 : string {
457 $user_solution = is_object($this->getPreviewSession()) ? (array) $this->getPreviewSession()->getParticipantsSolution() : [];
458 // shuffle output
459 $keys = $this->getParticipantsAnswerKeySequence();
460
461 $template = new ilTemplate("tpl.il_as_qpl_mc_kprim_output.html", true, true, "components/ILIAS/TestQuestionPool");
462
463 foreach ($keys as $answer_id) {
464 $answer = $this->object->getAnswer($answer_id);
465 if ($answer->getImageFile() !== null
466 && $answer->getImageFile() !== '') {
467 if ($this->object->getThumbSize()) {
468 $template->setCurrentBlock("preview");
469 $template->setVariable("URL_PREVIEW", $answer->getImageWebPath());
470 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
471 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('media/enlarge.svg'));
472 $template->setVariable("ANSWER_IMAGE_URL", $answer->getThumbWebPath());
473 [$width, $height, $type, $attr] = getimagesize($answer->getImageFsPath());
474 $alt = $answer->getImageFile();
475 if (strlen($answer->getAnswertext())) {
476 $alt = $answer->getAnswertext();
477 }
478 $alt = preg_replace("/<[^>]*?>/", "", $alt);
479 $template->setVariable("ANSWER_IMAGE_ALT", ilLegacyFormElementsUtil::prepareFormOutput($alt));
480 $template->setVariable("ANSWER_IMAGE_TITLE", ilLegacyFormElementsUtil::prepareFormOutput($alt));
481 $template->parseCurrentBlock();
482 } else {
483 $template->setCurrentBlock("answer_image");
484 $template->setVariable("ANSWER_IMAGE_URL", $answer->getImageWebPath());
485 [$width, $height, $type, $attr] = getimagesize($answer->getImageFsPath());
486 $alt = $answer->getImageFile();
487 if (strlen($answer->getAnswertext())) {
488 $alt = $answer->getAnswertext();
489 }
490 $alt = preg_replace("/<[^>]*?>/", "", $alt);
491 $template->setVariable("ATTR", $attr);
492 $template->setVariable("ANSWER_IMAGE_ALT", ilLegacyFormElementsUtil::prepareFormOutput($alt));
493 $template->setVariable("ANSWER_IMAGE_TITLE", ilLegacyFormElementsUtil::prepareFormOutput($alt));
494 $template->parseCurrentBlock();
495 }
496 }
497
498 if ($show_inline_feedback) {
499 $this->populateSpecificFeedbackInline($user_solution, $answer_id, $template);
500 }
501
502 $template->setCurrentBlock("answer_row");
503 $template->setVariable("ANSWER_ID", $answer_id);
504 $template->setVariable("ANSWER_TEXT", $this->renderLatex(
505 ilLegacyFormElementsUtil::prepareTextareaOutput((string) $answer->getAnswertext(), true)
506 ));
507 $template->setVariable('VALUE_TRUE', 1);
508 $template->setVariable('VALUE_FALSE', 0);
509
510 if (isset($user_solution[$answer->getPosition()])) {
511 $tplVar = $user_solution[$answer->getPosition()] ? 'CHECKED_ANSWER_TRUE' : 'CHECKED_ANSWER_FALSE';
512 $template->setVariable($tplVar, " checked=\"checked\"");
513 }
514
515 $template->parseCurrentBlock();
516 }
517 $questiontext = $this->object->getQuestionForHTMLOutput();
518 if ($show_inline_feedback && $this->hasInlineFeedback()) {
519 $questiontext .= $this->buildFocusAnchorHtml();
520 }
521 $template->setVariable("QUESTIONTEXT", $this->renderLatex(
522 ilLegacyFormElementsUtil::prepareTextareaOutput($questiontext, true)
523 ));
524
525 $template->setVariable("INSTRUCTIONTEXT", $this->object->getInstructionTextTranslation(
526 $this->lng,
527 $this->object->getOptionLabel()
528 ));
529
530 $template->setVariable("OPTION_LABEL_TRUE", $this->object->getTrueOptionLabelTranslation(
531 $this->lng,
532 $this->object->getOptionLabel()
533 ));
534
535 $template->setVariable("OPTION_LABEL_FALSE", $this->object->getFalseOptionLabelTranslation(
536 $this->lng,
537 $this->object->getOptionLabel()
538 ));
539
540 $questionoutput = $template->get();
541 if (!$show_question_only) {
542 // get page object output
543 $questionoutput = $this->getILIASPage($questionoutput);
544 }
545 return $questionoutput;
546 }
assKprimChoiceGUI\populateSpecificFeedbackInline
populateSpecificFeedbackInline($user_solution, $answer_id, $template)
Definition: class.assKprimChoiceGUI.php:766
assQuestionGUI\renderLatex
renderLatex($content)
Wrap content with latex in a LatexContent UI component and render it to be processed by MathJax in th...
Definition: class.assQuestionGUI.php:1906
assQuestionGUI\getILIASPage
getILIASPage(string $html="")
Returns the ILIAS Page around a question.
Definition: class.assQuestionGUI.php:631
ilLegacyFormElementsUtil\prepareTextareaOutput
static prepareTextareaOutput(string $txt_output, bool $prepare_for_latex_output=false, bool $omitNl2BrWhenTextArea=false)
Prepares a string for a text area output where latex code may be in it If the text is HTML-free,...
Definition: class.ilLegacyFormElementsUtil.php:109
ilLegacyFormElementsUtil\prepareFormOutput
static prepareFormOutput($a_str, bool $a_strip=false)
Definition: class.ilLegacyFormElementsUtil.php:37
ilTemplate
special template class to simplify handling of ITX/PEAR
Definition: class.ilTemplate.php:31
ilUtil\getImagePath
static getImagePath(string $image_name, string $module_path="", string $mode="output", bool $offline=false)
get image path (for images located in a template directory)
Definition: class.ilUtil.php:68

◆ getSolutionOutput()

assKprimChoiceGUI::getSolutionOutput ( int  $active_id,
?int  $pass = null,
bool  $graphical_output = false,
bool  $result_output = false,
bool  $show_question_only = true,
bool  $show_feedback = false,
bool  $show_correct_solution = false,
bool  $show_manual_scoring = false,
bool  $show_question_text = true,
bool  $show_inline_feedback = true 
)

Reimplemented from assQuestionGUI.

Definition at line 548 of file class.assKprimChoiceGUI.php.

559 : string {
560 $user_solution = [];
561
562 if (($active_id > 0) && (!$show_correct_solution)) {
563 $solutions = $this->object->getSolutionValues($active_id, $pass);
564 foreach ($solutions as $idx => $solution_value) {
565 //$user_solution[$solution_value['value1']] = $solution_value['value2'];
566 $user_solution[] = [
567 'value1' => $solution_value['value1'],
568 'value2' => $solution_value['value2']
569 ];
570 }
571 } else {
572 // take the correct solution instead of the user solution
573 foreach ($this->object->getAnswers() as $answer) {
574 //$user_solution[$answer->getPosition()] = $answer->getCorrectness();
575 $user_solution[] = [
576 'value1' => $answer->getPosition(),
577 'value2' => $answer->getCorrectness()
578 ];
579 }
580 }
581
582 return $this->renderSolutionOutput(
583 $user_solution,
584 $active_id,
585 $pass,
586 $graphical_output,
587 $result_output,
588 $show_question_only,
589 $show_feedback,
590 $show_correct_solution,
591 $show_manual_scoring,
592 $show_question_text,
593 false,
594 $show_inline_feedback
595 );
596 }
assKprimChoiceGUI\renderSolutionOutput
renderSolutionOutput(mixed $user_solutions, int $active_id, ?int $pass, bool $graphical_output=false, bool $result_output=false, bool $show_question_only=true, bool $show_feedback=false, bool $show_correct_solution=false, bool $show_manual_scoring=false, bool $show_question_text=true, bool $show_autosave_title=false, bool $show_inline_feedback=false,)
Definition: class.assKprimChoiceGUI.php:598

◆ getSpecificFeedbackOutput()

assKprimChoiceGUI::getSpecificFeedbackOutput ( array  $userSolution)
Parameters
integer$active_id
integer$pass
Returns
string

Reimplemented from assQuestionGUI.

Definition at line 341 of file class.assKprimChoiceGUI.php.

341 : string
342 {
343 return ''; // question type supports inline answer specific feedback
344 }

◆ getTestOutput()

assKprimChoiceGUI::getTestOutput ( int  $active_id,
int  $pass,
bool  $is_question_postponed = false,
array|bool  $user_post_solutions = false,
bool  $show_specific_inline_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 355 of file class.assKprimChoiceGUI.php.

361 : string {
362 // shuffle output
363 $keys = $this->getParticipantsAnswerKeySequence();
364
365 // get the solution of the user for the active pass or from the last pass if allowed
366 $user_solution = [];
367 if ($active_id) {
368 $solutions = $this->object->getTestOutputSolutions($active_id, $pass);
369 // hey.
370 foreach ($solutions as $idx => $solution_value) {
371 $user_solution[$solution_value["value1"]] = $solution_value["value2"];
372 }
373 }
374
375 $template = new ilTemplate("tpl.il_as_qpl_mc_kprim_output.html", true, true, "components/ILIAS/TestQuestionPool");
376
377 foreach ($keys as $answer_id) {
378 $answer = $this->object->getAnswer($answer_id);
379 if ($answer->getImageFile() !== null
380 && $answer->getImageFile() !== '') {
381 if ($this->object->getThumbSize()) {
382 $template->setCurrentBlock("preview");
383 $template->setVariable("URL_PREVIEW", $answer->getImageWebPath());
384 $template->setVariable("TEXT_PREVIEW", $this->lng->txt('preview'));
385 $template->setVariable("IMG_PREVIEW", ilUtil::getImagePath('media/enlarge.svg'));
386 $template->setVariable("ANSWER_IMAGE_URL", $answer->getThumbWebPath());
387 [$width, $height, $type, $attr] = getimagesize($answer->getImageFsPath());
388 $alt = $answer->getImageFile();
389 if (strlen($answer->getAnswertext())) {
390 $alt = $answer->getAnswertext();
391 }
392 $alt = preg_replace("/<[^>]*?>/", "", $alt);
393 $template->setVariable("ANSWER_IMAGE_ALT", ilLegacyFormElementsUtil::prepareFormOutput($alt));
394 $template->setVariable("ANSWER_IMAGE_TITLE", ilLegacyFormElementsUtil::prepareFormOutput($alt));
395 $template->parseCurrentBlock();
396 } else {
397 $template->setCurrentBlock("answer_image");
398 $template->setVariable("ANSWER_IMAGE_URL", $answer->getImageWebPath());
399 [$width, $height, $type, $attr] = getimagesize($answer->getImageFsPath());
400 $alt = $answer->getImageFile();
401 if (strlen($answer->getAnswertext())) {
402 $alt = $answer->getAnswertext();
403 }
404 $alt = preg_replace("/<[^>]*?>/", "", $alt);
405 $template->setVariable("ATTR", $attr);
406 $template->setVariable("ANSWER_IMAGE_ALT", ilLegacyFormElementsUtil::prepareFormOutput($alt));
407 $template->setVariable("ANSWER_IMAGE_TITLE", ilLegacyFormElementsUtil::prepareFormOutput($alt));
408 $template->parseCurrentBlock();
409 }
410 }
411
412 if ($show_specific_inline_feedback) {
413 $this->populateSpecificFeedbackInline($user_solution, $answer_id, $template);
414 }
415
416 $template->setCurrentBlock("answer_row");
417 $template->setVariable("ANSWER_ID", $answer_id);
418 $template->setVariable("ANSWER_TEXT", $this->renderLatex(
419 ilLegacyFormElementsUtil::prepareTextareaOutput($answer->getAnswertext(), true)
420 ));
421 $template->setVariable('VALUE_TRUE', 1);
422 $template->setVariable('VALUE_FALSE', 0);
423
424 if (isset($user_solution[$answer->getPosition()])) {
425 $tplVar = $user_solution[$answer->getPosition()] ? 'CHECKED_ANSWER_TRUE' : 'CHECKED_ANSWER_FALSE';
426 $template->setVariable($tplVar, " checked=\"checked\"");
427 }
428
429 $template->parseCurrentBlock();
430 }
431
432 $template->setVariable("QUESTIONTEXT", $this->renderLatex($this->object->getQuestionForHTMLOutput()));
433 $template->setVariable("INSTRUCTIONTEXT", $this->object->getInstructionTextTranslation(
434 $this->lng,
435 $this->object->getOptionLabel()
436 ));
437
438 $template->setVariable("OPTION_LABEL_TRUE", $this->object->getTrueOptionLabelTranslation(
439 $this->lng,
440 $this->object->getOptionLabel()
441 ));
442
443 $template->setVariable("OPTION_LABEL_FALSE", $this->object->getFalseOptionLabelTranslation(
444 $this->lng,
445 $this->object->getOptionLabel()
446 ));
447
448 $questionoutput = $template->get();
449 $pageoutput = $this->outQuestionPage("", $is_question_postponed, $active_id, $questionoutput, $show_specific_inline_feedback);
450 return $pageoutput;
451 }
assQuestionGUI\outQuestionPage
outQuestionPage($a_temp_var, $a_postponed=false, $active_id="", $html="", $inlineFeedbackEnabled=false)
Definition: class.assQuestionGUI.php:643

◆ handleAnswerTextsSubmit()

assKprimChoiceGUI::handleAnswerTextsSubmit (   $answers)
private

Definition at line 323 of file class.assKprimChoiceGUI.php.

324 {
325 if ($this->object->getAnswerType() == assKprimChoice::ANSWER_TYPE_MULTI_LINE) {
326 return $answers;
327 }
328
329 foreach ($answers as $key => $answer) {
330 $answer->setAnswerText(ilUtil::secureString(htmlspecialchars($answer->getAnswerText())));
331 }
332
333 return $answers;
334 }
ilUtil\secureString
static secureString(string $a_str, bool $a_strip_html=true, string $a_allow="")
Definition: class.ilUtil.php:421

References assKprimChoice\ANSWER_TYPE_MULTI_LINE, ILIAS\Repository\object(), and ilUtil\secureString().

+ Here is the call graph for this function:

◆ hasInlineFeedback()

assKprimChoiceGUI::hasInlineFeedback ( )
Returns
bool

Reimplemented from assQuestionGUI.

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

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

References ILIAS\Repository\object().

+ Here is the call graph for this function:

◆ populateAnswerSpecificFormPart()

assKprimChoiceGUI::populateAnswerSpecificFormPart ( ilPropertyFormGUI  $form,
?string  $answer_type = null 
)

Definition at line 282 of file class.assKprimChoiceGUI.php.

282 : ilPropertyFormGUI
283 {
284 $answer_type ??= $this->object->getAnswerType();
285
286 $answers = new ilKprimChoiceWizardInputGUI($this->lng->txt('answers'), 'kprimanswers');
287 $answers->setInfo($this->lng->txt('kprim_answers_info') . ' ' . $this->lng->txt('latex_edit_info'));
288 $answers->setSize(64);
289 $answers->setRequired(true);
290 $answers->setAllowMove(true);
291 $answers->setQuestionObject($this->object);
292 $answers->setSingleline($this->object->isSingleLineAnswerType($answer_type));
293 $answers->setValues($this->object->getAnswers());
294 $form->addItem($answers);
295
296 return $form;
297 }

References ilPropertyFormGUI\addItem(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

+ Here is the call graph for this function:

◆ populateCorrectionsFormProperties()

assKprimChoiceGUI::populateCorrectionsFormProperties ( ilPropertyFormGUI  $form)

Reimplemented from assQuestionGUI.

Definition at line 895 of file class.assKprimChoiceGUI.php.

895 : void
896 {
897 // points
898 $points = new ilNumberInputGUI($this->lng->txt('points'), 'points');
899 $points->setRequired(true);
900 $points->setSize(3);
901 $points->allowDecimals(true);
902 $points->setMinValue(0);
903 $points->setMinvalueShouldBeGreater(true);
904 $points->setValue($this->object->getPoints());
905 $form->addItem($points);
906
907 // score partial solution
908 $scorePartialSolution = new ilCheckboxInputGUI($this->lng->txt('score_partsol_enabled'), 'score_partsol_enabled');
909 $scorePartialSolution->setInfo($this->lng->txt('score_partsol_enabled_info'));
910 $scorePartialSolution->setChecked($this->object->isScorePartialSolutionEnabled());
911 $form->addItem($scorePartialSolution);
912
913 // answers
914 $kprimAnswers = new ilKprimChoiceCorrectionsInputGUI($this->lng->txt('answers'), 'kprimanswers');
915 $kprimAnswers->setInfo($this->lng->txt('kprim_answers_info'));
916 $kprimAnswers->setSize(64);
917 $kprimAnswers->setMaxLength(1000);
918 $kprimAnswers->setRequired(true);
919 $kprimAnswers->setQuestionObject($this->object);
920 $kprimAnswers->setValues($this->object->getAnswers());
921 $form->addItem($kprimAnswers);
922 }
ilCheckboxInputGUI
This class represents a checkbox property in a property form.
Definition: class.ilCheckboxInputGUI.php:28
ilNumberInputGUI
This class represents a number property in a property form.
Definition: class.ilNumberInputGUI.php:28

References ilPropertyFormGUI\addItem(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

+ Here is the call graph for this function:

◆ populateQuestionSpecificFormPart()

assKprimChoiceGUI::populateQuestionSpecificFormPart ( ilPropertyFormGUI  $form,
?string  $answer_type = null 
)

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

167 : ilPropertyFormGUI
168 {
169 // shuffle answers
170 $shuffleAnswers = new ilCheckboxInputGUI($this->lng->txt("shuffle_answers"), "shuffle_answers_enabled");
171 $shuffleAnswers->setChecked($this->object->isShuffleAnswersEnabled());
172 $form->addItem($shuffleAnswers);
173
174 $answer_type ??= $this->object->getAnswerType();
175 if (!$this->object->getSelfAssessmentEditingMode()) {
176 // answer mode (single-/multi-line)
177 $answerType = new ilSelectInputGUI($this->lng->txt('answer_types'), 'answer_type');
178 $answerType->setOptions($this->object->getAnswerTypeSelectOptions($this->lng));
179 $answerType->setValue($answer_type);
180 $form->addItem($answerType);
181 }
182
183 if (!$this->object->getSelfAssessmentEditingMode() && $this->object->isSingleLineAnswerType($answer_type)) {
184 // thumb size
185 $thumb_size = new ilNumberInputGUI($this->lng->txt('thumb_size'), 'thumb_size');
186 $thumb_size->setSuffix($this->lng->txt('thumb_size_unit_pixel'));
187 $thumb_size->setInfo($this->lng->txt('thumb_size_info'));
188 $thumb_size->setDecimals(false);
189 $thumb_size->setMinValue($this->object->getMinimumThumbSize());
190 $thumb_size->setMaxValue($this->object->getMaximumThumbSize());
191 $thumb_size->setSize(6);
192 $thumb_size->setValue($this->object->getThumbSize());
193 } else {
194 $thumb_size = new ilHiddenInputGUI('thumb_size');
195 $thumb_size->setValue($this->object->getThumbSize());
196 }
197 $form->addItem($thumb_size);
198
199 // option label
200 $optionLabel = new ilRadioGroupInputGUI($this->lng->txt('option_label'), 'option_label');
201 $optionLabel->setInfo($this->lng->txt('option_label_info'));
202 $optionLabel->setRequired(true);
203 $optionLabel->setValue($this->object->getOptionLabel());
204 foreach ($this->object->getValidOptionLabelsTranslated($this->lng) as $labelValue => $labelText) {
205 $option = new ilRadioOption($labelText, $labelValue);
206 $optionLabel->addOption($option);
207
208 if ($this->object->isCustomOptionLabel($labelValue)) {
209 $customLabelTrue = new ilTextInputGUI(
210 $this->lng->txt('option_label_custom_true'),
211 'option_label_custom_true'
212 );
213 $customLabelTrue->setValue($this->object->getCustomTrueOptionLabel());
214 $option->addSubItem($customLabelTrue);
215
216 $customLabelFalse = new ilTextInputGUI(
217 $this->lng->txt('option_label_custom_false'),
218 'option_label_custom_false'
219 );
220 $customLabelFalse->setValue($this->object->getCustomFalseOptionLabel());
221 $option->addSubItem($customLabelFalse);
222 }
223 }
224 $form->addItem($optionLabel);
225
226 // points
227 $points = new ilNumberInputGUI($this->lng->txt('points'), 'points');
228 $points->setRequired(true);
229 $points->setSize(3);
230 $points->allowDecimals(true);
231 $points->setMinValue(0);
232 $points->setMinvalueShouldBeGreater(true);
233 $points->setValue($this->object->getPoints());
234 $form->addItem($points);
235
236 // score partial solution
237 $scorePartialSolution = new ilCheckboxInputGUI($this->lng->txt('score_partsol_enabled'), 'score_partsol_enabled');
238 $scorePartialSolution->setInfo($this->lng->txt('score_partsol_enabled_info'));
239 $scorePartialSolution->setChecked($this->object->isScorePartialSolutionEnabled());
240 $form->addItem($scorePartialSolution);
241
242 return $form;
243 }
ilHiddenInputGUI
This class represents a hidden form property in a property form.
Definition: class.ilHiddenInputGUI.php:28
ilRadioGroupInputGUI
This class represents a property in a property form.
Definition: class.ilRadioGroupInputGUI.php:28
ilRadioOption
This class represents an option in a radio group.
Definition: class.ilRadioOption.php:28
ilSelectInputGUI
This class represents a selection list property in a property form.
Definition: class.ilSelectInputGUI.php:28
ilTextInputGUI
This class represents a text property in a property form.
Definition: class.ilTextInputGUI.php:28

References ilPropertyFormGUI\addItem(), ILIAS\Repository\lng(), and ILIAS\Repository\object().

+ Here is the call graph for this function:

◆ populateSpecificFeedbackInline()

assKprimChoiceGUI::populateSpecificFeedbackInline (   $user_solution,
  $answer_id,
  $template 
)
private

Definition at line 766 of file class.assKprimChoiceGUI.php.

766 : void
767 {
768 if ($this->object->getSpecificFeedbackSetting() == ilAssConfigurableMultiOptionQuestionFeedback::FEEDBACK_SETTING_CHECKED) {
769 if (isset($user_solution[$answer_id])) {
770 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), 0, $answer_id);
771 if (strlen($fb)) {
772 $template->setCurrentBlock("feedback");
773 $template->setVariable("FEEDBACK", $this->renderLatex(
774 ilLegacyFormElementsUtil::prepareTextareaOutput($fb, true)
775 ));
776 $template->parseCurrentBlock();
777 }
778 }
779 }
780
781 if ($this->object->getSpecificFeedbackSetting() == ilAssConfigurableMultiOptionQuestionFeedback::FEEDBACK_SETTING_ALL) {
782 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), 0, $answer_id);
783 if (strlen($fb)) {
784 $template->setCurrentBlock("feedback");
785 $template->setVariable("FEEDBACK", $this->renderLatex(
786 ilLegacyFormElementsUtil::prepareTextareaOutput($fb, true)
787 ));
788 $template->parseCurrentBlock();
789 }
790 }
791
792 if ($this->object->getSpecificFeedbackSetting() == ilAssConfigurableMultiOptionQuestionFeedback::FEEDBACK_SETTING_CORRECT) {
793 $answer = $this->object->getAnswer($answer_id);
794
795 if ($answer->getCorrectness()) {
796 $fb = $this->object->feedbackOBJ->getSpecificAnswerFeedbackTestPresentation($this->object->getId(), 0, $answer_id);
797 if (strlen($fb)) {
798 $template->setCurrentBlock("feedback");
799 $template->setVariable("FEEDBACK", $this->renderLatex(
800 ilLegacyFormElementsUtil::prepareTextareaOutput($fb, true)
801 ));
802 $template->parseCurrentBlock();
803 }
804 }
805 }
806 }

References ilAssConfigurableMultiOptionQuestionFeedback\FEEDBACK_SETTING_ALL, ilAssConfigurableMultiOptionQuestionFeedback\FEEDBACK_SETTING_CHECKED, ilAssConfigurableMultiOptionQuestionFeedback\FEEDBACK_SETTING_CORRECT, ILIAS\Repository\object(), and ilLegacyFormElementsUtil\prepareTextareaOutput().

+ Here is the call graph for this function:

◆ removeImage()

assKprimChoiceGUI::removeImage ( )

Definition at line 81 of file class.assKprimChoiceGUI.php.

81 : void
82 {
83 $this->object->removeAnswerImage($this->request_data_collector->getCmdIndex('removeImage'));
84 $this->object->saveToDb();
85 $this->editQuestion();
86 }

◆ renderSolutionOutput()

assKprimChoiceGUI::renderSolutionOutput ( mixed  $user_solutions,
int  $active_id,
?int  $pass,
bool  $graphical_output = false,
bool  $result_output = false,
bool  $show_question_only = true,
bool  $show_feedback = false,
bool  $show_correct_solution = false,
bool  $show_manual_scoring = false,
bool  $show_question_text = true,
bool  $show_autosave_title = false,
bool  $show_inline_feedback = false 
)

Reimplemented from assQuestionGUI.

Definition at line 598 of file class.assKprimChoiceGUI.php.

611 : ?string {
612
613 $user_solution = [];
614 foreach ($user_solutions as $idx => $solution_value) {
615 $user_solution[$solution_value['value1']] = $solution_value['value2'];
616 }
617 $template = new ilTemplate("tpl.il_as_qpl_mc_kprim_output_solution.html", true, true, "components/ILIAS/TestQuestionPool");
618 $keys = $this->getParticipantsAnswerKeySequence();
619 foreach ($keys as $answer_id) {
620 $answer = $this->object->getAnswer($answer_id);
621
622 if (($active_id > 0) &&
623 !$show_correct_solution &&
624 $graphical_output) {
625 $correctness_icon = $this->generateCorrectnessIconsForCorrectness(self::CORRECTNESS_NOT_OK);
626 if (isset($user_solution[$answer->getPosition()]) && $user_solution[$answer->getPosition()] == $answer->getCorrectness()) {
627 $correctness_icon = $this->generateCorrectnessIconsForCorrectness(self::CORRECTNESS_OK);
628 }
629 $template->setCurrentBlock("icon_ok");
630 $template->setVariable("ICON_OK", $correctness_icon);
631 $template->parseCurrentBlock();
632 }
633 if ($answer->getImageFile() !== null
634 && $answer->getImageFile() !== '') {
635 $template->setCurrentBlock("answer_image");
636 if ($this->object->getThumbSize()) {
637 $template->setVariable("ANSWER_IMAGE_URL", $answer->getThumbWebPath());
638 } else {
639 $template->setVariable("ANSWER_IMAGE_URL", $answer->getImageWebPath());
640 }
641
642 $template->setVariable(
643 "ANSWER_IMAGE_ALT",
644 ilLegacyFormElementsUtil::prepareFormOutput(
645 $answer->getImageFile()
646 )
647 );
648 $template->setVariable(
649 "ANSWER_IMAGE_TITLE",
650 ilLegacyFormElementsUtil::prepareFormOutput(
651 $answer->getImageFile()
652 )
653 );
654 $template->parseCurrentBlock();
655 }
656
657 if ($show_feedback) {
658 $this->populateSpecificFeedbackInline($user_solution, $answer_id, $template);
659 }
660
661 $template->setCurrentBlock("answer_row");
662 $template->setVariable("ANSWER_TEXT", $this->renderLatex(
663 ilLegacyFormElementsUtil::prepareTextareaOutput($answer->getAnswertext(), true)
664 ));
665
666 if ($this->renderPurposeSupportsFormHtml() || $this->isRenderPurposePrintPdf()) {
667 if (isset($user_solution[$answer->getPosition()])) {
668 if ($user_solution[$answer->getPosition()]) {
669 $template->setVariable("SOLUTION_IMAGE_TRUE", ilUtil::getHtmlPath(ilUtil::getImagePath("object/radiobutton_checked.png")));
670 $template->setVariable("SOLUTION_ALT_TRUE", $this->lng->txt("checked"));
671 $template->setVariable("SOLUTION_IMAGE_FALSE", ilUtil::getHtmlPath(ilUtil::getImagePath("object/radiobutton_unchecked.png")));
672 $template->setVariable("SOLUTION_ALT_FALSE", $this->lng->txt("unchecked"));
673 } else {
674 $template->setVariable("SOLUTION_IMAGE_TRUE", ilUtil::getHtmlPath(ilUtil::getImagePath("object/radiobutton_unchecked.png")));
675 $template->setVariable("SOLUTION_ALT_TRUE", $this->lng->txt("unchecked"));
676 $template->setVariable("SOLUTION_IMAGE_FALSE", ilUtil::getHtmlPath(ilUtil::getImagePath("object/radiobutton_checked.png")));
677 $template->setVariable("SOLUTION_ALT_FALSE", $this->lng->txt("checked"));
678 }
679 } else {
680 $template->setVariable("SOLUTION_IMAGE_TRUE", ilUtil::getHtmlPath(ilUtil::getImagePath("object/radiobutton_unchecked.png")));
681 $template->setVariable("SOLUTION_ALT_TRUE", $this->lng->txt("unchecked"));
682 $template->setVariable("SOLUTION_IMAGE_FALSE", ilUtil::getHtmlPath(ilUtil::getImagePath("object/radiobutton_unchecked.png")));
683 $template->setVariable("SOLUTION_ALT_FALSE", $this->lng->txt("unchecked"));
684 }
685 } else {
686 $template->setVariable('SOL_QID', $this->object->getId());
687 $template->setVariable('SOL_SUFFIX', $show_correct_solution ? 'bestsolution' : 'usersolution');
688 $template->setVariable('SOL_POSITION', $answer->getPosition());
689
690 $template->setVariable('SOL_TRUE_VALUE', 1);
691 $template->setVariable('SOL_FALSE_VALUE', 0);
692
693 if (isset($user_solution[$answer->getPosition()])) {
694 if ($user_solution[$answer->getPosition()]) {
695 $template->setVariable('SOL_TRUE_CHECKED', 'checked');
696 } else {
697 $template->setVariable('SOL_FALSE_CHECKED', 'checked');
698 }
699 }
700 }
701
702 $template->parseCurrentBlock();
703 }
704
705 if ($show_question_text == true) {
706 $questiontext = $this->object->getQuestionForHTMLOutput();
707 if ($show_feedback && $this->hasInlineFeedback()) {
708 $questiontext .= $this->buildFocusAnchorHtml();
709 }
710 $template->setVariable("QUESTIONTEXT", ilLegacyFormElementsUtil::prepareTextareaOutput($questiontext, true));
711
712 $template->setVariable("INSTRUCTIONTEXT", $this->object->getInstructionTextTranslation(
713 $this->lng,
714 $this->object->getOptionLabel()
715 ));
716 }
717
718 $template->setVariable("OPTION_LABEL_TRUE", $this->object->getTrueOptionLabelTranslation(
719 $this->lng,
720 $this->object->getOptionLabel()
721 ));
722
723 $template->setVariable("OPTION_LABEL_FALSE", $this->object->getFalseOptionLabelTranslation(
724 $this->lng,
725 $this->object->getOptionLabel()
726 ));
727
728
729 $questionoutput = $template->get();
730 $feedback = ($show_feedback && !$this->isTestPresentationContext()) ? $this->getGenericFeedbackOutput((int) $active_id, $pass) : "";
731
732 $solutiontemplate = new ilTemplate("tpl.il_as_tst_solution_output.html", true, true, "components/ILIAS/TestQuestionPool");
733
734 if (strlen($feedback)) {
735 $cssClass = (
736 $this->hasCorrectSolution($active_id, $pass) ?
737 ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_CORRECT : ilAssQuestionFeedback::CSS_CLASS_FEEDBACK_WRONG
738 );
739
740 $solutiontemplate->setVariable("ILC_FB_CSS_CLASS", $cssClass);
741 $solutiontemplate->setVariable("FEEDBACK", ilLegacyFormElementsUtil::prepareTextareaOutput($feedback, true));
742 }
743
744 $solutiontemplate->setVariable("SOLUTION_OUTPUT", $questionoutput);
745
746 $solutionoutput = $solutiontemplate->get();
747
748 if (!$show_question_only) {
749 // get page object output
750 $solutionoutput = $this->getILIASPage($solutionoutput);
751 }
752 return $solutionoutput;
753 }
assQuestionGUI\getGenericFeedbackOutput
getGenericFeedbackOutput(int $active_id, ?int $pass)
Definition: class.assQuestionGUI.php:1006
assQuestionGUI\hasCorrectSolution
hasCorrectSolution($activeId, $passIndex)
Definition: class.assQuestionGUI.php:1629
assQuestionGUI\generateCorrectnessIconsForCorrectness
generateCorrectnessIconsForCorrectness(int $correctness)
Definition: class.assQuestionGUI.php:1820
ilUtil\getHtmlPath
static getHtmlPath(string $relative_path)
get url of path
Definition: class.ilUtil.php:111

◆ saveCorrectionsFormProperties()

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

Reimplemented from assQuestionGUI.

Definition at line 927 of file class.assKprimChoiceGUI.php.

927 : void
928 {
929 $this->object->setPoints(
930 (float) str_replace(',', '.', $form->getInput('points'))
931 );
932
933 $this->object->setScorePartialSolutionEnabled(
934 (bool) $form->getInput('score_partsol_enabled')
935 );
936
937 $this->object->setAnswers(
938 $form->getItemByPostVar('kprimanswers')->getValues()
939 );
940 }
ilPropertyFormGUI\getInput
getInput(string $a_post_var, bool $ensureValidation=true)
Returns the input of an item, if item provides getInput method and as fallback the value of the HTTP-...
Definition: class.ilPropertyFormGUI.php:449
ilPropertyFormGUI\getItemByPostVar
getItemByPostVar(string $a_post_var)
Definition: class.ilPropertyFormGUI.php:251

References ilPropertyFormGUI\getInput(), and ilPropertyFormGUI\getItemByPostVar().

+ Here is the call graph for this function:

◆ upkprimanswers()

assKprimChoiceGUI::upkprimanswers ( )

Definition at line 99 of file class.assKprimChoiceGUI.php.

99 : void
100 {
101 $index = $this->request_data_collector->getCmdIndex(__FUNCTION__);
102 if (!empty($index)) {
103 $this->object->moveAnswerUp($index);
104 $this->object->saveToDb();
105 }
106
107 $this->editQuestion();
108 }

◆ uploadImage()

assKprimChoiceGUI::uploadImage ( )

Definition at line 72 of file class.assKprimChoiceGUI.php.

72 : void
73 {
74 $this->setAdditionalContentEditingModeFromPost();
75 if ($this->writePostData(true) === 0) {
76 $this->object->saveToDb();
77 $this->editQuestion();
78 }
79 }
assKprimChoiceGUI\writePostData
writePostData(bool $always=false)
{Evaluates a posted edit form and writes the form data in the question object.integer A positive valu...
Definition: class.assKprimChoiceGUI.php:113

◆ writeAnswerSpecificPostData()

assKprimChoiceGUI::writeAnswerSpecificPostData ( ilPropertyFormGUI  $form)
Parameters
ilPropertyFormGUI$form

Implements ilGuiAnswerScoringAdjustable.

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

302 : void
303 {
304 $answers = $this->handleAnswerTextsSubmit(
305 $form->getItemByPostVar('kprimanswers')->getValues()
306 );
307 $files = $form->getItemByPostVar('kprimanswers')->getFiles();
308
309 $this->object->handleFileUploads($answers, $files);
310
311 if ($this->rebuild_thumbnails) {
312 $answers = $this->object->rebuildThumbnails(
313 $this->object->getAnswerType(),
314 $this->object->getThumbSize(),
315 $this->object->getImagePath(),
316 $answers
317 );
318 }
319
320 $this->object->setAnswers($answers);
321 }

References ilPropertyFormGUI\getItemByPostVar(), and ILIAS\Repository\object().

+ Here is the call graph for this function:

◆ writePostData()

assKprimChoiceGUI::writePostData ( bool  $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 113 of file class.assKprimChoiceGUI.php.

113 : int
114 {
115 $form = $this->buildEditForm();
116 $form->setValuesByPost();
117 $answers_input = $form->getItemByPostVar('kprimanswers');
118
119 if ($always && $answers_input instanceof ilFormPropertyGUI) {
120 $answers_input->setIgnoreMissingUploadsEnabled(true);
121 $answer_input_postvar = $this->request_data_collector->strArray($answers_input->getPostVar(), 2);
122
123 if (!$answers_input->checkUploads($answer_input_postvar)) {
124 $this->tpl->setOnScreenMessage('failure', $this->lng->txt('form_input_not_valid'));
125 $this->edit_form = $form;
126 $this->editQuestion();
127 return 1;
128 }
129
130 $answers_input->collectValidFiles();
131 } elseif (!$form->checkInput()) {
132 $this->edit_form = $form;
133 $this->editQuestion();
134 return 1;
135 }
136
137 $this->writeQuestionGenericPostData();
138
139 $this->writeQuestionSpecificPostData($form);
140 $this->writeAnswerSpecificPostData($form);
141
142 $this->saveTaxonomyAssignments();
143
144 return 0;
145 }
assKprimChoiceGUI\writeAnswerSpecificPostData
writeAnswerSpecificPostData(ilPropertyFormGUI $form)
Definition: class.assKprimChoiceGUI.php:302
assKprimChoiceGUI\writeQuestionSpecificPostData
writeQuestionSpecificPostData(ilPropertyFormGUI $form)
Definition: class.assKprimChoiceGUI.php:248
ilFormPropertyGUI
This class represents a property in a property form.
Definition: class.ilFormPropertyGUI.php:32

References ILIAS\Repository\lng().

+ Here is the call graph for this function:

◆ writeQuestionSpecificPostData()

assKprimChoiceGUI::writeQuestionSpecificPostData ( ilPropertyFormGUI  $form)
Parameters
ilPropertyFormGUI$form

Implements ilGuiQuestionScoringAdjustable.

Definition at line 248 of file class.assKprimChoiceGUI.php.

248 : void
249 {
250 $old_answer_type = $this->object->getAnswerType();
251
252 $this->object->setShuffleAnswersEnabled($form->getItemByPostVar('shuffle_answers_enabled')->getChecked());
253
254 if (!$this->object->getSelfAssessmentEditingMode()) {
255 $this->object->setAnswerType($form->getItemByPostVar('answer_type')->getValue());
256 }
257
258 if (!$this->object->getSelfAssessmentEditingMode() && $this->object->isSingleLineAnswerType($old_answer_type)) {
259 $thumbsize = (int) ($form->getItemByPostVar('thumb_size')->getValue() ?? $this->object->getThumbSize());
260 if ($thumbsize !== $this->object->getThumbSize()) {
261 $this->object->setThumbSize($thumbsize);
262 $this->rebuild_thumbnails = true;
263 }
264 }
265
266 $this->object->setOptionLabel($form->getItemByPostVar('option_label')->getValue());
267
268 if ($this->object->isCustomOptionLabel($this->object->getOptionLabel())) {
269 $this->object->setCustomTrueOptionLabel(strip_tags(
270 $form->getItemByPostVar('option_label_custom_true')->getValue()
271 ));
272 $this->object->setCustomFalseOptionLabel(strip_tags(
273 $form->getItemByPostVar('option_label_custom_false')->getValue()
274 ));
275 }
276
277 $this->object->setPoints($form->getItemByPostVar('points')->getValue());
278
279 $this->object->setScorePartialSolutionEnabled($form->getItemByPostVar('score_partsol_enabled')->getChecked());
280 }

References ilPropertyFormGUI\getItemByPostVar(), ILIAS\Repository\int(), and ILIAS\Repository\object().

+ Here is the call graph for this function:

Field Documentation

◆ $edit_form

ilPropertyFormGUI assKprimChoiceGUI::$edit_form = null
private

Definition at line 30 of file class.assKprimChoiceGUI.php.

◆ $rebuild_thumbnails

bool assKprimChoiceGUI::$rebuild_thumbnails = false
private

Definition at line 29 of file class.assKprimChoiceGUI.php.

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