quiz_statistics

Directories
directory	event

Files
file	access.php
	Capability definitions for the quiz statistics report.
file	attempt_submitted.php
	Event observer for mod_quiz::event::attempt_submitted.
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	events.php
	Add event observers for 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_attempt_deleted.php
	Queue a statistics recalculation when an attempt is deleted.
file	quiz_structure_modified.php
	Clear the statistics cache when the quiz structure is modified.
file	recalculate.php
	Re-calculate question statistics.
file	report.php
	Quiz statistics report class.
file	settings.php
	Settings for the Statisics report.
file	statistics_form.php
	Quiz statistics settings form definition.
file	statistics_helper.php
	Test helper functions for statistics.
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	statistics_test_trait.php
	Test methods for statistics recalculations.
file	statisticslib.php
	Common functions for the quiz statistics report.
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\event\observer
namespace	quiz_statistics\privacy
namespace	quiz_statistics\task
namespace	quiz_statistics\tests

Classes
class	quiz_statistics\calculated
class	quiz_statistics\calculator
class	quiz_statistics\event\observer\attempt_submitted
class	quiz_statistics\privacy\provider
	Privacy Subsystem for quiz_statistics implementing null_provider. More...
class	quiz_statistics\quiz_attempt_deleted
class	quiz_statistics\quiz_structure_modified
class	quiz_statistics\task\recalculate
class	quiz_statistics\tests\statistics_helper
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.
	quiz_statistics_question_preview_pluginfile ($previewcontext, $questionid, $filecontext, $filecomponent, $filearea, $args, $forcedownload, $options=[])
	xmldb_quiz_statistics_install ()
	Post-install script.
	xmldb_quiz_statistics_upgrade ($oldversion)
	Quiz statistics report upgrade code.

Variables
	$capabilities
	$observers
	$plugin = 2023041800
$plugin	component = 'quiz_statistics'
$plugin	version = 2023042404

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',
    ],
]