quiz_statistics

Topics
	files

Directories
directory	event

Namespaces
namespace	quiz_statistics
namespace	quiz_statistics\event\observer
namespace	quiz_statistics\privacy
	Privacy Subsystem implementation for quiz_statistics.
namespace	quiz_statistics\task
namespace	quiz_statistics\tests

Classes
class	quiz_statistics\calculated
	The statistics calculator returns an instance of this class which contains the calculated statistics. More...
class	quiz_statistics\calculator
	Class to calculate and also manage caching of quiz statistics. More...
class	quiz_statistics\event\observer\attempt_submitted
	Event observer for mod_quiz\event\attempt_submitted. More...
class	quiz_statistics\privacy\provider
	Privacy Subsystem for quiz_statistics implementing null_provider. More...
class	quiz_statistics\quiz_attempt_deleted
	Queue a statistics recalculation when an attempt is deleted. More...
class	quiz_statistics\quiz_structure_modified
	Clear the statistics cache when the quiz structure is modified. More...
class	quiz_statistics\task\recalculate
	Re-calculate question statistics. More...
class	quiz_statistics\tests\statistics_helper
	Test helper functions for statistics. 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.
	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.
	xmldb_quiz_statistics_install ()
	Post-install script.
	xmldb_quiz_statistics_upgrade ($oldversion)
	Quiz statistics report upgrade code.

Variables
	$capabilities
	$observers
	$plugin = 2023100400
$plugin	component = 'quiz_statistics'
$plugin	version = 2023100900

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_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:

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

$observers

$observers

Initial value:

= [
    [
        'eventname' => '\mod_quiz\event\attempt_submitted',
        'callback' => '\quiz_statistics\event\observer\attempt_submitted::process',
    ],
]