Namespaces
namespace	mod
	Local Library of functions for module scorm.
Enumerations
enum	QUIZ_REPORT_DEFAULT_PAGE_SIZE
enum	QUIZ_REPORT_DEFAULT_GRADING_PAGE_SIZE
enum	QUIZ_REPORT_ATTEMPTS_ALL
enum	QUIZ_REPORT_ATTEMPTS_STUDENTS_WITH_NO
enum	QUIZ_REPORT_ATTEMPTS_STUDENTS_WITH
enum	QUIZ_REPORT_ATTEMPTS_ALL_STUDENTS
Functions
	quiz_report_index_by_keys ($datum, $keys, $keysunique=true)
	quiz_report_unindex ($datum)
	quiz_report_get_significant_questions ($quiz)
	quiz_report_qm_filter_select ($quiz, $quizattemptsalias= 'quiza')
	quiz_report_grade_bands ($bandwidth, $bands, $quizid, $userids=array())
	quiz_report_highlighting_grading_method ($quiz, $qmsubselect, $qmfilter)
	quiz_report_feedback_for_grade ($grade, $quizid, $context)
	quiz_report_scale_summarks_as_percentage ($rawmark, $quiz, $round=true)
	quiz_report_list ($context)
	quiz_report_download_filename ($report, $courseshortname, $quizname)
	quiz_report_default_report ($context)
	quiz_no_questions_message ($quiz, $cm, $context)

Enumeration Type Documentation

enum QUIZ_REPORT_ATTEMPTS_ALL

Definition at line 35 of file reportlib.php.

enum QUIZ_REPORT_ATTEMPTS_ALL_STUDENTS

Definition at line 38 of file reportlib.php.

enum QUIZ_REPORT_ATTEMPTS_STUDENTS_WITH

Definition at line 37 of file reportlib.php.

enum QUIZ_REPORT_ATTEMPTS_STUDENTS_WITH_NO

Definition at line 36 of file reportlib.php.

enum QUIZ_REPORT_DEFAULT_GRADING_PAGE_SIZE

Definition at line 33 of file reportlib.php.

enum QUIZ_REPORT_DEFAULT_PAGE_SIZE

Definition at line 32 of file reportlib.php.

Function Documentation

quiz_no_questions_message	(	$	quiz,
		$	cm,
		$	context
	)

Generate a message saying that this quiz has no questions, with a button to go to the edit page, if the user has the right capability.

Parameters:

object	$quiz	the quiz settings.
object	$cm	the course_module object.
object	$context	the quiz context.

Returns:: string HTML to output.

Definition at line 385 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_default_report ( $ context )

Get the default report for the current user.

Parameters:

object $context the quiz context.

Definition at line 373 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_download_filename	(	$	report,
		$	courseshortname,
		$	quizname
	)

Create a filename for use when downloading data from a quiz report. It is expected that this will be passed to flexible_table::is_downloading, which cleans the filename of bad characters and adds the file extension.

Parameters:

string	$report	the type of report.
string	$courseshortname	the course shortname.
string	$quizname	the quiz name.

Returns:: string the filename.

Definition at line 365 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_feedback_for_grade	(	$	grade,
		$	quizid,
		$	context
	)

Get the feedback text for a grade on this quiz. The feedback is processed ready for display.

Parameters:

float	$grade	a grade on this quiz.
int	$quizid	the id of the quiz object.

Returns:: string the comment that corresponds to this grade (empty string if there is not one.

Definition at line 259 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_get_significant_questions ( $ quiz )

Get the slots of real questions (not descriptions) in this quiz, in order.

Parameters:

object $quiz the quiz.

Returns:: array of slot => $question object with fields ->slot, ->id, ->maxmark, ->number, ->length.

Definition at line 95 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_grade_bands	(	$	bandwidth,
		$	bands,
		$	quizid,
		$	userids = `array()`
	)

Get the nuber of students whose score was in a particular band for this quiz.

Parameters:

number	$bandwidth	the width of each band.
int	$bands	the number of bands
int	$quizid	the quiz id.
array	$userids	list of user ids.

Returns:: array band number => number of users with scores in that band.

Definition at line 191 of file reportlib.php.

quiz_report_highlighting_grading_method	(	$	quiz,
		$	qmsubselect,
		$	qmfilter
	)

Definition at line 234 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_index_by_keys	(	$	datum,
		$	keys,
		$	keysunique = `true`
	)

Takes an array of objects and constructs a multidimensional array keyed by the keys it finds on the object.

Parameters:

array	$datum	an array of objects with properties on the object including the keys passed as the next param.
array	$keys	Array of strings with the names of the properties on the objects in datum that you want to index the multidimensional array by.
bool	$keysunique	If there is not only one object for each combination of keys you are using you should set $keysunique to true. Otherwise all the object will be added to a zero based array. So the array returned will have count($keys) + 1 indexs.

Returns:: array multidimensional array properly indexed.

Definition at line 53 of file reportlib.php.

Here is the caller graph for this function:

quiz_report_list ( $ context )

Returns an array of reports to which the current user has access to.

Returns:: array reports are ordered as they should be for display in tabs.

Definition at line 320 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_qm_filter_select	(	$	quiz,
		$	quizattemptsalias = `'quiza'`
	)

Given the quiz grading method return sub select sql to find the id of the one attempt that will be graded for each user. Or return empty string if all attempts contribute to final grade.

Definition at line 144 of file reportlib.php.

Here is the caller graph for this function:

quiz_report_scale_summarks_as_percentage	(	$	rawmark,
		$	quiz,
		$	round = `true`
	)

Format a number as a percentage out of $quiz->sumgrades

Parameters:

number	$rawgrade	the mark to format.
object	$quiz	the quiz settings
bool	$round	whether to round the results ot $quiz->decimalpoints.

Definition at line 301 of file reportlib.php.

Here is the call graph for this function:

Here is the caller graph for this function:

quiz_report_unindex ( $ datum )

Definition at line 74 of file reportlib.php.

Namespaces

Enumerations

Functions

Enumeration Type Documentation

Function Documentation