workshop_numerrors_strategy Class Reference

Inheritance diagram for workshop_numerrors_strategy:

Collaboration diagram for workshop_numerrors_strategy:

Public Member Functions
	__construct (workshop $workshop)
	get_edit_strategy_form ($actionurl=null)
	save_edit_strategy_form (stdclass $data)
	get_assessment_form (moodle_url $actionurl=null, $mode='preview', stdclass $assessment=null, $editable=true, $options=array())
	save_assessment (stdclass $assessment, stdclass $data)
	form_ready ()
	get_assessments_recordset ($restrict=null)
	get_dimensions_info ()
Static Public Member Functions
static	scale_used ($scaleid, $workshopid=null)
static	delete_instance ($workshopid)
Data Fields
const	MINDIMS = 3
const	ADDDIMS = 2
Protected Member Functions
	load_fields ()
	load_mappings ()
	prepare_form_fields (array $dims, array $maps)
	delete_dimensions (array $ids)
	prepare_database_fields (stdclass $raw)
	get_current_assessment_data (stdclass $assessment)
	update_peer_grade (stdclass $assessment)
	calculate_peer_grade (array $grades)
	errors_to_grade ($numerrors)
Protected Attributes
	$workshop
	$dimensions = null
	$mappings = null
	$descriptionopts

---

Detailed Description

"Number of errors" grading strategy logic.

Definition at line 70 of file lib.php.

---

Constructor & Destructor Documentation

__construct

(

workshop $

workshop

)

Constructor

Parameters:

workshop

$workshop

The workshop instance record

Returns:

void

Definition at line 96 of file lib.php.

Here is the call graph for this function:

---

Member Function Documentation

calculate_peer_grade

(

array $

grades

)

[protected]

Calculates the aggregated grade given by the reviewer

Parameters:

array

$grades

Grade records as returned by get_current_assessment_data

Returns:

float|null Raw grade (0.00000 to 100.00000) for submission as suggested by the peer

Reimplemented in testable_workshop_numerrors_strategy.

Definition at line 560 of file lib.php.

Here is the call graph for this function:

delete_dimensions

(

array $

ids

)

[protected]

Deletes dimensions and removes embedded media from its descriptions

todo we may check that there are no assessments done using these dimensions and probably remove them

Parameters:

array

$ids

list to delete

Returns:

void

Definition at line 464 of file lib.php.

Here is the call graph for this function:

static delete_instance

(

$

workshopid

)

[static]

Delete all data related to a given workshop module instance

See also:

workshop_delete_instance()

Parameters:

int

$workshopid

id of the workshop module instance being deleted

Returns:

void

Implements workshop_strategy.

Definition at line 389 of file lib.php.

errors_to_grade

(

$

numerrors

)

[protected]

Returns a grade 0.00000 to 100.00000 for the given number of errors

This is where we use the mapping table defined by the teacher. If a grade for the given number of errors (negative assertions) is not defined, the most recently defined one is used. Example of the defined mapping: Number of errors | Grade 0 | 100% (always) 1 | - (not defined) 2 | 80% 3 | 60% 4 | - 5 | 30% 6 | 0% With this mapping, one error is mapped to 100% grade and 4 errors is mapped to 60%.

Parameters:

mixed

$numerrors

Number of errors

Returns:

float Raw grade (0.00000 to 100.00000) for the given number of negative assertions

Definition at line 593 of file lib.php.

Here is the call graph for this function:

form_ready

(

)

Has the assessment form been defined and is ready to be used by the reviewers?

Returns:

boolean

Implements workshop_strategy.

Definition at line 316 of file lib.php.

get_assessment_form	(	moodle_url $	actionurl = null,
		$	mode = 'preview',
		stdclass $	assessment = null,
		$	editable = true,
		$	options = array()
	)

Factory method returning an instance of an assessment form

Parameters:

moodle_url	$actionurl	URL of form handler, defaults to auto detect the current url
string	$mode	Mode to open the form in: preview/assessment
stdClass	$assessment
bool	$editable
array	$options

Implements workshop_strategy.

Definition at line 232 of file lib.php.

Here is the call graph for this function:

get_assessments_recordset

(

$

restrict = null

)

See also:

parent::get_assessments_recordset()

Implements workshop_strategy.

Definition at line 326 of file lib.php.

get_current_assessment_data

(

stdclass $

assessment

)

[protected]

Returns the list of current grades filled by the reviewer

Parameters:

stdClass

$assessment

Assessment record

Returns:

array of filtered records from the table workshop_grades

Definition at line 522 of file lib.php.

get_dimensions_info

(

)

See also:

parent::get_dimensions_info()

Implements workshop_strategy.

Definition at line 357 of file lib.php.

get_edit_strategy_form

(

$

actionurl = null

)

Factory method returning an instance of an assessment form editor class

Parameters:

$actionurl

URL of form handler, defaults to auto detect the current url

Implements workshop_strategy.

Definition at line 108 of file lib.php.

Here is the call graph for this function:

load_fields

(

)

[protected]

Loads the fields of the assessment form currently used in this workshop

Returns:

array definition of assessment dimensions

Definition at line 405 of file lib.php.

Here is the caller graph for this function:

load_mappings

(

)

[protected]

Loads the mappings of the number of errors to the grade

Returns:

array of records

Definition at line 422 of file lib.php.

Here is the caller graph for this function:

prepare_database_fields

(

stdclass $

raw

)

[protected]

Prepares data returned by workshop_edit_numerrors_strategy_form so they can be saved into database

It automatically adds some columns into every record. The sorting is done by the order of the returned array and starts with 1. Called internally from save_edit_strategy_form() only. Could be private but keeping protected for unit testing purposes.

Parameters:

stdClass

$raw

Raw data returned by mform

Returns:

array Array of objects to be inserted/updated in DB

Definition at line 485 of file lib.php.

prepare_form_fields	(	array $	dims,
		array $	maps
	)		[protected]

Prepares the database data to be used by the mform

Parameters:

array	$dims	Array of raw dimension records as returned by load_fields()
array	$maps	Array of raw mapping records as returned by load_mappings()

Returns:

array Array of fields data to be used by the mform set_data

Definition at line 435 of file lib.php.

Here is the caller graph for this function:

save_assessment	(	stdclass $	assessment,
		stdclass $	data
	)

Saves the filled assessment

This method processes data submitted using the form returned by get_assessment_form()

Parameters:

stdClass	$assessment	Assessment being filled
stdClass	$data	Raw data as returned by the assessment form

Returns:

float|null Raw grade (from 0.00000 to 100.00000) for submission as suggested by the peer

Implements workshop_strategy.

Definition at line 285 of file lib.php.

save_edit_strategy_form

(

stdclass $

data

)

Save the assessment dimensions into database

Saves data into the main strategy form table. If the record->id is null or zero, new record is created. If the record->id is not empty, the existing record is updated. Records with empty 'description' field are removed from database. The passed data object are the raw data returned by the get_data().

$DB

Parameters:

stdClass

$data

Raw data returned by the dimension editor form

Returns:

void

Implements workshop_strategy.

Definition at line 157 of file lib.php.

Here is the call graph for this function:

static scale_used	(	$	scaleid,
		$	workshopid = null
	)		[static]

Is a given scale used by the instance of workshop?

This grading strategy does not use scales.

Parameters:

int	$scaleid	id of the scale to check
int | null	$workshopid	id of workshop instance to check, checks all in case of null

Returns:

bool

Implements workshop_strategy.

Definition at line 378 of file lib.php.

update_peer_grade

(

stdclass $

assessment

)

[protected]

Aggregates the assessment form data and sets the grade for the submission given by the peer

Parameters:

stdClass

$assessment

Assessment record

Returns:

float|null Raw grade (0.00000 to 100.00000) for submission as suggested by the peer

Definition at line 545 of file lib.php.

Here is the call graph for this function:

---

Field Documentation

$descriptionopts [protected]

Definition at line 88 of file lib.php.

$dimensions = null [protected]

Reimplemented in testable_workshop_numerrors_strategy.

Definition at line 82 of file lib.php.

$mappings = null [protected]

Reimplemented in testable_workshop_numerrors_strategy.

Definition at line 85 of file lib.php.

$workshop [protected]

Definition at line 79 of file lib.php.

const ADDDIMS = 2

number of dimensions to add

Definition at line 76 of file lib.php.

const MINDIMS = 3

default number of dimensions to show

Definition at line 73 of file lib.php.

---

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

• C:/xampp/htdocs/moodle/mod/workshop/form/numerrors/lib.php