ILIAS
Release_4_4_x_branch Revision 61816
|
Multiple choice question GUI representation. More...
Public Member Functions | |
__construct ($id=-1) | |
assMultipleChoiceGUI constructor | |
writePostData ($always=false) | |
Evaluates a posted edit form and writes the form data in the question object. | |
editQuestion ($checkonly=FALSE) | |
Creates an output of the edit form for the question. | |
uploadchoice () | |
Upload an image. | |
removeimagechoice () | |
Remove an image. | |
addchoice () | |
Add a new answer. | |
removechoice () | |
Remove an answer. | |
outQuestionForTest ($formaction, $active_id, $pass=NULL, $is_question_postponed=FALSE, $user_post_solutions=FALSE, $show_specific_inline_feedback=FALSE) | |
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. | |
getPreview ($show_question_only=FALSE) | |
getTestOutput ($active_id, $pass=NULL, $is_postponed=FALSE, $use_post_solutions=FALSE, $show_feedback=FALSE) | |
setQuestionTabs () | |
Sets the ILIAS tabs for this question type. | |
getChoiceKeys () | |
Create the key index numbers for the array of choices. | |
getSpecificFeedbackOutput ($active_id, $pass) | |
Returns the answer specific feedback for the question. | |
writeQuestionSpecificPostData ($always=false) | |
Extracts the question specific values from $_POST and applies them to the data object. | |
writeAnswerSpecificPostData ($always=false) | |
Extracts the answer specific values from $_POST and applies them to the data object. | |
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. | |
getAfterParticipationSuppressionQuestionPostVars () | |
Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment. | |
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. | |
aggregateAnswers ($relevant_answers_chosen, $answers_defined_on_question) | |
aggregateAnswerVariants ($relevant_answers_chosen) | |
renderAggregateView ($aggregate) | |
renderVariantsView ($aggregate, $answers) | |
Public Member Functions inherited from assQuestionGUI | |
__construct () | |
assQuestionGUI constructor | |
& | executeCommand () |
execute command | |
getCommand ($cmd) | |
getType () | |
needed for page editor compliance | |
setTaxonomyIds ($taxonomyIds) | |
getTaxonomyIds () | |
setTargetGui (ilTestPlayerAbstractGUI $linkTargetGui) | |
setTargetGuiClass ($targetGuiClass) | |
getTargetGuiClass () | |
writePostData () | |
Evaluates a posted edit form and writes the form data in the question object. | |
assessment () | |
output assessment | |
& | _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. | |
_getGUIClassNameForId ($a_q_id) | |
_getClassNameForQType ($q_type) | |
& | createQuestionGUI ($question_type, $question_id=-1) |
Creates a question gui representation. | |
getQuestionTemplate () | |
get question template | |
getILIASPage ($html="") | |
Returns the ILIAS Page around a question. | |
outQuestionPage ($a_temp_var, $a_postponed=false, $active_id="", $html="") | |
output question page | |
cancel () | |
cancel action | |
originalSyncForm ($return_to="", $return_to_feedback= '') | |
sync () | |
cancelSync () | |
saveEdit () | |
save question | |
save () | |
save question | |
saveReturn () | |
save question | |
apply () | |
apply changes | |
getContextPath ($cont_obj, $a_endnode_id, $a_startnode_id=1) | |
get context path in content object tree | |
setSequenceNumber ($nr) | |
getSequenceNumber () | |
setQuestionCount ($a_question_count) | |
getQuestionCount () | |
getErrorMessage () | |
setErrorMessage ($errormessage) | |
addErrorMessage ($errormessage) | |
outAdditionalOutput () | |
getQuestionType () | |
Returns the question type string. | |
getAsValueAttribute ($a_value) | |
Returns a HTML value attribute. | |
addNewIdListener (&$a_object, $a_method, $a_parameters="") | |
Add a listener that is notified with the new question ID, when a new question is saved. | |
callNewIdListeners ($a_new_id) | |
Call the new id listeners. | |
addQuestionFormCommandButtons ($form) | |
Add the command buttons of a question properties form. | |
addBasicQuestionFormProperties ($form) | |
Add basic question form properties: assessment: title, author, description, question, working time. | |
getSelfAssessmentTags () | |
Get tags allowed in question tags in self assessment mode. | |
getAnswerFeedbackOutput ($active_id, $pass) | |
Returns the answer generic feedback depending on the results of the question. | |
getGenericFeedbackOutput ($active_id, $pass) | |
Returns the answer specific feedback for the question. | |
outQuestionType () | |
showSuggestedSolution () | |
suggestedsolution () | |
Allows to add suggested solutions for questions. | |
outSolutionExplorer () | |
saveSuggestedSolution () | |
cancelExplorer () | |
outPageSelector () | |
outChapterSelector () | |
outGlossarySelector () | |
linkChilds () | |
addPG () | |
addST () | |
addGIT () | |
isSaveCommand () | |
isAutosaveable () | |
showHints () | |
Public Member Functions inherited from ilGuiQuestionScoringAdjustable | |
populateQuestionSpecificFormPart (ilPropertyFormGUI $form) | |
Adds the question specific forms parts to a question property form gui. | |
Public Member Functions inherited from ilGuiAnswerScoringAdjustable | |
populateAnswerSpecificFormPart (ilPropertyFormGUI $form) | |
Adds the answer specific form parts to a question property form gui. |
Data Fields | |
$choiceKeys | |
Data Fields inherited from assQuestionGUI | |
const | FORM_MODE_EDIT = 'edit' |
const | FORM_MODE_ADJUST = 'adjust' |
$object | |
$tpl | |
$lng | |
$error | |
$errormessage | |
$sequence_no | |
sequence number in test | |
$question_count | |
question count in test |
Additional Inherited Members | |
Static Public Member Functions inherited from assQuestionGUI | |
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 | |
Protected Member Functions inherited from assQuestionGUI | |
saveTaxonomyAssignments () | |
populateTaxonomyFormSection (ilPropertyFormGUI $form) | |
addTab_QuestionFeedback (ilTabsGUI $tabs) | |
adds the feedback tab to ilTabsGUI | |
addTab_QuestionHints (ilTabsGUI $tabs) | |
adds the hints tab to ilTabsGUI | |
writeQuestionGenericPostData () |
Multiple choice question GUI representation.
The assMultipleChoiceGUI class encapsulates the GUI representation for multiple choice questions.
Definition at line 23 of file class.assMultipleChoiceGUI.php.
assMultipleChoiceGUI::__construct | ( | $id = -1 | ) |
assMultipleChoiceGUI constructor
The constructor takes possible arguments an creates an instance of the assMultipleChoiceGUI object.
integer | $id | The database id of a multiple choice question object public |
Definition at line 35 of file class.assMultipleChoiceGUI.php.
References assQuestionGUI\__construct().
assMultipleChoiceGUI::addchoice | ( | ) |
Add a new answer.
Definition at line 142 of file class.assMultipleChoiceGUI.php.
References $_POST, editQuestion(), and assQuestionGUI\writePostData().
assMultipleChoiceGUI::aggregateAnswers | ( | $relevant_answers_chosen, | |
$answers_defined_on_question | |||
) |
Definition at line 992 of file class.assMultipleChoiceGUI.php.
Referenced by getAggregatedAnswersView().
assMultipleChoiceGUI::aggregateAnswerVariants | ( | $relevant_answers_chosen | ) |
Definition at line 1017 of file class.assMultipleChoiceGUI.php.
Referenced by getAggregatedAnswersView().
assMultipleChoiceGUI::editQuestion | ( | $checkonly = FALSE | ) |
Creates an output of the edit form for the question.
bool | $checkonly |
Definition at line 74 of file class.assMultipleChoiceGUI.php.
References $_POST, $errors, assQuestionGUI\addBasicQuestionFormProperties(), assQuestionGUI\addQuestionFormCommandButtons(), assQuestionGUI\getQuestionTemplate(), assQuestionGUI\isSaveCommand(), assQuestionGUI\outQuestionType(), populateAnswerSpecificFormPart(), populateQuestionSpecificFormPart(), and assQuestionGUI\populateTaxonomyFormSection().
Referenced by addchoice(), removechoice(), removeimagechoice(), uploadchoice(), and writePostData().
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')
Implements ilGuiAnswerScoringAdjustable.
Definition at line 920 of file class.assMultipleChoiceGUI.php.
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')
Implements ilGuiQuestionScoringAdjustable.
Definition at line 934 of file class.assMultipleChoiceGUI.php.
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.
array | $relevant_answers |
Implements ilGuiQuestionScoringAdjustable.
Definition at line 957 of file class.assMultipleChoiceGUI.php.
References assQuestionGUI\$tpl, aggregateAnswers(), aggregateAnswerVariants(), renderAggregateView(), and renderVariantsView().
assMultipleChoiceGUI::getChoiceKeys | ( | ) |
Create the key index numbers for the array of choices.
Definition at line 746 of file class.assMultipleChoiceGUI.php.
References $_GET, $_SESSION, and $choiceKeys.
Referenced by getPreview(), getSolutionOutput(), and getTestOutput().
assMultipleChoiceGUI::getPreview | ( | $show_question_only = FALSE | ) |
Definition at line 429 of file class.assMultipleChoiceGUI.php.
References getChoiceKeys(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), and ilUtil\prepareFormOutput().
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.
integer | $active_id | The active user id |
integer | $pass | The test pass |
boolean | $graphicalOutput | Show visual feedback for right/wrong answers |
boolean | $result_output | Show the reached points for parts of the question |
boolean | $show_question_only | Show the question without the ILIAS content around |
boolean | $show_feedback | Show the question feedback |
boolean | $show_correct_solution | Show the correct solution instead of the user solution |
boolean | $show_manual_scoring | Show specific information for the manual scoring output |
bool | $show_question_text |
Reimplemented from assQuestionGUI.
Definition at line 205 of file class.assMultipleChoiceGUI.php.
References $ok, $pass, assQuestionGUI\getAnswerFeedbackOutput(), getChoiceKeys(), ilUtil\getHtmlPath(), ilUtil\getImagePath(), and ilUtil\prepareFormOutput().
assMultipleChoiceGUI::getSpecificFeedbackOutput | ( | $active_id, | |
$pass | |||
) |
Returns the answer specific feedback for the question.
This method should be overwritten by the actual question.
integer | $active_id | Active ID of the user |
integer | $pass | Active pass |
Reimplemented from assQuestionGUI.
Definition at line 764 of file class.assMultipleChoiceGUI.php.
assMultipleChoiceGUI::getTestOutput | ( | $active_id, | |
$pass = NULL , |
|||
$is_postponed = FALSE , |
|||
$use_post_solutions = FALSE , |
|||
$show_feedback = FALSE |
|||
) |
integer | $active_id | |
integer | null | $pass | |
bool | $is_postponed | |
bool | $use_post_solutions | |
bool | $show_feedback |
Definition at line 502 of file class.assMultipleChoiceGUI.php.
References $pass, ilObjTest\_getPass(), ilObjTest\_getUsePreviousAnswers(), getChoiceKeys(), ilUtil\getImagePath(), assQuestionGUI\outQuestionPage(), and ilUtil\prepareFormOutput().
Referenced by outQuestionForTest().
assMultipleChoiceGUI::outQuestionForTest | ( | $formaction, | |
$active_id, | |||
$pass = NULL , |
|||
$is_question_postponed = FALSE , |
|||
$user_post_solutions = FALSE , |
|||
$show_specific_inline_feedback = FALSE |
|||
) |
string | $formaction | |
integer | $active_id | |
integer | null | $pass | |
bool | $is_question_postponed | |
bool | $user_post_solutions | |
bool | $show_specific_inline_feedback |
Definition at line 169 of file class.assMultipleChoiceGUI.php.
References $pass, and getTestOutput().
assMultipleChoiceGUI::populateAnswerSpecificFormPart | ( | \ilPropertyFormGUI | $form | ) |
Definition at line 888 of file class.assMultipleChoiceGUI.php.
References $_POST, ilPropertyFormGUI\addItem(), and ilFormPropertyGUI\setRequired().
Referenced by editQuestion().
assMultipleChoiceGUI::populateQuestionSpecificFormPart | ( | \ilPropertyFormGUI | $form | ) |
Definition at line 838 of file class.assMultipleChoiceGUI.php.
References $_POST, ilPropertyFormGUI\addItem(), ilFormPropertyGUI\setRequired(), ilNumberInputGUI\setSuffix(), and ilCheckboxInputGUI\setValue().
Referenced by editQuestion().
assMultipleChoiceGUI::removechoice | ( | ) |
Remove an answer.
Definition at line 153 of file class.assMultipleChoiceGUI.php.
References $_POST, editQuestion(), and assQuestionGUI\writePostData().
assMultipleChoiceGUI::removeimagechoice | ( | ) |
Remove an image.
Definition at line 130 of file class.assMultipleChoiceGUI.php.
References $_POST, $filename, editQuestion(), and assQuestionGUI\writePostData().
assMultipleChoiceGUI::renderAggregateView | ( | $aggregate | ) |
$aggregate |
Definition at line 1047 of file class.assMultipleChoiceGUI.php.
References assQuestionGUI\$tpl.
Referenced by getAggregatedAnswersView().
assMultipleChoiceGUI::renderVariantsView | ( | $aggregate, | |
$answers | |||
) |
Definition at line 1063 of file class.assMultipleChoiceGUI.php.
References $options, and assQuestionGUI\$tpl.
Referenced by getAggregatedAnswersView().
assMultipleChoiceGUI::setQuestionTabs | ( | ) |
Sets the ILIAS tabs for this question type.
Reimplemented from assQuestionGUI.
Definition at line 648 of file class.assMultipleChoiceGUI.php.
References $_GET, $ref_id, assQuestionGUI\addTab_QuestionFeedback(), assQuestionGUI\addTab_QuestionHints(), and ilTestExpressPage\getReturnToPageLink().
assMultipleChoiceGUI::uploadchoice | ( | ) |
Upload an image.
Definition at line 120 of file class.assMultipleChoiceGUI.php.
References $_POST, editQuestion(), and assQuestionGUI\writePostData().
assMultipleChoiceGUI::writeAnswerSpecificPostData | ( | $always = false | ) |
Extracts the answer specific values from $_POST and applies them to the data object.
bool | $always | If true, a check for form validity is omitted. |
Implements ilGuiAnswerScoringAdjustable.
Definition at line 790 of file class.assMultipleChoiceGUI.php.
References $_POST, and $filename.
Referenced by writePostData().
assMultipleChoiceGUI::writePostData | ( | $always = false | ) |
Evaluates a posted edit form and writes the form data in the question object.
bool | $always |
Definition at line 53 of file class.assMultipleChoiceGUI.php.
References editQuestion(), assQuestionGUI\saveTaxonomyAssignments(), writeAnswerSpecificPostData(), assQuestionGUI\writeQuestionGenericPostData(), and writeQuestionSpecificPostData().
assMultipleChoiceGUI::writeQuestionSpecificPostData | ( | $always = false | ) |
Extracts the question specific values from $_POST and applies them to the data object.
bool | $always | If true, a check for form validity is omitted. |
Implements ilGuiQuestionScoringAdjustable.
Definition at line 771 of file class.assMultipleChoiceGUI.php.
References $_POST, and ilUtil\sendInfo().
Referenced by writePostData().
assMultipleChoiceGUI::$choiceKeys |
Definition at line 25 of file class.assMultipleChoiceGUI.php.
Referenced by getChoiceKeys().