Moodle PHP Documentation 4.4
Moodle 4.4.1 (Build: 20240610) (db07c09afc5)
qtype_gapselect_question_base Class Reference

Represents embedded element in question text question. More...

Inheritance diagram for qtype_gapselect_question_base:
question_graded_automatically_with_countback question_graded_automatically question_automatically_gradable_with_countback question_with_responses question_automatically_gradable question_automatically_gradable question_definition question_manually_gradable question_manually_gradable question_manually_gradable qtype_ddtoimage_question_base qtype_ddwtos_question qtype_gapselect_question qtype_ddimageortext_question qtype_ddmarker_question

Public Member Functions

 __get ($name)
 When a pending definition tries to read its latest version, fill in the latest version for all pending definitions.
 
 apply_attempt_state (question_attempt_step $step)
 When an in-progress question_attempt is re-loaded from the database, this method is called so that the question can re-initialise its internal state as needed by this attempt.
 
 check_file_access ($qa, $options, $component, $filearea, $args, $forcedownload)
 Checks whether the users is allow to be served a particular file.
 
 classify_response (array $response)
 Categorise the student's response according to the categories defined by get_possible_responses.
 
 clear_wrong_from_response (array $response)
 Given a response, rest the parts that are wrong.
 
 compute_final_grade ($responses, $totaltries)
 Work out a final grade for this attempt, taking into account all the tries the student made.
 
 field ($place)
 Get the field name corresponding to a given place.
 
 format_generalfeedback ($qa)
 
 format_hint (question_hint $hint, question_attempt $qa)
 
 format_questiontext ($qa)
 
 format_text ($text, $format, $qa, $component, $filearea, $itemid, $clean=false)
 Apply format_text() to some content with appropriate settings for this question.
 
 get_correct_response ()
 What data would need to be submitted to get this question correct.
 
 get_expected_data ()
 What data may be included in the form submission when a student submits this question in its current state?
 
 get_hint ($hintnumber, question_attempt $qa)
 Get one of the question hints.
 
 get_max_fraction ()
 Some questions can return a mark greater than the maximum.
 
 get_min_fraction ()
 Some questions can return a negative mark if the student gets it wrong.
 
 get_num_parts_right (array $response)
 Return the number of subparts of this response that are right.
 
 get_num_variants ()
 
 get_ordered_choices ($group)
 
 get_question_definition_for_external_rendering (question_attempt $qa, question_display_options $options)
 Return the question settings that define this question as structured data.
 
 get_question_summary ()
 Generate a brief, plain-text, summary of this question.
 
 get_random_guess_score ()
 
 get_renderer (moodle_page $page)
 
 get_right_answer_summary ()
 Generate a brief, plain-text, summary of the correct answer to this question.
 
 get_right_choice_for ($place)
 
 get_student_response_values_for_simulation ($realresponse)
 Does the opposite of prepare_simulated_post_data.
 
 get_type_name ()
 
 get_validation_error (array $response)
 In situations where is_gradable_response() returns false, this method should generate a description of what the problem is.
 
 get_variants_selection_seed ()
 
 grade_response (array $response)
 Grade a response to the question, returning a fraction between get_min_fraction() and get_max_fraction(), and the corresponding question_state right, partial or wrong.
 
 html_to_text ($text, $format)
 Convert some part of the question text to plain text.
 
 is_complete_response (array $response)
 Used by many of the behaviours, to work out whether the student's response to the question is complete.
 
 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.
 
 is_same_response (array $prevresponse, array $newresponse)
 Use by many of the behaviours to determine whether the student's response has changed.
 
 make_behaviour (question_attempt $qa, $preferredbehaviour)
 Creat the appropriate behaviour for an attempt at this quetsion, given the desired (archetypal) behaviour.
 
 make_html_inline ($html)
 Take some HTML that should probably already be a single line, like a multiple choice choice, or the corresponding feedback, and make it so that it is suitable to go in a place where the HTML must be inline, like inside a.
 
 prepare_simulated_post_data ($simulatedresponse)
 Takes an array of values representing a student response represented in a way that is understandable by a human and transforms that to the response as the POST values returned from the HTML form that takes the student response during a student attempt.
 
 set_latest_version (int $latestversion)
 Set the latest version.
 
 start_attempt (question_attempt_step $step, $variant)
 Start a new attempt at this question, storing any information that will be needed later in the step.
 
 summarise_choice ($choice)
 Convert a choice to plain text.
 
 summarise_response (array $response)
 Produce a plain text summary of a response.
 
 un_summarise_response (string $summary)
 If possible, construct a response that could have lead to the given response summary.
 
 update_attempt_state_data_for_new_version (question_attempt_step $oldstep, question_definition $oldquestion)
 Update the data representing the initial state of an attempt another version of this question, to allow for the changes.
 
 validate_can_regrade_with_other_version (question_definition $otherversion)
 Verify if an attempt at this question can be re-graded using the other question version.
 

Public Attributes

integer $category
 question category id.
 
array $choices
 of arrays.
 
integer $contextid
 question context id.
 
string $correctfeedback
 Feedback for any correct response.
 
int $correctfeedbackformat
 format of $correctfeedback.
 
integer $createdby
 userid of the use who created this question.
 
array $customfields = array()
 of array of core_customfield\data_controller objects indexed by fieldid for the questions custom fields.
 
float $defaultmark = 1
 what this quetsion is marked out of, by default.
 
string $generalfeedback
 question general feedback.
 
integer $generalfeedbackformat
 question test format.
 
array $hints = array()
 of question_hints.
 
integer $id
 id of the question in the datase, or null if this question is not in the database.
 
string $idnumber
 question idnumber.
 
string $incorrectfeedback
 Feedback for any incorrect response.
 
int $incorrectfeedbackformat
 format of $incorrectfeedback.
 
integer $length = 1
 How many question numbers this question consumes.
 
integer $modifiedby
 userid of the use who modified this question.
 
string $name
 question name.
 
integer $parent = 0
 parent question id.
 
string $partiallycorrectfeedback
 Feedback for any partially correct response.
 
int $partiallycorrectfeedbackformat
 format of $partiallycorrectfeedback.
 
number $penalty = 0
 penalty factor of this question.
 
array $places
 place number => group number of the places in the question text where choices can be put.
 
question_type $qtype
 the question type this question is.
 
int $questionbankentryid
 Bank entry id for the question.
 
string $questiontext
 question text.
 
integer $questiontextformat
 question test format.
 
array $rightchoices
 index of the right choice for each stem.
 
Some $shownumcorrect = false
 question types have the option to show the number of sub-parts correct.
 
boolean $shufflechoices
 Whether the question stems should be shuffled.
 
string $stamp
 unique identifier of this question.
 
boolean $status = core_question\local\bank\question_version_status::QUESTION_STATUS_READY
 question status hidden/ready/draft in the question bank.
 
array $textfragments
 of strings, one longer than $places, which is achieved by indexing from 0.
 
integer $timecreated
 timestamp when this question was created.
 
integer $timemodified
 timestamp when this question was modified.
 
int $version
 Version number of the question in a question bank.
 
int $versionid
 Version id of the question in a question bank.
 

Protected Member Functions

 check_combined_feedback_file_access ($qa, $options, $filearea, $args=null)
 Check a request for access to a file belonging to a combined feedback field.
 
 check_hint_file_access ($qa, $options, $args)
 Check a request for access to a file belonging to a hint.
 
 get_selected_choice ($group, $shuffledchoicenumber)
 
 set_choiceorder ($group, $choiceorder)
 Helper method used by both start_attempt() and apply_attempt_state().
 

Protected Attributes

array $choiceorder
 shuffled choice indexes.
 
int $latestversion = null
 The latest version of the question.
 

Detailed Description

Represents embedded element in question text question.

Parent of drag and drop and select from drop down list and others.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ __get()

question_definition::__get ( $name)
inherited

When a pending definition tries to read its latest version, fill in the latest version for all pending definitions.

Parameters
string$name
Return values
mixed

◆ apply_attempt_state()

qtype_gapselect_question_base::apply_attempt_state ( question_attempt_step $step)

When an in-progress question_attempt is re-loaded from the database, this method is called so that the question can re-initialise its internal state as needed by this attempt.

For example, the multiple choice question type needs to set the order of the choices to the order that was set up when start_attempt was called originally. All the information required to do this should be in the $step object, which is the first step of the question_attempt being loaded.

Parameters
question_attempt_stepThe first step of the question_attempt being loaded.

Reimplemented from question_definition.

◆ check_combined_feedback_file_access()

question_graded_automatically::check_combined_feedback_file_access ( $qa,
$options,
$filearea,
$args = null )
protectedinherited

Check a request for access to a file belonging to a combined feedback field.

Parameters
question_attempt$qathe question attempt being displayed.
question_display_options$optionsthe options that control display of the question.
string$fileareathe name of the file area.
array$argsthe remaining bits of the file path.
Return values
boolwhether access to the file should be allowed.

Reimplemented in qtype_ordering_question.

◆ check_file_access()

qtype_gapselect_question_base::check_file_access ( $qa,
$options,
$component,
$filearea,
$args,
$forcedownload )

Checks whether the users is allow to be served a particular file.

Parameters
question_attempt$qathe question attempt being displayed.
question_display_options$optionsthe options that control display of the question.
string$componentthe name of the component we are serving files for.
string$fileareathe name of the file area.
array$argsthe remaining bits of the file path.
bool$forcedownloadwhether the user must be forced to download the file.
Return values
booltrue if the user can access this file.

Reimplemented from question_definition.

Reimplemented in qtype_ddmarker_question, and qtype_ddtoimage_question_base.

◆ check_hint_file_access()

question_graded_automatically::check_hint_file_access ( $qa,
$options,
$args )
protectedinherited

Check a request for access to a file belonging to a hint.

Parameters
question_attempt$qathe question attempt being displayed.
question_display_options$optionsthe options that control display of the question.
array$argsthe remaining bits of the file path.
Return values
boolwhether access to the file should be allowed.

◆ classify_response()

qtype_gapselect_question_base::classify_response ( array $response)

Categorise the student's response according to the categories defined by get_possible_responses.

Parameters
$responsea response, as might be passed to grade_response().
Return values
arraysubpartid => question_classified_response objects. returns an empty array if no analysis is possible.

Reimplemented from question_with_responses.

Reimplemented in qtype_ddmarker_question, and qtype_ddtoimage_question_base.

◆ clear_wrong_from_response()

qtype_gapselect_question_base::clear_wrong_from_response ( array $response)

Given a response, rest the parts that are wrong.

Parameters
array$responsea response
Return values
arraya cleaned up response with the wrong bits reset.

Reimplemented from question_definition.

Reimplemented in qtype_ddmarker_question, and qtype_ddtoimage_question_base.

◆ compute_final_grade()

qtype_gapselect_question_base::compute_final_grade ( $responses,
$totaltries )

Work out a final grade for this attempt, taking into account all the tries the student made.

Parameters
array$responsesthe response for each try. Each element of this array is a response array, as would be passed to grade_response(). There may be between 1 and $totaltries responses.
int$totaltriesThe maximum number of tries allowed.
Return values
numericthe fraction that should be awarded for this sequence of response.

Implements question_automatically_gradable_with_countback.

Reimplemented in qtype_ddmarker_question.

◆ field()

qtype_gapselect_question_base::field ( $place)

Get the field name corresponding to a given place.

Parameters
int$placestem number
Return values
stringthe question-type variable name.

◆ format_generalfeedback()

question_definition::format_generalfeedback ( $qa)
inherited
Return values
theresult of applying format_text() to the general feedback.

◆ format_questiontext()

question_definition::format_questiontext ( $qa)
inherited
Return values
theresult of applying format_text() to the question text.

◆ format_text()

question_definition::format_text ( $text,
$format,
$qa,
$component,
$filearea,
$itemid,
$clean = false )
inherited

Apply format_text() to some content with appropriate settings for this question.

Parameters
string$textsome content that needs to be output.
int$formatthe FORMAT_... constant.
question_attempt$qathe question attempt.
string$componentused for rewriting file area URLs.
string$fileareaused for rewriting file area URLs.
bool$cleanWhether the HTML needs to be cleaned. Generally, parts of the question do not need to be cleaned, and student input does.
Return values
stringthe text formatted for output by format_text.

◆ get_correct_response()

qtype_gapselect_question_base::get_correct_response ( )

What data would need to be submitted to get this question correct.

If there is more than one correct answer, this method should just return one possibility. If it is not possible to compute a correct response, this method should return null.

Return values
array|nullparameter name => value.

Reimplemented from question_definition.

Reimplemented in qtype_ddmarker_question.

◆ get_expected_data()

qtype_gapselect_question_base::get_expected_data ( )

What data may be included in the form submission when a student submits this question in its current state?

This information is used in calls to optional_param. The parameter name has question_attempt::get_field_prefix() automatically prepended.

Return values
array|stringvariable name => PARAM_... constant, or, as a special case that should only be used in unavoidable, the constant question_attempt\USE_RAW_DATA meaning take all the raw submitted data belonging to this question.

Reimplemented from question_definition.

Reimplemented in qtype_ddmarker_question.

◆ get_hint()

question_graded_automatically::get_hint ( $hintnumber,
question_attempt $qa )
inherited

Get one of the question hints.

The question_attempt is passed in case the question type wants to do something complex. For example, the multiple choice with multiple responses question type will turn off most of the hint options if the student has selected too many opitions.

Parameters
int$hintnumberWhich hint to display. Indexed starting from 0
question_attempt$qaThe question_attempt.

Implements question_automatically_gradable.

Reimplemented in qtype_multichoice_multi_question.

◆ get_max_fraction()

question_definition::get_max_fraction ( )
inherited

Some questions can return a mark greater than the maximum.

This method returns the lowest highest the question can return, on the fraction scale. that is, where the nominal maximum mark is 1.0.

Return values
floatmaximum fraction this question will ever return.

Reimplemented in qtype_multianswer_question.

◆ get_min_fraction()

question_definition::get_min_fraction ( )
inherited

Some questions can return a negative mark if the student gets it wrong.

This method returns the lowest mark the question can return, on the fraction scale. that is, where the maximum possible mark is 1.0.

Return values
floatminimum fraction this question will ever return.

Reimplemented in qtype_multianswer_question, qtype_multichoice_multi_question, and qtype_multichoice_single_question.

◆ get_num_parts_right()

qtype_gapselect_question_base::get_num_parts_right ( array $response)

Return the number of subparts of this response that are right.

Parameters
array$responsea response
Return values
arraywith two elements, the number of correct subparts, and the total number of subparts.

Reimplemented from question_definition.

Reimplemented in qtype_ddmarker_question.

◆ get_num_variants()

question_definition::get_num_variants ( )
inherited
Return values
intthe number of vaiants that this question has.

Reimplemented in qtype_calculated_question, qtype_calculatedmulti_multi_question, and qtype_calculatedmulti_single_question.

◆ get_question_definition_for_external_rendering()

qtype_gapselect_question_base::get_question_definition_for_external_rendering ( question_attempt $qa,
question_display_options $options )

Return the question settings that define this question as structured data.

Parameters
question_attempt$qathe current attempt for which we are exporting the settings.
question_display_options$optionsthe question display options which say which aspects of the question should be visible.
Return values
mixedstructure representing the question settings. In web services, this will be JSON-encoded.

Reimplemented from question_definition.

◆ get_question_summary()

qtype_gapselect_question_base::get_question_summary ( )

Generate a brief, plain-text, summary of this question.

This is used by various reports. This should show the particular variant of the question as presented to students. For example, the calculated quetsion type would fill in the particular numbers that were presented to the student. This method will return null if such a summary is not possible, or inappropriate.

Return values
string|nulla plain text summary of this question.

Reimplemented from question_definition.

Reimplemented in qtype_ddtoimage_question_base.

◆ get_renderer()

question_definition::get_renderer ( moodle_page $page)
inherited
Parameters
moodle_pagethe page we are outputting to.
Return values
qtype_rendererthe renderer to use for outputting this question.

Reimplemented in qtype_multichoice_multi_question, and qtype_multichoice_single_question.

◆ get_right_answer_summary()

question_graded_automatically::get_right_answer_summary ( )
inherited

Generate a brief, plain-text, summary of the correct answer to this question.

This is used by various reports, and can also be useful when testing. This method will return null if such a summary is not possible, or inappropriate.

Return values
string|nulla plain text summary of the right answer to this question.

Implements question_automatically_gradable.

Reimplemented in qtype_ddmarker_question.

◆ get_student_response_values_for_simulation()

question_definition::get_student_response_values_for_simulation ( $realresponse)
inherited

Does the opposite of prepare_simulated_post_data.

This takes a student response (the POST values returned from the HTML form that takes the student response during a student attempt) it then represents it in a way that is understandable by a human.

Primarily this is used when creating a file of csv from real student responses in order later to be able to simulate the same student interaction with a quiz later.

Parameters
string[]$realresponsethe response array as was returned from the form during a student attempt (without prefixes).
Return values
string[]an array of data representing a student response.

Reimplemented in qtype_match_question, qtype_multianswer_question, qtype_multichoice_multi_question, and qtype_multichoice_single_question.

◆ get_type_name()

question_definition::get_type_name ( )
inherited
Return values
stringthe name of the question type (for example multichoice) that this question is.

◆ get_validation_error()

qtype_gapselect_question_base::get_validation_error ( array $response)

In situations where is_gradable_response() returns false, this method should generate a description of what the problem is.

Return values
stringthe message.

Implements question_automatically_gradable.

Reimplemented in qtype_ddmarker_question, and qtype_ddtoimage_question_base.

◆ get_variants_selection_seed()

question_definition::get_variants_selection_seed ( )
inherited
Return values
stringthat can be used to seed the pseudo-random selection of a variant.

Reimplemented in qtype_calculated_question, qtype_calculatedmulti_multi_question, and qtype_calculatedmulti_single_question.

◆ grade_response()

qtype_gapselect_question_base::grade_response ( array $response)

Grade a response to the question, returning a fraction between get_min_fraction() and get_max_fraction(), and the corresponding question_state right, partial or wrong.

Parameters
array$responseresponses, as returned by question_attempt_step::get_qt_data().
Return values
array(float, integer) the fraction, and the state.

Implements question_automatically_gradable.

Reimplemented in qtype_ddmarker_question.

◆ html_to_text()

question_definition::html_to_text ( $text,
$format )
inherited

Convert some part of the question text to plain text.

This might be used, for example, by get_response_summary().

Parameters
string$textThe HTML to reduce to plain text.
int$formatthe FORMAT_... constant.
Return values
stringthe equivalent plain text.

◆ is_complete_response()

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

Parameters
array$responseresponses, as returned by question_attempt_step::get_qt_data().
Return values
boolwhether this response is a complete answer to this question.

Implements question_manually_gradable.

Reimplemented in qtype_ddmarker_question.

◆ is_gradable_response()

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

Parameters
array$responseresponses, as returned by question_attempt_step::get_qt_data().
Return values
boolwhether this response can be graded.

Reimplemented from question_with_responses.

Reimplemented in qtype_ddmarker_question.

◆ is_same_response()

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

Parameters
array$prevresponsethe responses previously recorded for this question, as returned by question_attempt_step::get_qt_data()
array$newresponsethe new responses, in the same format.
Return values
boolwhether the two sets of responses are the same - that is whether the new set of responses can safely be discarded.

Implements question_manually_gradable.

Reimplemented in qtype_ddmarker_question.

◆ make_behaviour()

question_graded_automatically_with_countback::make_behaviour ( question_attempt $qa,
$preferredbehaviour )
inherited

Creat the appropriate behaviour for an attempt at this quetsion, given the desired (archetypal) behaviour.

This default implementation will suit most normal graded questions.

If your question is of a patricular type, then it may need to do something different. For example, if your question can only be graded manually, then it should probably return a manualgraded behaviour, irrespective of what is asked for.

If your question wants to do somthing especially complicated is some situations, then you may wish to return a particular behaviour related to the one asked for. For example, you migth want to return a qbehaviour_interactive_adapted_for_myqtype.

Parameters
question_attempt$qathe attempt we are creating a behaviour for.
string$preferredbehaviourthe requested type of behaviour.
Return values
question_behaviourthe new behaviour object.

Reimplemented from question_definition.

◆ make_html_inline()

question_definition::make_html_inline ( $html)
inherited

Take some HTML that should probably already be a single line, like a multiple choice choice, or the corresponding feedback, and make it so that it is suitable to go in a place where the HTML must be inline, like inside a.

tag.

Parameters
string$htmlto HTML to fix up.
Return values
stringthe fixed HTML.

◆ prepare_simulated_post_data()

question_definition::prepare_simulated_post_data ( $simulatedresponse)
inherited

Takes an array of values representing a student response represented in a way that is understandable by a human and transforms that to the response as the POST values returned from the HTML form that takes the student response during a student attempt.

Primarily this is used when reading csv values from a file of student responses in order to be able to simulate the student interaction with a quiz.

In most cases the array will just be returned as is. Some question types will need to transform the keys of the array, as the meaning of the keys in the html form is deliberately obfuscated so that someone looking at the html does not get an advantage. The values that represent the response might also be changed in order to more meaningful to a human.

See the examples of question types that have overridden this in core and also see the csv files of simulated student responses used in unit tests in :

  • mod/quiz/tests/fixtures/stepsXX.csv
  • mod/quiz/report/responses/tests/fixtures/steps00.csv
  • mod/quiz/report/statistics/tests/fixtures/stepsXX.csv

Also see , a quiz report plug in for uploading and downloading student responses as csv files.

Parameters
array$simulatedresponsean array of data representing a student response
Return values
arraya response array as would be returned from the html form (but without prefixes)

Reimplemented in qtype_match_question, qtype_multianswer_question, qtype_multichoice_multi_question, and qtype_multichoice_single_question.

◆ set_choiceorder()

qtype_gapselect_question_base::set_choiceorder ( $group,
$choiceorder )
protected

Helper method used by both start_attempt() and apply_attempt_state().

Parameters
int$groupthe group number.
array$choiceorderthe choices, in order.

◆ set_latest_version()

question_definition::set_latest_version ( int $latestversion)
inherited

Set the latest version.

Making $this->latestversion public would break the magic __get() behaviour above, so allow it to be set externally.

Parameters
int$latestversion
Return values
void

◆ start_attempt()

qtype_gapselect_question_base::start_attempt ( question_attempt_step $step,
$variant )

Start a new attempt at this question, storing any information that will be needed later in the step.

This is where the question can do any initialisation required on a per-attempt basis. For example, this is where the multiple choice question type randomly shuffles the choices (if that option is set).

Any information about how the question has been set up for this attempt should be stored in the $step, by calling $step->set_qt_var(...).

Parameters
question_attempt_stepThe first step of the question_attempt being started. Can be used to store state.
int$varantwhich variant of this question to start. Will be between 1 and get_num_variants() inclusive.

Reimplemented from question_definition.

◆ summarise_choice()

qtype_gapselect_question_base::summarise_choice ( $choice)

Convert a choice to plain text.

Parameters
qtype_gapselect_choice$choiceone of the choices for a place.
Return values
aplain text summary of the choice.

Reimplemented in qtype_ddwtos_question.

◆ summarise_response()

qtype_gapselect_question_base::summarise_response ( array $response)

Produce a plain text summary of a response.

Parameters
array$responsea response, as might be passed to grade_response().
Return values
stringa plain text summary of that response, that could be used in reports.

Implements question_manually_gradable.

Reimplemented in qtype_ddmarker_question, and qtype_ddtoimage_question_base.

◆ un_summarise_response()

question_with_responses::un_summarise_response ( string $summary)
inherited

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.

Parameters
string$summarya string, which might have come from summarise_response
Return values
arraya response that could have lead to that.

Implements question_manually_gradable.

Reimplemented in qtype_essay_question, qtype_multichoice_multi_question, qtype_multichoice_single_question, qtype_numerical_question, qtype_shortanswer_question, and qtype_truefalse_question.

◆ update_attempt_state_data_for_new_version()

question_definition::update_attempt_state_data_for_new_version ( question_attempt_step $oldstep,
question_definition $oldquestion )
inherited

Update the data representing the initial state of an attempt another version of this question, to allow for the changes.

What is required is probably most easily understood using an example. Think about multiple choice questions. The first step has a variable '_order' which is a comma-separated list of question_answer ids. A different version of the question will have different question_answers with different ids. However, the list of choices should be similar, and so we need to shuffle the new list of ids in the same way that the old one was.

Note: be sure to return all the data that was originally in $oldstep, while updating the fields that require it. Otherwise you might break features like 'Each attempt builds on last' in the quiz.

This method should only be called if {

See also
validate_can_regrade_with_other_version()} did not flag up a potential problem. So, this method will throw a {
coding_exception} if it is not possible to work out a return value.
Parameters
question_attempt_step$oldstepthe first step of a {
See also
question_attempt} at $oldquestion.
Parameters
question_definition$oldquestionthe previous version of the question, which $oldstate comes from.
Return values
arraythe submit data which can be passed to {
See also
apply_attempt_state} to start an attempt at this version of this question, corresponding to the attempt at the old question.
Exceptions
coding_exceptionif this can't be done.

Reimplemented in qtype_match_question, qtype_multianswer_question, qtype_multichoice_base, and qtype_ordering_question.

◆ validate_can_regrade_with_other_version()

qtype_gapselect_question_base::validate_can_regrade_with_other_version ( question_definition $otherversion)

Verify if an attempt at this question can be re-graded using the other question version.

To put it another way, will {

See also
update_attempt_state_date_from_old_version()} be able to work?

It is expected that this relationship is symmetrical, so if you can regrade from V1 to V3, then you can change back from V3 to V1.

Parameters
question_definition$otherversiona different version of the question to use in the regrade.
Return values
string|nullnull if the regrade can proceed, else a reason why not.

Reimplemented from question_definition.

Member Data Documentation

◆ $choices

array qtype_gapselect_question_base::$choices

of arrays.

The outer keys are the choice group numbers. The inner keys for most question types number sequentialy from 1. However for ddimageortext questions it is strange (and difficult to change now). the first item in each group gets numbered 1, and the other items get numbered $choice->no. Be careful! The values are arrays of qtype_gapselect_choice objects (or a subclass).

◆ $latestversion

int question_definition::$latestversion = null
protectedinherited

The latest version of the question.

null if we haven't checked yet.

◆ $places

array qtype_gapselect_question_base::$places

place number => group number of the places in the question text where choices can be put.

Places are numbered from 1.

◆ $textfragments

array qtype_gapselect_question_base::$textfragments

of strings, one longer than $places, which is achieved by indexing from 0.

The bits of question text that go between the placeholders.


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