Moodle APIs 3.9
Moodle 3.9.13+ (Build: 20220325)
Public Member Functions | Static Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
gradingform_rubric_renderer Class Reference

Grading method plugin renderer. More...

Inheritance diagram for gradingform_rubric_renderer:
plugin_renderer_base renderer_base

Public Member Functions

 __call ($method, $arguments)
 Magic method used to pass calls otherwise meant for the standard renderer to it to ensure we don't go causing unnecessary grief. More...
 
 add_action_handler (component_action $action, $id=null)
 Adds a JS action for the element with the provided id. More...
 
 criterion_template ($mode, $options, $elementname='{NAME}', $criterion=null, $levelsstr='{LEVELS}', $value=null)
 This function returns html code for displaying criterion. More...
 
 display_instance (gradingform_rubric_instance $instance, $idx, $cangrade)
 Displays one grading instance. More...
 
 display_instances ($instances, $defaultcontent, $cangrade)
 Displays for the student the list of instances or default content if no instances found. More...
 
 display_regrade_confirmation ($elementname, $changelevel, $value)
 Displays confirmation that students require re-grading. More...
 
 display_rubric ($criteria, $options, $mode, $elementname=null, $values=null)
 This function returns html code for displaying rubric. More...
 
 display_rubric_mapping_explained ($scores)
 Generates and returns HTML code to display information box about how rubric score is converted to the grade. More...
 
 get_compact_logo_url ($maxwidth=300, $maxheight=300)
 Return the site's compact logo URL, if any. More...
 
 get_logo_url ($maxwidth=null, $maxheight=200)
 Return the site's logo URL, if any. More...
 
 has_started ()
 Returns true is output has already started, and false if not. More...
 
 image_url ($imagename, $component='moodle')
 Return the moodle_url for an image. More...
 
 level_template ($mode, $options, $elementname='{NAME}', $criterionid='{CRITERION-id}', $level=null)
 This function returns html code for displaying one level of one criterion. More...
 
 pix_url ($imagename, $component='moodle')
 Return the direct URL for an image from the pix folder. More...
 
 render (renderable $widget)
 Renders the provided widget and returns the HTML to display it. More...
 
 render_from_template ($templatename, $context)
 Renders a template by name with the given context. More...
 
 should_display_main_logo ($headinglevel=1)
 Whether we should display the main logo. More...
 
 should_display_navbar_logo ()
 Whether we should display the logo in the navbar. More...
 

Static Public Member Functions

static prepare_classes ($classes)
 Given an array or space-separated list of classes, prepares and returns the HTML class attribute value. More...
 

Protected Member Functions

 get_css_class_suffix ($idx, $maxidx)
 Help function to return CSS class names for element (first/last/even/odd) with leading space. More...
 
 get_mustache ()
 Return an instance of the mustache class. More...
 
 rubric_edit_options ($mode, $options)
 Generates html template to view/edit the rubric options. More...
 
 rubric_template ($mode, $options, $elementname, $criteriastr)
 This function returns html code for displaying rubric template (content before and after criteria list). More...
 

Protected Attributes

xhtml_container_stack $opencontainers
 The xhtml_container_stack to use.
 
renderer_base core_renderer $output
 A reference to the current renderer. More...
 
moodle_page $page
 The Moodle page the renderer has been created to assist with.
 
string $target
 The requested rendering target.
 

Detailed Description

Grading method plugin renderer.

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

Member Function Documentation

◆ __call()

plugin_renderer_base::__call (   $method,
  $arguments 
)
inherited

Magic method used to pass calls otherwise meant for the standard renderer to it to ensure we don't go causing unnecessary grief.

Parameters
string$method
array$arguments
Return values
mixed

◆ add_action_handler()

renderer_base::add_action_handler ( component_action  $action,
  $id = null 
)
inherited

Adds a JS action for the element with the provided id.

This method adds a JS event for the provided component action to the page and then returns the id that the event has been attached to. If no id has been provided then a new ID is generated by html_writer::random_id()

Parameters
component_action$action
string$id
Return values
stringid of element, either original submitted or random new if not supplied

◆ criterion_template()

gradingform_rubric_renderer::criterion_template (   $mode,
  $options,
  $elementname = '{NAME}',
  $criterion = null,
  $levelsstr = '{LEVELS}',
  $value = null 
)

This function returns html code for displaying criterion.

Depending on $mode it may be the code to edit rubric, to preview the rubric, to evaluate somebody or to review the evaluation.

This function may be called from display_rubric() to display the whole rubric, or it can be called by itself to return a template used by JavaScript to add new empty criteria to the rubric being designed. In this case it will use macros like {NAME}, {LEVELS}, {CRITERION-id}, etc.

When overriding this function it is very important to remember that all elements of html form (in edit or evaluate mode) must have the name $elementname.

Also JavaScript relies on the class names of elements and when developer changes them script might stop working.

Parameters
int$moderubric display mode, see gradingform_rubric_controller
array$optionsdisplay options for this rubric, defaults are: gradingform_rubric_controller::get_default_options()
string$elementnamethe name of the form element (in editor mode) or the prefix for div ids (in view mode)
array | null$criterioncriterion data
string$levelsstrevaluated templates for this criterion levels
array | null$value(only in view mode) teacher's feedback on this criterion
Return values
string

◆ display_instance()

gradingform_rubric_renderer::display_instance ( gradingform_rubric_instance  $instance,
  $idx,
  $cangrade 
)

Displays one grading instance.

Parameters
gradingform_rubric_instance$instance
int$idxunique number of instance on page
bool$cangradewhether current user has capability to grade in this context

◆ display_instances()

gradingform_rubric_renderer::display_instances (   $instances,
  $defaultcontent,
  $cangrade 
)

Displays for the student the list of instances or default content if no instances found.

Parameters
array$instancesarray of objects of type gradingform_rubric_instance
string$defaultcontentdefault string that would be displayed without advanced grading
boolean$cangradewhether current user has capability to grade in this context
Return values
string

◆ display_regrade_confirmation()

gradingform_rubric_renderer::display_regrade_confirmation (   $elementname,
  $changelevel,
  $value 
)

Displays confirmation that students require re-grading.

Parameters
string$elementname
int$changelevel
string$value
Return values
string

◆ display_rubric()

gradingform_rubric_renderer::display_rubric (   $criteria,
  $options,
  $mode,
  $elementname = null,
  $values = null 
)

This function returns html code for displaying rubric.

Depending on $mode it may be the code to edit rubric, to preview the rubric, to evaluate somebody or to review the evaluation.

It is very unlikely that this function needs to be overriden by theme. It does not produce any html code, it just prepares data about rubric design and evaluation, adds the CSS class to elements and calls the functions level_template, criterion_template and rubric_template

Parameters
array$criteriadata about the rubric design
array$optionsdisplay options for this rubric, defaults are: gradingform_rubric_controller::get_default_options()
int$moderubric display mode, see gradingform_rubric_controller
string$elementnamethe name of the form element (in editor mode) or the prefix for div ids (in view mode)
array$valuesevaluation result
Return values
string

◆ display_rubric_mapping_explained()

gradingform_rubric_renderer::display_rubric_mapping_explained (   $scores)

Generates and returns HTML code to display information box about how rubric score is converted to the grade.

Parameters
array$scores
Return values
string

◆ get_compact_logo_url()

renderer_base::get_compact_logo_url (   $maxwidth = 300,
  $maxheight = 300 
)
inherited

Return the site's compact logo URL, if any.

Parameters
int$maxwidthThe maximum width, or null when the maximum width does not matter.
int$maxheightThe maximum height, or null when the maximum height does not matter.
Return values
moodle_url|false

◆ get_css_class_suffix()

gradingform_rubric_renderer::get_css_class_suffix (   $idx,
  $maxidx 
)
protected

Help function to return CSS class names for element (first/last/even/odd) with leading space.

Parameters
int$idxindex of this element in the row/column
int$maxidxmaximum index of the element in the row/column
Return values
string

◆ get_logo_url()

renderer_base::get_logo_url (   $maxwidth = null,
  $maxheight = 200 
)
inherited

Return the site's logo URL, if any.

Parameters
int$maxwidthThe maximum width, or null when the maximum width does not matter.
int$maxheightThe maximum height, or null when the maximum height does not matter.
Return values
moodle_url|false

◆ get_mustache()

renderer_base::get_mustache ( )
protectedinherited

Return an instance of the mustache class.

Since
2.9
Return values
Mustache_Engine

◆ has_started()

renderer_base::has_started ( )
inherited

Returns true is output has already started, and false if not.

Return values
booleantrue if the header has been printed.

◆ image_url()

renderer_base::image_url (   $imagename,
  $component = 'moodle' 
)
inherited

Return the moodle_url for an image.

The exact image location and extension is determined automatically by searching for gif|png|jpg|jpeg, please note there can not be diferent images with the different extension. The imagename is for historical reasons a relative path name, it may be changed later for core images. It is recommended to not use subdirectories in plugin and theme pix directories.

There are three types of images: 1/ theme images - stored in theme/mytheme/pix/, use component 'theme' 2/ core images - stored in /pix/, overridden via theme/mytheme/pix_core/ 3/ plugin images - stored in mod/mymodule/pix, overridden via theme/mytheme/pix_plugins/mod/mymodule/, example: image_url('comment', 'mod_glossary')

Parameters
string$imagenamethe pathname of the image
string$componentfull plugin name (aka component) or 'theme'
Return values
moodle_url

◆ level_template()

gradingform_rubric_renderer::level_template (   $mode,
  $options,
  $elementname = '{NAME}',
  $criterionid = '{CRITERION-id}',
  $level = null 
)

This function returns html code for displaying one level of one criterion.

Depending on $mode it may be the code to edit rubric, to preview the rubric, to evaluate somebody or to review the evaluation.

This function may be called from display_rubric() to display the whole rubric, or it can be called by itself to return a template used by JavaScript to add new empty level to the criterion during the design of rubric. In this case it will use macros like {NAME}, {CRITERION-id}, {LEVEL-id}, etc.

When overriding this function it is very important to remember that all elements of html form (in edit or evaluate mode) must have the name $elementname.

Also JavaScript relies on the class names of elements and when developer changes them script might stop working.

Parameters
int$moderubric display mode see gradingform_rubric_controller
array$optionsdisplay options for this rubric, defaults are: gradingform_rubric_controller::get_default_options()
string$elementnamethe name of the form element (in editor mode) or the prefix for div ids (in view mode)
string | int$criterionideither id of the nesting criterion or a macro for template
array | null$levellevel data, also in view mode it might also have property $level['checked'] whether this level is checked
Return values
string

◆ pix_url()

renderer_base::pix_url (   $imagename,
  $component = 'moodle' 
)
inherited

Return the direct URL for an image from the pix folder.

Use this function sparingly and never for icons. For icons use pix_icon or the pix helper in a mustache template.

Deprecated:
since Moodle 3.3
Parameters
string$imagenamethe name of the icon.
string$componentspecification of one plugin like in get_string()
Return values
moodle_url

◆ prepare_classes()

static renderer_base::prepare_classes (   $classes)
staticinherited

Given an array or space-separated list of classes, prepares and returns the HTML class attribute value.

Parameters
mixed$classesSpace-separated string or array of classes
Return values
stringHTML class attribute value

◆ render()

plugin_renderer_base::render ( renderable  $widget)
inherited

Renders the provided widget and returns the HTML to display it.

Parameters
renderable$widgetinstance with renderable interface
Return values
string

Reimplemented from renderer_base.

Reimplemented in tool_policy\output\renderer.

◆ render_from_template()

renderer_base::render_from_template (   $templatename,
  $context 
)
inherited

Renders a template by name with the given context.

The provided data needs to be array/stdClass made up of only simple types. Simple types are array,stdClass,bool,int,float,string

Since
2.9
Parameters
array | stdClass$contextContext containing data for the template.
Return values
string|boolean

◆ rubric_edit_options()

gradingform_rubric_renderer::rubric_edit_options (   $mode,
  $options 
)
protected

Generates html template to view/edit the rubric options.

Expression {NAME} is used in template for the form element name

Parameters
int$moderubric display mode see gradingform_rubric_controller
array$optionsdisplay options for this rubric, defaults are: gradingform_rubric_controller::get_default_options()
Return values
string

◆ rubric_template()

gradingform_rubric_renderer::rubric_template (   $mode,
  $options,
  $elementname,
  $criteriastr 
)
protected

This function returns html code for displaying rubric template (content before and after criteria list).

Depending on $mode it may be the code to edit rubric, to preview the rubric, to evaluate somebody or to review the evaluation.

This function is called from display_rubric() to display the whole rubric.

When overriding this function it is very important to remember that all elements of html form (in edit or evaluate mode) must have the name $elementname.

Also JavaScript relies on the class names of elements and when developer changes them script might stop working.

Parameters
int$moderubric display mode see gradingform_rubric_controller
array$optionsdisplay options for this rubric, defaults are: gradingform_rubric_controller::get_default_options()
string$elementnamethe name of the form element (in editor mode) or the prefix for div ids (in view mode)
string$criteriastrevaluated templates for this rubric's criteria
Return values
string

◆ should_display_main_logo()

renderer_base::should_display_main_logo (   $headinglevel = 1)
inherited

Whether we should display the main logo.

Parameters
int$headinglevelThe heading level we want to check against.
Return values
bool

◆ should_display_navbar_logo()

renderer_base::should_display_navbar_logo ( )
inherited

Whether we should display the logo in the navbar.

We will when there are no main logos, and we have compact logo.

Return values
bool

Member Data Documentation

◆ $output

renderer_base core_renderer plugin_renderer_base::$output
protectedinherited

A reference to the current renderer.

The renderer provided here will be determined by the page but will in 90% of cases by the core_renderer


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