Compontent definition of a gradeitem. More...

Inheritance diagram for core_grades\component_gradeitem:

Public Member Functions
	check_grade_validity (?float $grade)
	Check whether the supplied grade is valid and throw an exception if not.

	create_empty_grade (stdClass $gradeduser, stdClass $grader)
	Create an empty row in the grade for the specified user and grader.

	get_advanced_grading_instance (stdClass $grader, stdClass $grade, int $instanceid=null)
	Get the advanced grading instance for the specified grade entry.

	get_advanced_grading_method ()
	Get the name of the advanced grading method.

	get_all_grades ()
	Get grades for all users for the specified gradeitem.

	get_formatted_grade_for_user (stdClass $gradeduser, stdClass $grader)
	Returns the grade that should be displayed to the user.

	get_grade (int $gradeid)
	Get the grade record for the specified grade id.

	get_grade_for_user (stdClass $gradeduser, stdClass $grader)
	Get the grade for the specified user.

	get_grade_instance_id ()
	Get the grade item instance id.

	get_grade_item ()
	Get the core grade item from the current component grade item.

	get_grade_itemid ()
	Get the itemid for the current gradeitem.

	get_grade_menu ()
	Get the list of available grade items.

	get_grading_component_name ()
	Get the name of the component responsible for grading this gradeitem.

	get_grading_component_subtype ()
	Get the name of the component subtype responsible for grading this gradeitem.

	is_grading_enabled ()
	Whether grading is enabled for this item.

	is_using_advanced_grading ()
	Whether this grade item is configured to use advanced grading.

	is_using_direct_grading ()
	Whether this grade item is configured to use direct grading.

	is_using_scale ()
	Check whether a scale is being used for this grade item.

	require_user_can_grade (stdClass $gradeduser, stdClass $grader)
	Require that the user can grade, throwing an exception if not.

	send_student_notification (stdClass $gradeduser, stdClass $grader)
	Sends a notification about the item being graded for the student.

	store_grade_from_formdata (stdClass $gradeduser, stdClass $grader, stdClass $formdata)
	Create or update the grade.

	user_can_grade (stdClass $gradeduser, stdClass $grader)
	Whether the grader can grade the gradee.

	user_has_grade (stdClass $gradeduser)
	Get the grade status for the specified user.

Static Public Member Functions
static	instance (string $component, context $context, string $itemname)
	Fetch an instance of a specific component_gradeitem.

static	load_from_context (context $context)
	Load an instance of the current component_gradeitem based on context.

Protected Member Functions
	__construct (string $component, context $context, string $itemname)
	component_gradeitem constructor.

	allow_decimals ()
	Whether decimals are allowed.

	get_advanced_grading_controller ()
	Get the advanced grading controller if advanced grading is enabled.

	get_gradeitem_value ()
	Get the grade value for this instance.

	get_grading_manager ()
	Get the grading manager for this advanced grading definition.

	get_scale ()
	Get the scale if a scale is being used.

	get_table_name ()
	The table name used for grading.

	store_grade (stdClass $grade)
	Create or update the grade.

Protected Attributes
string	$component
	The component.

context	$context
	The context for this activity.

string	$itemname
	The item name.

int	$itemnumber
	The grade itemnumber.

array	$scale
	The scale data for the current grade item.

Detailed Description

Compontent definition of a gradeitem.

Copyright: Andrew Nicols andre.nosp@m.w@ni.nosp@m.cols..nosp@m.co.u.nosp@m.k

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

Constructor & Destructor Documentation

◆ __construct()

core_grades\component_gradeitem::__construct	(	string	$component,
		context	$context,
		string	$itemname )

finalprotected

component_gradeitem constructor.

Parameters

string	$component
context	$context
string	$itemname

Exceptions

coding_exception

Member Function Documentation

◆ allow_decimals()

core_grades\component_gradeitem::allow_decimals ( )

protected

Whether decimals are allowed.

Return values

bool

◆ check_grade_validity()

core_grades\component_gradeitem::check_grade_validity ( ?float $grade )

Check whether the supplied grade is valid and throw an exception if not.

Parameters

float $grade The value being checked

Exceptions

moodle_exception

Return values

bool

◆ create_empty_grade()

core_grades\component_gradeitem::create_empty_grade	(	stdClass	$gradeduser,
		stdClass	$grader )

abstract

Create an empty row in the grade for the specified user and grader.

Parameters

stdClass	$gradeduser	The user being graded
stdClass	$grader	The user who is grading

Return values

stdClass The newly created grade record

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ get_advanced_grading_controller()

core_grades\component_gradeitem::get_advanced_grading_controller ( )

protected

Get the advanced grading controller if advanced grading is enabled.

Return values

gradingform_controller

◆ get_advanced_grading_instance()

core_grades\component_gradeitem::get_advanced_grading_instance	(	stdClass	$grader,
		stdClass	$grade,
		int	$instanceid = null )

Get the advanced grading instance for the specified grade entry.

Parameters

stdClass	$grader	The user who is grading
stdClass	$grade	The row from the grade table.
int	$instanceid	The instanceid of the advanced grading form

Return values

gradingform_instance

◆ get_advanced_grading_method()

core_grades\component_gradeitem::get_advanced_grading_method ( )

Get the name of the advanced grading method.

Return values

string

◆ get_all_grades()

core_grades\component_gradeitem::get_all_grades ( )

abstract

Get grades for all users for the specified gradeitem.

Return values

stdClass[] The grades

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ get_formatted_grade_for_user()

core_grades\component_gradeitem::get_formatted_grade_for_user	(	stdClass	$gradeduser,
		stdClass	$grader )

Returns the grade that should be displayed to the user.

The grade does not necessarily return a float value, this method takes grade settings into considering so the correct value be shown, eg. a float vs a letter.

Parameters

stdClass	$gradeduser
stdClass	$grader

Return values

stdClass|null

◆ get_grade()

core_grades\component_gradeitem::get_grade ( int $gradeid )

Get the grade record for the specified grade id.

Parameters

int $gradeid

Return values

stdClass

Exceptions

dml_exception

◆ get_grade_for_user()

core_grades\component_gradeitem::get_grade_for_user	(	stdClass	$gradeduser,
		stdClass	$grader )

abstract

Get the grade for the specified user.

Parameters

stdClass	$gradeduser	The user being graded
stdClass	$grader	The user who is grading

Return values

stdClass The grade value

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ get_grade_instance_id()

core_grades\component_gradeitem::get_grade_instance_id ( )

abstract

Get the grade item instance id.

This is typically the cmid in the case of an activity, and relates to the iteminstance field in the grade_items table.

Return values

int

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ get_grade_item()

core_grades\component_gradeitem::get_grade_item ( )

Get the core grade item from the current component grade item.

This is mainly used to access the max grade for a gradeitem

Return values

grade_item The grade item

◆ get_grade_itemid()

core_grades\component_gradeitem::get_grade_itemid ( )

Get the itemid for the current gradeitem.

Return values

int

◆ get_grade_menu()

core_grades\component_gradeitem::get_grade_menu ( )

Get the list of available grade items.

Return values

array

◆ get_gradeitem_value()

core_grades\component_gradeitem::get_gradeitem_value ( )

abstractprotected

Get the grade value for this instance.

The itemname is translated to the relevant grade field for the activity.

Return values

int

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ get_grading_component_name()

core_grades\component_gradeitem::get_grading_component_name ( )

Get the name of the component responsible for grading this gradeitem.

Return values

string

◆ get_grading_component_subtype()

core_grades\component_gradeitem::get_grading_component_subtype ( )

Get the name of the component subtype responsible for grading this gradeitem.

Return values

string

◆ get_grading_manager()

core_grades\component_gradeitem::get_grading_manager ( )

protected

Get the grading manager for this advanced grading definition.

Return values

grading_manager

◆ get_scale()

core_grades\component_gradeitem::get_scale ( )

protected

Get the scale if a scale is being used.

Return values

stdClass

◆ get_table_name()

core_grades\component_gradeitem::get_table_name ( )

abstractprotected

The table name used for grading.

Return values

string

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ instance()

static core_grades\component_gradeitem::instance	(	string	$component,
		context	$context,
		string	$itemname )

static

Fetch an instance of a specific component_gradeitem.

Parameters

string	$component
context	$context
string	$itemname

Return values

self

◆ is_grading_enabled()

core_grades\component_gradeitem::is_grading_enabled ( )

abstract

Whether grading is enabled for this item.

Return values

bool

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ is_using_advanced_grading()

core_grades\component_gradeitem::is_using_advanced_grading ( )

Whether this grade item is configured to use advanced grading.

Return values

bool

◆ is_using_direct_grading()

core_grades\component_gradeitem::is_using_direct_grading ( )

Whether this grade item is configured to use direct grading.

Return values

bool

◆ is_using_scale()

core_grades\component_gradeitem::is_using_scale ( )

Check whether a scale is being used for this grade item.

Return values

bool

◆ load_from_context()

static core_grades\component_gradeitem::load_from_context ( context $context )

staticabstract

Load an instance of the current component_gradeitem based on context.

Parameters

context $context

Return values

self

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ require_user_can_grade()

core_grades\component_gradeitem::require_user_can_grade	(	stdClass	$gradeduser,
		stdClass	$grader )

abstract

Require that the user can grade, throwing an exception if not.

Parameters

stdClass	$gradeduser	The user being graded
stdClass	$grader	The user who is grading

Exceptions

required_capability_exception

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ send_student_notification()

core_grades\component_gradeitem::send_student_notification	(	stdClass	$gradeduser,
		stdClass	$grader )

Sends a notification about the item being graded for the student.

Parameters

stdClass	$gradeduser	The user being graded
stdClass	$grader	The user who is grading

◆ store_grade()

core_grades\component_gradeitem::store_grade ( stdClass $grade )

abstractprotected

Create or update the grade.

Parameters

stdClass $grade

Return values

bool Success

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ store_grade_from_formdata()

core_grades\component_gradeitem::store_grade_from_formdata	(	stdClass	$gradeduser,
		stdClass	$grader,
		stdClass	$formdata )

Create or update the grade.

Parameters

stdClass	$gradeduser	The user being graded
stdClass	$grader	The user who is grading
stdClass	$formdata	The data submitted

Return values

bool Success

◆ user_can_grade()

core_grades\component_gradeitem::user_can_grade	(	stdClass	$gradeduser,
		stdClass	$grader )

abstract

Whether the grader can grade the gradee.

Parameters

stdClass	$gradeduser	The user being graded
stdClass	$grader	The user who is grading

Return values

bool

Reimplemented in mod_forum\grades\forum_gradeitem.

◆ user_has_grade()

core_grades\component_gradeitem::user_has_grade ( stdClass $gradeduser )

abstract

Get the grade status for the specified user.

If the user has a grade as defined by the implementor return true else return false.

Parameters

stdClass $gradeduser The user being graded

Return values

bool	The grade status

Reimplemented in mod_forum\grades\forum_gradeitem.

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

grade/classes/component_gradeitem.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ allow_decimals()

◆ check_grade_validity()

◆ create_empty_grade()

◆ get_advanced_grading_controller()

◆ get_advanced_grading_instance()

◆ get_advanced_grading_method()

◆ get_all_grades()

◆ get_formatted_grade_for_user()

◆ get_grade()

◆ get_grade_for_user()

◆ get_grade_instance_id()

◆ get_grade_item()

◆ get_grade_itemid()

◆ get_grade_menu()

◆ get_gradeitem_value()

◆ get_grading_component_name()

◆ get_grading_component_subtype()

◆ get_grading_manager()

◆ get_scale()

◆ get_table_name()

◆ instance()

◆ is_grading_enabled()

◆ is_using_advanced_grading()

◆ is_using_direct_grading()

◆ is_using_scale()

◆ load_from_context()

◆ require_user_can_grade()

◆ send_student_notification()

◆ store_grade()

◆ store_grade_from_formdata()

◆ user_can_grade()

◆ user_has_grade()