quiz_statistics

Files
file	access.php
	Capability definitions for the quiz statistics report.
file	calculated.php
	The statistics calculator returns an instance of this class which contains the calculated statistics.
file	calculator.php
	Class to calculate and also manage caching of quiz statistics.
file	install.php
	Post-install script for the quiz statistics report.
file	lib.php
	Standard plugin entry points of the quiz statistics report.
file	provider.php
	Privacy Subsystem implementation for quiz_statistics.
file	quiz_statistics_cleanup.php
	Legacy Cron Quiz Reports Task.
file	report.php
	Quiz statistics report class.
file	statistics_form.php
	Quiz statistics settings form definition.
file	statistics_question_table.php
	Quiz statistics report, table for showing response analysis for a particular question (or sub question).
file	statistics_table.php
	Quiz statistics report, table for showing statistics of each question in the quiz.
file	statisticslib.php
	Common functions for the quiz statistics report.
file	tasks.php
	Legacy Cron Quiz Reports Task.
file	upgrade.php
	Post-install script for the quiz statistics report.
file	version.php
	Quiz statistics report version information.

Namespaces
namespace	quiz_statistics
namespace	quiz_statistics\privacy
namespace	quiz_statistics\task

Classes
class	quiz_statistics\calculated
class	quiz_statistics\calculator
class	quiz_statistics\privacy\provider
	Privacy Subsystem for quiz_statistics implementing null_provider. More...
class	quiz_statistics\task\quiz_statistics_cleanup
	Legacy Cron Quiz Reports Task. More...
class	quiz_statistics_question_table
	This table shows statistics about a particular question. More...
class	quiz_statistics_report
	The quiz statistics report provides summary information about each question in a quiz, compared to the whole quiz. More...
class	quiz_statistics_settings_form
	This is the settings form for the quiz statistics report. More...
class	quiz_statistics_table
	This table has one row for each question in the quiz, with sub-rows when random questions and variants appear. More...

Functions
	quiz_statistics_attempts_sql ($quizid, core\dml\sql_join $groupstudentsjoins, $whichattempts=QUIZ_GRADEAVERAGE, $includeungraded=false)
	SQL to fetch relevant 'quiz_attempts' records. More...
	quiz_statistics_graph_get_new_colour ()
	This helper function returns a sequence of colours each time it is called. More...
	quiz_statistics_qubaids_condition ($quizid, core\dml\sql_join $groupstudentsjoins, $whichattempts=QUIZ_GRADEAVERAGE, $includeungraded=false)
	Return a qubaid_condition from the values returned by quiz_statistics_attempts_sql. More...
	quiz_statistics_question_preview_pluginfile ($previewcontext, $questionid, $filecontext, $filecomponent, $filearea, $args, $forcedownload, $options=array())
	xmldb_quiz_statistics_install ()
	Post-install script.
	xmldb_quiz_statistics_upgrade ($oldversion)
	Quiz statistics report upgrade code.

Variables
	$capabilities
	$plugin = 2020060900
	$tasks
$plugin	component = 'quiz_statistics'
$plugin	version = 2020061500

Detailed Description

Function Documentation

quiz_statistics_attempts_sql()

quiz_statistics_attempts_sql	(		$quizid,
		core\dml\sql_join	$groupstudentsjoins,
			$whichattempts = QUIZ_GRADEAVERAGE,
			$includeungraded = false
	)

SQL to fetch relevant 'quiz_attempts' records.

Parameters

int	$quizid	quiz id to get attempts for
core::dml::sql_join	$groupstudentsjoins	Contains joins, wheres, params, empty if not using groups
string	$whichattempts	which attempts to use, represented internally as one of the constants as used in $quiz->grademethod ie. QUIZ_GRADEAVERAGE, QUIZ_GRADEHIGHEST, QUIZ_ATTEMPTLAST or QUIZ_ATTEMPTFIRST we calculate stats based on which attempts would affect the grade for each student.
bool	$includeungraded	whether to fetch ungraded attempts too

Return values

array

FROM and WHERE sql fragments and sql params

quiz_statistics_graph_get_new_colour()

quiz_statistics_graph_get_new_colour

(

)

This helper function returns a sequence of colours each time it is called.

Used for choosing colours for graph data series.

Return values

string

colour name.

Deprecated:

since Moodle 3.2

quiz_statistics_qubaids_condition()

quiz_statistics_qubaids_condition	(		$quizid,
		core\dml\sql_join	$groupstudentsjoins,
			$whichattempts = QUIZ_GRADEAVERAGE,
			$includeungraded = false
	)

Return a qubaid_condition from the values returned by quiz_statistics_attempts_sql.

Parameters

int	$quizid
core::dml::sql_join	$groupstudentsjoins	Contains joins, wheres, params
string	$whichattempts	which attempts to use, represented internally as one of the constants as used in $quiz->grademethod ie. QUIZ_GRADEAVERAGE, QUIZ_GRADEHIGHEST, QUIZ_ATTEMPTLAST or QUIZ_ATTEMPTFIRST we calculate stats based on which attempts would affect the grade for each student.
bool	$includeungraded

Return values

qubaid_join

Variable Documentation

$capabilities

$capabilities

Initial value:

= array(
    'quiz/statistics:view' => array(
        'captype' => 'read',
        'contextlevel' => CONTEXT_MODULE,
        'archetypes' => array(
            'teacher' => CAP_ALLOW,
            'editingteacher' => CAP_ALLOW,
            'manager' => CAP_ALLOW
        ),
        'clonepermissionsfrom' =>  'mod/quiz:viewreports'
    )
)

$tasks

$tasks

Initial value:

= [
    [
        'classname' => 'quiz_statistics\task\quiz_statistics_cleanup',
        'blocking' => 0,
        'minute' => 'R',
        'hour' => '*/5',
        'day' => '*',
        'dayofweek' => '*',
        'month' => '*'
    ]
]