Grade helper class. More...

Static Public Member Functions
static	fetch_all_natural_weights_for_course ($courseid)
	This helper method gets a snapshot of all the weights for a course.

static	get_aggregation_strings ()
	Gets strings describing the available aggregation methods.

static	get_info_letters ($courseid)
	Get information on letters.

static	get_info_manage_settings ($courseid)
	Get grade_plugin_info object for managing settings if the user can.

static	get_info_outcomes ($courseid)
	Get information on outcomes.

static	get_info_scales ($courseid)
	Get information on scales.

static	get_lang_string (string $strcode, ?string $section=null)
	First checks the cached language strings, then returns match if found, or uses get_string() to get it from the DB, caches it then returns it.

static	get_plugin_strings ()
	Gets strings commonly used by the describe plugins.

static	get_plugins_export ($courseid)
	Get information export plugins.

static	get_plugins_import ($courseid)
	Get information import plugins.

static	get_plugins_reports ($courseid)
	Returns an array of plugin reports as grade_plugin_info objects.

static	get_user_field_value ($user, $field)
	Returns the value of a field from a user record.

static	get_user_profile_fields ($courseid, $includecustomfields=false)
	Returns an array of user profile fields to be included in export.

static	reset_caches ()
	Resets all static caches.

Static Protected Attributes
static array	$aggregationstrings = null
	Cached grade aggregation strings.

static array false	$exportplugins = null
	Cached grade export plugins {.

static array false	$gradereportpreferences = null
	Cached grade report plugins preferences {.

static array false	$gradereports = null
	Cached grade report plugins {.

static array false	$importplugins = null
	Cached grade import plugins {.

static array	$langstrings = []
	Cached grade tree plugin strings.

static grade_plugin_info false	$letterinfo = null
	Cached leftter info {.

static grade_plugin_info false	$managesetting = null
	Cached manage settings info {.

static grade_plugin_info false	$outcomeinfo = null
	Cached outcome info {.

static array	$pluginstrings = null
	Cached grade plugin strings.

static grade_plugin_info false	$scaleinfo = null
	Cached scale info {.

Detailed Description

Grade helper class.

This class provides several helpful functions that work irrespective of any current state.

Copyright: 2010 Sam Hemelryk

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

Member Function Documentation

◆ fetch_all_natural_weights_for_course()

static grade_helper::fetch_all_natural_weights_for_course ( $courseid )

static

This helper method gets a snapshot of all the weights for a course.

It is used as a quick method to see if any wieghts have been automatically adjusted.

Parameters

int $courseid

Return values

array of itemid -> aggregationcoef2

◆ get_aggregation_strings()

static grade_helper::get_aggregation_strings ( )

static

Gets strings describing the available aggregation methods.

Return values

array

◆ get_info_letters()

static grade_helper::get_info_letters ( $courseid )

static

Get information on letters.

Parameters

int $courseid

Return values

array

◆ get_info_manage_settings()

static grade_helper::get_info_manage_settings ( $courseid )

static

Get grade_plugin_info object for managing settings if the user can.

Parameters

int $courseid

Return values

grade_plugin_info[]

◆ get_info_outcomes()

static grade_helper::get_info_outcomes ( $courseid )

static

Get information on outcomes.

Parameters

int $courseid

Return values

grade_plugin_info[]|false

◆ get_info_scales()

static grade_helper::get_info_scales ( $courseid )

static

Get information on scales.

Parameters

int $courseid

Return values

grade_plugin_info

◆ get_lang_string()

static grade_helper::get_lang_string	(	string	$strcode,
		?string	$section = null )

static

First checks the cached language strings, then returns match if found, or uses get_string() to get it from the DB, caches it then returns it.

Deprecated: since 4.3

Todo: MDL-78780 This will be deleted in Moodle 4.7.

Parameters

string	$strcode
string \| null	$section	Optional language section

Return values

string

◆ get_plugin_strings()

static grade_helper::get_plugin_strings ( )

static

Gets strings commonly used by the describe plugins.

report => get_string('view'), scale => get_string('scales'), outcome => get_string('outcomes', 'grades'), letter => get_string('letters', 'grades'), export => get_string('export', 'grades'), import => get_string('import'), settings => get_string('settings')

Return values

array

◆ get_plugins_export()

static grade_helper::get_plugins_export ( $courseid )

static

Get information export plugins.

Parameters

int $courseid

Return values

array

◆ get_plugins_import()

static grade_helper::get_plugins_import ( $courseid )

static

Get information import plugins.

Parameters

int $courseid

Return values

array

◆ get_plugins_reports()

static grade_helper::get_plugins_reports ( $courseid )

static

Returns an array of plugin reports as grade_plugin_info objects.

Parameters

int $courseid

Return values

array

◆ get_user_field_value()

static grade_helper::get_user_field_value	(		$user,
			$field )

static

Returns the value of a field from a user record.

Parameters

stdClass	$user	object
stdClass	$field	object

Return values

string value of the field

◆ get_user_profile_fields()

static grade_helper::get_user_profile_fields	(		$courseid,
			$includecustomfields = false )

static

Returns an array of user profile fields to be included in export.

Parameters

int	$courseid
bool	$includecustomfields

Return values

array An array of stdClass instances with customid, shortname, datatype, default and fullname fields

◆ reset_caches()

static grade_helper::reset_caches ( )

static

Resets all static caches.

Return values

void

Member Data Documentation

◆ $exportplugins

array false grade_helper::$exportplugins = null

staticprotected

Cached grade export plugins {.

See also: get_plugins_export}

◆ $gradereportpreferences

array false grade_helper::$gradereportpreferences = null

staticprotected

Cached grade report plugins preferences {.

See also: get_info_scales}

◆ $gradereports

array false grade_helper::$gradereports = null

staticprotected

Cached grade report plugins {.

See also: get_plugins_reports}

◆ $importplugins

array false grade_helper::$importplugins = null

staticprotected

Cached grade import plugins {.

See also: get_plugins_import}

◆ $letterinfo

grade_plugin_info false grade_helper::$letterinfo = null

staticprotected

Cached leftter info {.

See also: get_info_letters}

◆ $managesetting

grade_plugin_info false grade_helper::$managesetting = null

staticprotected

Cached manage settings info {.

See also: get_info_settings}

◆ $outcomeinfo

grade_plugin_info false grade_helper::$outcomeinfo = null

staticprotected

Cached outcome info {.

See also: get_info_outcomes}

◆ $scaleinfo

grade_plugin_info false grade_helper::$scaleinfo = null

staticprotected

Cached scale info {.

See also: get_info_scales}

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

grade/lib.php

Static Public Member Functions

Static Protected Attributes

Detailed Description

Member Function Documentation

◆ fetch_all_natural_weights_for_course()

◆ get_aggregation_strings()

◆ get_info_letters()

◆ get_info_manage_settings()

◆ get_info_outcomes()

◆ get_info_scales()

◆ get_lang_string()

◆ get_plugin_strings()

◆ get_plugins_export()

◆ get_plugins_import()

◆ get_plugins_reports()

◆ get_user_field_value()

◆ get_user_profile_fields()

◆ reset_caches()

Member Data Documentation

◆ $exportplugins

◆ $gradereportpreferences

◆ $gradereports

◆ $importplugins

◆ $letterinfo

◆ $managesetting

◆ $outcomeinfo

◆ $scaleinfo