Moodle PHP Documentation 5.1
Moodle 5.1dev (Build: 20250620) (7d9030acd6e)
|
Base class for generating the bits of output common to multianswer (Cloze) questions. More...
Public Member Functions | |
clear_wrong (question_attempt $qa) | |
Output hidden form fields to clear any wrong parts of the student's response. | |
correct_response (question_attempt $qa) | |
Gereate an automatic description of the correct response to this question. | |
feedback (question_attempt $qa, question_display_options $options) | |
Generate the display of the outcome part of the question. | |
formulation_and_controls (question_attempt $qa, question_display_options $options) | |
Generate the display of the formulation part of the question. | |
formulation_heading () | |
In the question output there are some class="accesshide" headers to help screen-readers. | |
head_code (question_attempt $qa) | |
Return any HTML that needs to be included in the page's <head> when this question is used. | |
manual_comment (question_attempt $qa, question_display_options $options) | |
Display any extra question-type specific content that should be visible when grading, if appropriate. | |
subquestion (question_attempt $qa, question_display_options $options, $index, question_automatically_gradable $subq) | |
Protected Member Functions | |
feedback_class ($fraction) | |
feedback_image ($fraction, $selected=true) | |
Return an appropriate icon (green tick, red cross, etc.) for a grade. | |
general_feedback (question_attempt $qa) | |
Gereate the general feedback. | |
hint (question_attempt $qa, question_hint $hint) | |
Gereate the specific feedback. | |
num_parts_correct (question_attempt $qa) | |
Gereate a brief statement of how many sub-parts of this question the student got right. | |
specific_feedback (question_attempt $qa) | |
Generate the specific feedback. | |
Base class for generating the bits of output common to multianswer (Cloze) questions.
This render the main question text and transfer to the subquestions the task of display their input elements and status feedback, grade, correct answer(s)
|
inherited |
Output hidden form fields to clear any wrong parts of the student's response.
This method will only be called if the question is in read-only mode.
question_attempt | $qa | the question attempt to display. |
string | HTML fragment. |
Reimplemented in qtype_ddtoimage_renderer_base.
qtype_multianswer_renderer::correct_response | ( | question_attempt | $qa | ) |
Gereate an automatic description of the correct response to this question.
Not all question types can do this. If it is not possible, this method should just return an empty string.
question_attempt | $qa | the question attempt to display. |
string | HTML fragment. |
Reimplemented from qtype_renderer.
|
inherited |
Generate the display of the outcome part of the question.
This is the area that contains the various forms of feedback. This function generates the content of this area belonging to the question type.
Subclasses will normally want to override the more specific methods {specific_feedback()}, {general_feedback()} and {correct_response()} that this method calls.
question_attempt | $qa | the question attempt to display. |
question_display_options | $options | controls what should and should not be displayed. |
string | HTML fragment. |
Reimplemented in qtype_ordering_renderer.
|
protectedinherited |
Return an appropriate icon (green tick, red cross, etc.) for a grade.
float | $fraction | grade on a scale 0..1. |
bool | $selected | whether to show a big or small icon. (Deprecated) |
string | html fragment. |
Reimplemented in qtype_ordering_renderer.
qtype_multianswer_renderer::formulation_and_controls | ( | question_attempt | $qa, |
question_display_options | $options ) |
Generate the display of the formulation part of the question.
This is the area that contains the quetsion text, and the controls for students to input their answers. Some question types also embed bits of feedback, for example ticks and crosses, in this area.
question_attempt | $qa | the question attempt to display. |
question_display_options | $options | controls what should and should not be displayed. |
string | HTML fragment. |
Reimplemented from qtype_renderer.
|
inherited |
In the question output there are some class="accesshide" headers to help screen-readers.
This method returns the text to use for the heading above the formulation_and_controls section.
string | to use as the heading. |
Reimplemented in qtype_description_renderer.
|
protectedinherited |
Gereate the general feedback.
This is feedback is shown ot all students.
question_attempt | $qa | the question attempt to display. |
string | HTML fragment. |
|
inherited |
Return any HTML that needs to be included in the page's <head> when this question is used.
$qa | the question attempt that will be displayed on the page. |
string | HTML fragment. |
|
protectedinherited |
Gereate the specific feedback.
This is feedback that varies according to the response the student gave.
question_attempt | $qa | the question attempt to display. |
string | HTML fragment. |
Reimplemented in qtype_ddmarker_renderer.
|
inherited |
Display any extra question-type specific content that should be visible when grading, if appropriate.
question_attempt | $qa | a question attempt. |
question_display_options | $options | controls what should and should not be displayed. |
string | HTML fragment. |
Reimplemented in qtype_essay_renderer.
|
protectedinherited |
Gereate a brief statement of how many sub-parts of this question the student got right.
question_attempt | $qa | the question attempt to display. |
string | HTML fragment. |
Reimplemented in qtype_multichoice_multi_renderer, and qtype_ordering_renderer.
|
protectedinherited |
Generate the specific feedback.
This is feedback that varies according to the response the student gave.
question_attempt | $qa | the question attempt to display. |
string | HTML fragment. |
Reimplemented in qtype_ddtoimage_renderer_base, qtype_elements_embedded_in_question_text_renderer, qtype_match_renderer, qtype_multichoice_renderer_base, qtype_numerical_renderer, qtype_ordering_renderer, qtype_shortanswer_renderer, and qtype_truefalse_renderer.