 |
Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
|
|
Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
|
Interface that a question_definition must implement to be usable by the manual graded behaviour. More...
Public Member Functions | |
| classify_response (array $response) | |
| Categorise the student's response according to the categories defined by get_possible_responses. More... | |
| is_complete_response (array $response) | |
| Used by many of the behaviours, to work out whether the student's response to the question is complete. More... | |
| is_gradable_response (array $response) | |
| Use by many of the behaviours to determine whether the student has provided enough of an answer for the question to be graded automatically, or whether it must be considered aborted. More... | |
| is_same_response (array $prevresponse, array $newresponse) | |
| Use by many of the behaviours to determine whether the student's response has changed. More... | |
| summarise_response (array $response) | |
| Produce a plain text summary of a response. More... | |
| un_summarise_response (string $summary) | |
| If possible, construct a response that could have lead to the given response summary. More... | |
Interface that a question_definition must implement to be usable by the manual graded behaviour.
| question_manually_gradable::classify_response | ( | array | $response | ) |
Categorise the student's response according to the categories defined by get_possible_responses.
| $response | a response, as might be passed to grade_response(). |
| array | subpartid => question_classified_response objects. returns an empty array if no analysis is possible. |
Implemented in qtype_ddtoimage_question_base, qtype_ddmarker_question, qtype_gapselect_question_base, qtype_match_question, qtype_missingtype_question, qtype_multichoice_single_question, qtype_multichoice_multi_question, qtype_numerical_question, question_with_responses, question_graded_by_strategy, and qtype_truefalse_question.
| question_manually_gradable::is_complete_response | ( | array | $response | ) |
Used by many of the behaviours, to work out whether the student's response to the question is complete.
That is, whether the question attempt should move to the COMPLETE or INCOMPLETE state.
| array | $response | responses, as returned by question_attempt_step::get_qt_data(). |
| bool | whether this response is a complete answer to this question. |
Implemented in qtype_ddmarker_question, qtype_essay_question, qtype_gapselect_question_base, qtype_match_question, qtype_missingtype_question, qtype_multianswer_question, qtype_multichoice_single_question, qtype_multichoice_multi_question, qtype_numerical_question, qtype_shortanswer_question, and qtype_truefalse_question.
| question_manually_gradable::is_gradable_response | ( | array | $response | ) |
Use by many of the behaviours to determine whether the student has provided enough of an answer for the question to be graded automatically, or whether it must be considered aborted.
| array | $response | responses, as returned by question_attempt_step::get_qt_data(). |
| bool | whether this response can be graded. |
Implemented in qtype_ddmarker_question, qtype_essay_question, qtype_gapselect_question_base, qtype_match_question, qtype_missingtype_question, qtype_multianswer_question, qtype_multichoice_single_question, qtype_multichoice_multi_question, qtype_numerical_question, and question_with_responses.
| question_manually_gradable::is_same_response | ( | array | $prevresponse, |
| array | $newresponse | ||
| ) |
Use by many of the behaviours to determine whether the student's response has changed.
This is normally used to determine that a new set of responses can safely be discarded.
| array | $prevresponse | the responses previously recorded for this question, as returned by question_attempt_step::get_qt_data() |
| array | $newresponse | the new responses, in the same format. |
| bool | whether the two sets of responses are the same - that is whether the new set of responses can safely be discarded. |
Implemented in qtype_ddmarker_question, qtype_essay_question, qtype_gapselect_question_base, qtype_match_question, qtype_missingtype_question, qtype_multianswer_question, qtype_multichoice_single_question, qtype_multichoice_multi_question, qtype_numerical_question, qtype_shortanswer_question, and qtype_truefalse_question.
| question_manually_gradable::summarise_response | ( | array | $response | ) |
Produce a plain text summary of a response.
| array | $response | a response, as might be passed to grade_response(). |
| string | a plain text summary of that response, that could be used in reports. |
Implemented in qtype_ddtoimage_question_base, qtype_ddmarker_question, qtype_essay_question, qtype_gapselect_question_base, qtype_match_question, qtype_missingtype_question, qtype_multianswer_question, qtype_multichoice_single_question, qtype_multichoice_multi_question, qtype_numerical_question, qtype_shortanswer_question, and qtype_truefalse_question.
| question_manually_gradable::un_summarise_response | ( | string | $summary | ) |
If possible, construct a response that could have lead to the given response summary.
This is basically the opposite of summarise_response() but it is intended only to be used for testing.
| string | $summary | a string, which might have come from summarise_response |
| array | a response that could have lead to that. |
Implemented in qtype_missingtype_question, qtype_essay_question, qtype_numerical_question, question_with_responses, qtype_shortanswer_question, and qtype_truefalse_question.
1.9.3