This renderer controls the overall output of questions. More...

Inheritance diagram for core_question_renderer:

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.

	add_action_handler (component_action $action, $id=null)
	Adds a JS action for the element with the provided id.

	get_compact_logo_url ($maxwidth=300, $maxheight=300)
	Return the site's compact logo URL, if any.

	get_logo_url ($maxwidth=null, $maxheight=200)
	Return the site's logo URL, if any.

	get_page ()
	Returns the moodle page object.

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

	image_url ($imagename, $component='moodle')
	Return the moodle_url for an image.

	pix_url ($imagename, $component='moodle')
	Return the direct URL for an image from the pix folder.

	question (question_attempt $qa, qbehaviour_renderer $behaviouroutput, qtype_renderer $qtoutput, question_display_options $options, $number)
	Generate the display of a question in a particular state, and with certain display options.

	question_preview_link ()

	render (renderable $widget)
	Renders the provided widget and returns the HTML to display it.

	render_from_template ($templatename, $context)
	Renders a template by name with the given context.

	should_display_main_logo ($headinglevel=1)
	Whether we should display the main logo.

	should_display_navbar_logo ()
	Whether we should display the logo in the navbar.

	standard_mark_out_of_max (question_attempt $qa, question_display_options $options)
	Generate the display of the marks for this question out of the available marks.

	standard_mark_summary (question_attempt $qa, qbehaviour_renderer $behaviouroutput, question_display_options $options)
	Generate the display of the marks for this question.

	standard_marked_out_of_max (question_attempt $qa, question_display_options $options)
	Generate the display of the available marks for this question.

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.

Protected Member Functions
	action_author (question_attempt_step $step, question_display_options $options)
	Action author's profile link.

	add_part_heading ($heading, $content)
	Add an invisible heading like 'question text', 'feebdack' at the top of a section's contents, but only if the section has some content.

	edit_question_link (question_attempt $qa, question_display_options $options)
	Generate the display of the edit question link.

	formulation (question_attempt $qa, qbehaviour_renderer $behaviouroutput, qtype_renderer $qtoutput, question_display_options $options)
	Generate the display of the formulation part of the question.

	get_flag_html ($flagged, $id='')
	Work out the actual img tag needed for the flag.

	get_mustache ()
	Return an instance of the mustache class.

	info (question_attempt $qa, qbehaviour_renderer $behaviouroutput, qtype_renderer $qtoutput, question_display_options $options, $number)
	Generate the information bit of the question display that contains the metadata like the question number, current state, and mark.

	manual_comment (question_attempt $qa, qbehaviour_renderer $behaviouroutput, qtype_renderer $qtoutput, question_display_options $options)

	mark_summary (question_attempt $qa, qbehaviour_renderer $behaviouroutput, question_display_options $options)
	Generate the display of the marks for this question.

	number ($number)
	Generate the display of the question number.

	outcome (question_attempt $qa, qbehaviour_renderer $behaviouroutput, qtype_renderer $qtoutput, question_display_options $options)
	Generate the display of the outcome part of the question.

	question_flag (question_attempt $qa, $flagsoption)
	Render the question flag, assuming $flagsoption allows it.

	question_number_text (?string $number)
	Get the question number as a string.

	response_history (question_attempt $qa, qbehaviour_renderer $behaviouroutput, qtype_renderer $qtoutput, question_display_options $options)
	Generate the display of the response history part of the question.

	status (question_attempt $qa, qbehaviour_renderer $behaviouroutput, question_display_options $options)
	Generate the display of the status line that gives the current state of the question.

Protected Attributes
xhtml_container_stack	$opencontainers
	The xhtml_container_stack to use.

renderer_base core_renderer	$output
	A reference to the current renderer.

moodle_page	$page
	The Moodle page the renderer has been created to assist with.

string	$target
	The requested rendering target.

array	$templatecache = []
	$templatecache The mustache template cache.

Detailed Description

This renderer controls the overall output of questions.

It works with a qbehaviour_renderer and a qtype_renderer to output the type-specific bits. The main entry point is the question() method.

Copyright: 2009 The Open University

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

Member Function Documentation

◆ action_author()

core_question_renderer::action_author	(	question_attempt_step	$step,
		question_display_options	$options )

protected

Action author's profile link.

Parameters

question_attempt_step	$step	The step.
question_display_options	$options	The display options.

Return values

string The link to user's profile.

◆ add_part_heading()

core_question_renderer::add_part_heading	(		$heading,
			$content )

protected

Add an invisible heading like 'question text', 'feebdack' at the top of a section's contents, but only if the section has some content.

Parameters

string	$heading	the heading to add.
string	$content	the content of the section.

Return values

string HTML fragment with the heading added.

◆ edit_question_link()

core_question_renderer::edit_question_link	(	question_attempt	$qa,
		question_display_options	$options )

protected

Generate the display of the edit question link.

Parameters

question_attempt	$qa	The question attempt to display.
question_display_options	$options	controls what should and should not be displayed.

Return values

string

◆ formulation()

core_question_renderer::formulation	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		qtype_renderer	$qtoutput,
		question_display_options	$options )

protected

Generate the display of the formulation part of the question.

This is the area that contains the quetsion text, and the controls for students to input their answers. Some question types also embed feedback, for example ticks and crosses, in this area.

Parameters

question_attempt	$qa	the question attempt to display.
qbehaviour_renderer	$behaviouroutput	the renderer to output the behaviour specific parts.
qtype_renderer	$qtoutput	the renderer to output the question type specific parts.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

◆ get_flag_html()

core_question_renderer::get_flag_html	(		$flagged,
			$id = '' )

protected

Work out the actual img tag needed for the flag.

Parameters

bool	$flagged	whether the question is currently flagged.
string	$id	an id to be added as an attribute to the img (optional).

Return values

string the img tag.

◆ info()

core_question_renderer::info	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		qtype_renderer	$qtoutput,
		question_display_options	$options,
			$number )

protected

Generate the information bit of the question display that contains the metadata like the question number, current state, and mark.

Parameters

question_attempt	$qa	the question attempt to display.
qbehaviour_renderer	$behaviouroutput	the renderer to output the behaviour specific parts.
qtype_renderer	$qtoutput	the renderer to output the question type specific parts.
question_display_options	$options	controls what should and should not be displayed.
string \| null	$number	The question number to display. 'i' is a special value that gets displayed as Information. Null means no number is displayed.

Return values

HTML fragment.

◆ mark_summary()

core_question_renderer::mark_summary	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		question_display_options	$options )

protected

Generate the display of the marks for this question.

Parameters

question_attempt	$qa	the question attempt to display.
qbehaviour_renderer	$behaviouroutput	the behaviour renderer, which can generate a custom display.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

◆ number()

core_question_renderer::number ( $number )

protected

Generate the display of the question number.

Parameters

string | null $number The question number to display. 'i' is a special value that gets displayed as Information. Null means no number is displayed.

Return values

HTML fragment.

◆ outcome()

core_question_renderer::outcome	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		qtype_renderer	$qtoutput,
		question_display_options	$options )

protected

Generate the display of the outcome part of the question.

This is the area that contains the various forms of feedback.

Parameters

question_attempt	$qa	the question attempt to display.
qbehaviour_renderer	$behaviouroutput	the renderer to output the behaviour specific parts.
qtype_renderer	$qtoutput	the renderer to output the question type specific parts.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

◆ question()

core_question_renderer::question	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		qtype_renderer	$qtoutput,
		question_display_options	$options,
			$number )

Generate the display of a question in a particular state, and with certain display options.

Normally you do not call this method directly. Intsead you call question_usage_by_activity::render_question() which will call this method with appropriate arguments.

Parameters

question_attempt	$qa	the question attempt to display.
qbehaviour_renderer	$behaviouroutput	the renderer to output the behaviour specific parts.
qtype_renderer	$qtoutput	the renderer to output the question type specific parts.
question_display_options	$options	controls what should and should not be displayed.
string \| null	$number	The question number to display. 'i' is a special value that gets displayed as Information. Null means no number is displayed.

Return values

string HTML representation of the question.

◆ question_flag()

core_question_renderer::question_flag	(	question_attempt	$qa,
			$flagsoption )

protected

Render the question flag, assuming $flagsoption allows it.

Parameters

question_attempt	$qa	the question attempt to display.
int	$flagsoption	the option that says whether flags should be displayed.

◆ question_number_text()

core_question_renderer::question_number_text ( ?string $number )

protected

Get the question number as a string.

Parameters

string | null $number e.g. '123' or 'i'. null or '' means do not display anything number-related.

Return values

string e.g. 'Question 123' or 'Information' or ''.

◆ question_preview_link()

core_question_renderer::question_preview_link ( )

Deprecated: since Moodle 4.0

◆ response_history()

core_question_renderer::response_history	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		qtype_renderer	$qtoutput,
		question_display_options	$options )

protected

Generate the display of the response history part of the question.

This is the table showing all the steps the question has been through.

Parameters

question_attempt	$qa	the question attempt to display.
qbehaviour_renderer	$behaviouroutput	the renderer to output the behaviour specific parts.
qtype_renderer	$qtoutput	the renderer to output the question type specific parts.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

◆ standard_mark_out_of_max()

core_question_renderer::standard_mark_out_of_max	(	question_attempt	$qa,
		question_display_options	$options )

Generate the display of the marks for this question out of the available marks.

Parameters

question_attempt	$qa	the question attempt to display.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

◆ standard_mark_summary()

core_question_renderer::standard_mark_summary	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		question_display_options	$options )

Generate the display of the marks for this question.

Parameters

question_attempt	$qa	the question attempt to display.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

◆ standard_marked_out_of_max()

core_question_renderer::standard_marked_out_of_max	(	question_attempt	$qa,
		question_display_options	$options )

Generate the display of the available marks for this question.

Parameters

question_attempt	$qa	the question attempt to display.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

◆ status()

core_question_renderer::status	(	question_attempt	$qa,
		qbehaviour_renderer	$behaviouroutput,
		question_display_options	$options )

protected

Generate the display of the status line that gives the current state of the question.

Parameters

question_attempt	$qa	the question attempt to display.
qbehaviour_renderer	$behaviouroutput	the renderer to output the behaviour specific parts.
question_display_options	$options	controls what should and should not be displayed.

Return values

HTML fragment.

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

question/engine/renderer.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Function Documentation

◆ action_author()

◆ add_part_heading()

◆ edit_question_link()

◆ formulation()

◆ get_flag_html()

◆ info()

◆ mark_summary()

◆ number()

◆ outcome()

◆ question()

◆ question_flag()

◆ question_number_text()

◆ question_preview_link()

◆ response_history()

◆ standard_mark_out_of_max()

◆ standard_mark_summary()

◆ standard_marked_out_of_max()

◆ status()