gradingform_rubric_generator Class Reference

Generator for the gradingforum_rubric plugintype. More...

Inheritance diagram for gradingform_rubric_generator:

Public Member Functions
	create_instance (context $context, string $component, string $area, string $name, string $description, array $criteria)
	Create an instance of a rubric.
	get_level_and_criterion_for_values (gradingform_controller $controller, string $description, float $score)
	Given a controller instance, fetch the level and criterion information for the specified values.
	get_submitted_form_data (gradingform_rubric_controller $controller, int $itemid, array $values)
	Get submitted form data for the supplied controller, itemid, and values.
	get_test_form_data (gradingform_rubric_controller $controller, int $itemid, float $spellingscore, string $spellingremark, float $picturescore, string $pictureremark)
	Fetch a set of sample data.
	get_test_rubric (context $context, string $component, string $area)
	Generate a rubric controller with sample data required for testing of this class.
	reset ()
	To be called from data reset code only, do not use in tests.

Protected Member Functions
	get_criterion (string $description, array $levels=[])
	Get a new rubric for use with a gradingform_rubric_generator_rubric.
	get_rubric (string $name, string $description)
	Get a new rubric for use with the rubric controller.
	insert_files (stdClass $instance, stdClass $record, string $table, context $context, string $component, string $filearea, int $targetitemid)
	Update the instance record, inserting any files that are referenced.
	set_user (?stdClass $user=null)
	Set the current user during data generation.

Protected Attributes
testing_data_generator	$datagenerator

Detailed Description

Generator for the gradingforum_rubric plugintype.

Copyright

2019 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

Member Function Documentation

create_instance()

gradingform_rubric_generator::create_instance	(	context	$context,
		string	$component,
		string	$area,
		string	$name,
		string	$description,
		array	$criteria )

Create an instance of a rubric.

Parameters

context	$context
string	$component
string	$area
string	$name
string	$description
array	$criteria	The list of criteria to add to the generated rubric

Return values

gradingform_rubric_controller

get_criterion()

gradingform_rubric_generator::get_criterion ( string $description, array $levels = [] )

protected

Get a new rubric for use with a gradingform_rubric_generator_rubric.

Note: This is just a helper class used to build a new definition. It does not persist the data.

Parameters

string	$description
array	$levels	Set of levels in the form definition => score

Return values

gradingform_rubric_generator_criterion

get_level_and_criterion_for_values()

gradingform_rubric_generator::get_level_and_criterion_for_values	(	gradingform_controller	$controller,
		string	$description,
		float	$score )

Given a controller instance, fetch the level and criterion information for the specified values.

Parameters

gradingform_controller	$controller
string	$description	The description to match the criterion on
float	$score	The value to match the level on

Return values

array

get_rubric()

gradingform_rubric_generator::get_rubric ( string $name, string $description )

protected

Get a new rubric for use with the rubric controller.

Note: This is just a helper class used to build a new definition. It does not persist the data.

Parameters

string	$name
string	$description

Return values

rubric

get_submitted_form_data()

gradingform_rubric_generator::get_submitted_form_data	(	gradingform_rubric_controller	$controller,
		int	$itemid,
		array	$values )

Get submitted form data for the supplied controller, itemid, and values.

The returned data is in the format used by rubric when handling form submission.

Parameters

gradingform_rubric_controller	$controller
int	$itemid
array	$values	A set of array values where the array key is the name of the criterion, and the value is an array with the desired score, and any remark.

get_test_form_data()

gradingform_rubric_generator::get_test_form_data	(	gradingform_rubric_controller	$controller,
		int	$itemid,
		float	$spellingscore,
		string	$spellingremark,
		float	$picturescore,
		string	$pictureremark )

Fetch a set of sample data.

Parameters

gradingform_rubric_controller	$controller
int	$itemid
float	$spellingscore
string	$spellingremark
float	$picturescore
string	$pictureremark

Return values

array

get_test_rubric()

gradingform_rubric_generator::get_test_rubric	(	context	$context,
		string	$component,
		string	$area )

Generate a rubric controller with sample data required for testing of this class.

Parameters

context	$context
string	$component
string	$area

Return values

gradingform_rubric_controller

insert_files()

component_generator_base::insert_files ( stdClass $instance, stdClass $record, string $table, context $context, string $component, string $filearea, int $targetitemid )

protectedinherited

Update the instance record, inserting any files that are referenced.

Parameters

stdClass	$instance	The instance record of the already-created record
stdClass	$record	The data passed in to create the instance
string	$table	The table that the data exists in
context	$context	The context of the instance
string	$component	The component of the owning plugin
string	$filearea	The name of the file area
int	$targetitemid	The itemid to use when saving the files

Return values

stdClass

The updated instance record

reset()

component_generator_base::reset ( )

inherited

To be called from data reset code only, do not use in tests.

Return values

void

Reimplemented in core_competency_generator, core_notes_generator, core_question_generator, mod_book_generator, mod_chat_generator, mod_data_generator, mod_forum_generator, mod_glossary_generator, mod_lesson_generator, mod_survey_generator, mod_wiki_generator, testing_block_generator, testing_module_generator, testing_repository_generator, and tool_dataprivacy_generator.

set_user()

component_generator_base::set_user ( ?stdClass $user = null )

protectedinherited

Set the current user during data generation.

This should be avoided wherever possible, but in some situations underlying code will insert data as the current user.

Parameters

stdClass

$user

---

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

• grade/grading/form/rubric/tests/generator/lib.php