Moodle PHP Documentation 4.4
Moodle 4.4.1 (Build: 20240610) (db07c09afc5)
|
Public Member Functions | |
display ($quiz, $cm, $course) | |
Override this function to display the report. | |
get_current_group ($cm, $course, $context) | |
Get the current group for the user user looking at the report. | |
print_header_and_tabs ($cm, $course, $quiz, $reportmode='overview') | |
Initialise some parts of $PAGE and start output. | |
Protected Member Functions | |
base_url () | |
Get the URL of the front page of the report that lists all the questions. | |
display_grading_interface ($slot, $questionid, $grade, $pagesize, $page, $shownames, $showcustomfields, $order, $counts) | |
Display the UI for grading attempts at one question. | |
display_index ($includeauto) | |
Display the report front page which summarises the number of attempts to grade. | |
format_count_for_table ($counts, $type, $string, $component) | |
Renders the contents of one cell of the table on the index view. | |
get_qubaids_condition () | |
Get the JOIN conditions needed so we only show attempts by relevant users. | |
get_question_heading (stdClass $attempt, bool $shownames, bool $showcustomfields) | |
Get question heading. | |
get_question_state_summary ($slots) | |
Load information about the number of attempts at various questions in each summarystate. | |
get_usage_ids_where_question_in_state ($summarystate, $slot, $questionid=null, $orderby='random', $page=0, $pagesize=null) | |
Get a list of usage ids where the question with slot $slot, and optionally also with question id $questionid, is in summary state $summarystate. | |
grade_question_url ($slot, $questionid, $grade, $page=true) | |
Get the URL to grade a batch of question attempts. | |
list_questions_url ($includeauto=null) | |
Get the URL of the front page of the report that lists all the questions. | |
load_attempts_by_usage_ids ($qubaids) | |
Load the quiz_attempts rows corresponding to a list of question_usage ids. | |
process_submitted_data () | |
Save all submitted marks to the database. | |
validate_submitted_marks () | |
When saving a grading page, are all the submitted marks valid? | |
Protected Attributes | |
stdClass | $cm |
the course_module settings. | |
context | $context |
the quiz context. | |
stdClass | $course |
the course settings. | |
int | $currentgroup |
the current group, 0 if none, or NO_GROUPS_ALLOWED. | |
array | $extrauserfields = [] |
extra user fields. | |
array | $questions |
from quiz_report_get_significant_questions. | |
stdClass | $quiz |
the quiz settings. | |
quiz_grading_renderer | $renderer |
Renderer of Quiz Grading. | |
string | $userssql |
fragment of SQL code to restrict to the relevant users. | |
array | $viewoptions = [] |
URL parameters for what is being displayed when grading. | |
|
protected |
Get the URL of the front page of the report that lists all the questions.
moodle_url | the URL. |
quiz_grading_report::display | ( | $quiz, | |
$cm, | |||
$course ) |
Override this function to display the report.
stdClass | $quiz | this quiz. |
stdClass | $cm | the course-module for this quiz. |
stdClass | $course | the coures we are in. |
Reimplemented from mod_quiz\local\reports\report_base.
|
protected |
Display the UI for grading attempts at one question.
int | $slot | identifies which question to grade. |
int | $questionid | identifies which question to grade. |
string | $grade | type of attempts to grade. |
int | $pagesize | number of questions to show per page. |
int | $page | current page number. |
bool | $shownames | whether student names should be shown. |
bool | $showcustomfields | whether custom field values should be shown. |
string | $order | preferred order of attempts. |
stdClass | $counts | object that stores the number of each type of attempt. |
|
protected |
Display the report front page which summarises the number of attempts to grade.
bool | $includeauto | whether to show automatically-graded questions. |
|
protected |
Renders the contents of one cell of the table on the index view.
stdClass | $counts | counts of different types of attempt for this slot. |
string | $type | the type of count to format. |
string | $string | get_string identifier for the grading link text, if required. |
string | $component | get_string component identifier for the grading link text, if required. |
string | HTML. |
|
inherited |
Get the current group for the user user looking at the report.
stdClass | $cm | the course_module information. |
stdClass | $course | the course settings. |
context | $context | the quiz context. |
int | the current group id, if applicable. 0 for all users, NO_GROUPS_ALLOWED if the user cannot see any group. |
|
protected |
Get the JOIN conditions needed so we only show attempts by relevant users.
qubaid_join |
|
protected |
Get question heading.
stdClass | $attempt | An instance of quiz_attempt. |
bool | $shownames | True to show the student first/lastnames. |
bool | $showcustomfields | Whether custom field values should be shown. |
string | The string text for the question heading. |
|
protected |
Load information about the number of attempts at various questions in each summarystate.
The results are returned as an two dimensional array $qubaid => $slot => $dataobject
array | $slots | A list of slots for the questions you want to konw about. |
array | The array keys are slot,qestionid. The values are objects with fields $slot, $questionid, $inprogress, $name, $needsgrading, $autograded, $manuallygraded and $all. |
|
protected |
Get a list of usage ids where the question with slot $slot, and optionally also with question id $questionid, is in summary state $summarystate.
Also return the total count of such states.
Only a subset of the ids can be returned by using $orderby, $limitfrom and $limitnum. A special value 'random' can be passed as $orderby, in which case $limitfrom is ignored.
int | $slot | The slot for the questions you want to konw about. |
int | $questionid | (optional) Only return attempts that were of this specific question. |
string | $summarystate | 'all', 'needsgrading', 'autograded' or 'manuallygraded'. |
string | $orderby | 'random', 'date', 'student' or 'idnumber'. |
int | $page | implements paging of the results. Ignored if $orderby = random or $pagesize is null. |
int | $pagesize | implements paging of the results. null = all. |
array | with two elements, an array of usage ids, and a count of the total number. |
|
protected |
Get the URL to grade a batch of question attempts.
int | $slot | |
int | $questionid | |
string | $grade | |
int | bool | $page | = true, link to current page. false = omit page. number = link to specific page. |
moodle_url |
|
protected |
Get the URL of the front page of the report that lists all the questions.
bool | $includeauto | if not given, use the current setting, otherwise, force a particular value of includeauto in the URL. |
moodle_url | the URL. |
|
protected |
Load the quiz_attempts rows corresponding to a list of question_usage ids.
int[] | $qubaids | the question_usage ids of the quiz_attempts to load. |
array | quiz attempts, with added user name fields. |
quiz_grading_report::print_header_and_tabs | ( | $cm, | |
$course, | |||
$quiz, | |||
$reportmode = 'overview' ) |
Initialise some parts of $PAGE and start output.
stdClass | $cm | the course_module information. |
stdClass | $course | the course settings. |
stdClass | $quiz | the quiz settings. |
string | $reportmode | the report name. |
Reimplemented from mod_quiz\local\reports\report_base.
|
protected |
Save all submitted marks to the database.
bool | returns true if some attempts or all are graded. False, if none of the attempts are graded. |
|
protected |
When saving a grading page, are all the submitted marks valid?
bool | true if all valid, else false. |