quiz_grading_report Class Reference

Quiz report to help teachers manually grade questions that need it. More...

Inheritance diagram for quiz_grading_report:

Public Member Functions
	display ($quiz, $cm, $course)
	Override this function to displays the report. More...
	get_current_group ($cm, $course, $context)
	Get the current group for the user user looking at the report. More...
	print_header_and_tabs ($cm, $course, $quiz, $reportmode='overview')
	Initialise some parts of $PAGE and start output. More...

Public Attributes
const	DEFAULT_ORDER = 'random'
const	DEFAULT_PAGE_SIZE = 5
const	NO_GROUPS_ALLOWED = -2

Protected Member Functions
	base_url ()
	Get the URL of the front page of the report that lists all the questions. More...
	display_grading_interface ($slot, $questionid, $grade, $pagesize, $page, $shownames, $showidnumbers, $order, $counts)
	display_index ($includeauto)
	format_count_for_table ($counts, $type, $gradestring)
	get_qubaids_condition ()
	get_question_heading ($attempt, $shownames, $showidnumbers)
	Get question heading. More...
	get_question_state_summary ($slots)
	Load information about the number of attempts at various questions in each summarystate. More...
	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. More...
	grade_question_url ($slot, $questionid, $grade, $page=true)
	list_questions_url ($includeauto=null)
	Get the URL of the front page of the report that lists all the questions. More...
	load_attempts_by_usage_ids ($qubaids)
	process_submitted_data ()
	validate_submitted_marks ()

Protected Attributes
	$cm
	$context
	$questions
	$quiz
	$viewoptions = array()

Detailed Description

Quiz report to help teachers manually grade questions that need it.

This report basically provides two screens:

• List question that might need manual grading (or optionally all questions).
• Provide an efficient UI to grade all attempts at a particular question.

Copyright

2006 Gustav Delius

License

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

Member Function Documentation

base_url()

quiz_grading_report::base_url ( )

protected

Get the URL of the front page of the report that lists all the questions.

Parameters

$includeauto

if not given, use the current setting, otherwise, force a paricular value of includeauto in the URL.

Return values

string

the URL.

display()

quiz_grading_report::display	(		$cm,
			$course,
			$quiz
	)

Override this function to displays the report.

Parameters

$cm	the course-module for this quiz.
$course	the coures we are in.
$quiz	this quiz.

Reimplemented from quiz_default_report.

get_current_group()

quiz_default_report::get_current_group (   $cm,   $course,   $context  )

inherited

Get the current group for the user user looking at the report.

Parameters

object	$cm	the course_module information.
object	$coures	the course settings.
context	$context	the quiz context.

Return values

int	the current group id, if applicable. 0 for all users, NO_GROUPS_ALLOWED if the user cannot see any group.

get_question_heading()

quiz_grading_report::get_question_heading (   $attempt,   $shownames,   $showidnumbers  )

protected

Get question heading.

Parameters

object	$attempt	an instance of quiz_attempt.
bool	$shownames	True to show the question name.
bool	$showidnumbers	True to show the question id number.

Return values

string

The string text for the question heading.

Exceptions

coding_exception

get_question_state_summary()

quiz_grading_report::get_question_state_summary (   $slots )

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

Parameters

array

$slots

A list of slots for the questions you want to konw about.

Return values

array

The array keys are slot,qestionid. The values are objects with fields $slot, $questionid, $inprogress, $name, $needsgrading, $autograded, $manuallygraded and $all.

get_usage_ids_where_question_in_state()

quiz_grading_report::get_usage_ids_where_question_in_state (   $summarystate,   $slot,   $questionid = null,   $orderby = 'random',   $page = 0,   $pagesize = null  )

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.

Parameters

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.

grade_question_url()

quiz_grading_report::grade_question_url (   $slot,   $questionid,   $grade,   $page = true  )

protected

Parameters

int	$slot
int	$questionid
string	$grade
mixed	$page	= true, link to current page. false = omit page. number = link to specific page.

list_questions_url()

quiz_grading_report::list_questions_url (   $includeauto = null )

protected

Get the URL of the front page of the report that lists all the questions.

Parameters

$includeauto

if not given, use the current setting, otherwise, force a paricular value of includeauto in the URL.

Return values

string

the URL.

print_header_and_tabs()

quiz_grading_report::print_header_and_tabs	(		$cm,
			$course,
			$quiz,
			$reportmode = 'overview'
	)

Initialise some parts of $PAGE and start output.

Parameters

object	$cm	the course_module information.
object	$course	the course settings.
object	$quiz	the quiz settings.
string	$reportmode	the report name.

Reimplemented from quiz_default_report.

---

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

• mod/quiz/report/grading/report.php