Inheritance diagram for lesson_page_type_matching:

Public Member Functions
	__get ($key)
	Magic get method.

	__isset ($key)
	Stupid PHP needs an isset magic method if you use the get magic method and still want empty calls to work....

	__set ($key, $value)
	Magic property method.

	add_page_link ($previd)
	Can be set to true if the page requires a static link to create a new instance instead of simply being included in the dropdown.

	callback_on_view ($canmanage, $redirect=true)
	This is a callback method that can be override and gets called when ever a page is viewed.

	check_answer ()
	This method MUST be overridden by all question page types, or page types that wish to score a page.

	create_answers ($properties)
	Creates answers within the database for this lesson_page.

	delete ()
	Deletes a lesson_page from the database as well as any associated records.

	display ($renderer, $attempt)
	This method gets called to display the page to the user taking the lesson @abstract.

	display_answers (html_table $table)
	Updates a table with the answers for this page.

	earned_score ($answers, $attempt)
	Returns the score for the attempt This may be overridden by page types that require manual grading.

	format_answer ($answer, $context, $answerformat, $options=[])
	Formats the answer.

	get_answers ()
	Returns the answers that are associated with this page in the database.

	get_contents ()
	Returns the contents field for the page properly formatted and with plugin file url's converted.

	get_files ($includedirs=true, $updatedsince=0)
	Get files from the page area file.

	get_idstring ()

	get_jumps ()
	Gets an array of the jumps used by the answers of this page.

	get_typeid ()
	This method should return the integer used to identify the page type within the database and throughout code.

	get_typestring ()
	This method should return the string that describes the pagetype @abstract.

	has_option ()
	True if the page uses a custom option.

	is_unanswered ($nretakes)
	Checks to see if a page has been answered previously.

	is_unseen ($param)
	Returns true if a page has been viewed before.

	max_answers ($default)
	Returns the maximum number of answers for this page given the maximum number of answers permitted by the lesson.

	move ($nextpageid=null, $prevpageid=null)
	Moves a page by updating its nextpageid and prevpageid values within the database.

	on_after_write_attempt ($attempt, $result)
	Do any post persistence processing logic of an attempt.

	option_description_string ()
	Get the string that describes the options of this page type.

	override_next_page ()
	A callback method that allows a page to override the next page a user will see during when this page is being completed.

	properties ()
	Returns the properties of this lesson page as an object.

moodle_database	record_attempt ($context)
	Records an attempt at this page.

	report_answers ($answerpage, $answerdata, $useranswer, $pagestats, &$i, &$n)
	Formats the answers of this page for a report.

	requires_manual_grading ()
	Informs whether this page type require manual grading or not.

	save_answers_files ($context, $maxbytes, &$answer, $answereditor='', $responseeditor='')
	save editor answers files and update answer record

	stats (array &$pagestats, $tries)
	Adds stats for this page to the &pagestats object.

moodle_database	update ($properties, $context=null, $maxbytes=null)
	Updates the page and its answers.

	update_form_data (stdClass $data)
	Make updates to the form data if required.

	valid_page_and_view (&$validpages, &$pageviews)
	This method is used to determine if this page is a valid page.

Static Public Member Functions
static	create ($properties, lesson $lesson, $context, $maxbytes)
	Creates a new lesson_page within the database and returns the correct pagetype object to use to interact with the new lesson.

static	get_jumptooptions ($pageid, lesson $lesson)
	Returns an array of options to display when choosing the jumpto for a page/answer.

static	load ($id, lesson $lesson)
	This method loads a page object from the database and returns it as a specialised object that extends lesson_page.

static	rewrite_answers_urls ($answer, $rewriteanswer=true)
	Rewrite urls in response and optionality answer of a question answer.

Public Attributes
const	MULTIANSWER_DELIMITER = '@^#\|'
	Constant used as a delimiter when parsing multianswer questions.

const	TYPE_QUESTION = 0
	Constants used to identify the type of the page.

const	TYPE_STRUCTURE = 1

Protected Member Functions
	get_displayinmenublock ()
	Set to true if this page should display in the menu block.

	get_grayout ()
	Determines if this page should be grayed out on the management/report screens.

	get_jump_name ($jumpto)
	Returns the string for a jump name.

	get_lesson ()
	Returns the lesson this page is associated with @final.

	get_type ()
	Returns the type of page this is.

	make_answer_form ($attempt=null)

Protected Attributes
null array	$answers = null
	Contains the answers to this lesson_page once loaded.

lesson	$lesson = null
	A reference to the lesson this page belongs to.

stdClass	$properties
	An object containing properties.

	$string = null

	$type = lesson_page::TYPE_QUESTION

	$typeid = LESSON_PAGE_MATCHING

	$typeidstring = 'matching'

Member Function Documentation

◆ __get()

lesson_base::__get ( $key )

inherited

Magic get method.

Attempts to call a get_$key method to return the property and ralls over to return the raw property

Parameters

str $key

Return values

mixed

◆ __isset()

lesson_base::__isset ( $key )

inherited

Stupid PHP needs an isset magic method if you use the get magic method and still want empty calls to work....

blah ~!

Parameters

string $key

Return values

bool

◆ __set()

lesson_base::__set	(		$key,
			$value )

inherited

Magic property method.

Attempts to call a set_$key method if one exists otherwise falls back to simply set the property

Parameters

string	$key
mixed	$value

◆ add_page_link()

lesson_page::add_page_link ( $previd )

inherited

Can be set to true if the page requires a static link to create a new instance instead of simply being included in the dropdown.

Parameters

int $previd

Return values

bool

Reimplemented in lesson_page_type_branchtable, lesson_page_type_cluster, lesson_page_type_endofbranch, and lesson_page_type_endofcluster.

◆ callback_on_view()

lesson_page::callback_on_view	(		$canmanage,
			$redirect = true )

inherited

This is a callback method that can be override and gets called when ever a page is viewed.

Parameters

bool	$canmanage	True if the user has the manage cap
bool	$redirect	Optional, default to true. Set to false to avoid redirection and return the page to redirect.

Return values

mixed

Reimplemented in lesson_page_type_cluster, lesson_page_type_endofbranch, and lesson_page_type_endofcluster.

◆ check_answer()

lesson_page_type_matching::check_answer ( )

This method MUST be overridden by all question page types, or page types that wish to score a page.

The structure of result should always be the same so it is a good idea when overriding this method on a page type to call $result = parent\check_answer(); before modifying it as required.

Return values

stdClass

Reimplemented from lesson_page.

◆ create()

static lesson_page::create	(		$properties,
		lesson	$lesson,
			$context,
			$maxbytes )

staticfinalinherited

Creates a new lesson_page within the database and returns the correct pagetype object to use to interact with the new lesson.

@final

Parameters

object	$properties
lesson	$lesson

Return values

lesson_page Specialised object that extends lesson_page

◆ create_answers()

lesson_page_type_matching::create_answers ( $properties )

Creates answers within the database for this lesson_page.

Usually only ever called when creating a new page instance

Parameters

object $properties

Return values

array

Reimplemented from lesson_page.

◆ delete()

lesson_page::delete ( )

finalinherited

Deletes a lesson_page from the database as well as any associated records.

@final

Return values

bool

◆ display()

lesson_page_type_matching::display	(		$renderer,
			$attempt )

This method gets called to display the page to the user taking the lesson @abstract.

Parameters

object	$renderer
object	$attempt

Return values

string

Reimplemented from lesson_page.

◆ display_answers()

lesson_page_type_matching::display_answers ( html_table $table )

Updates a table with the answers for this page.

Parameters

html_table $table

Return values

html_table

Reimplemented from lesson_page.

◆ earned_score()

lesson_page::earned_score	(		$answers,
			$attempt )

inherited

Returns the score for the attempt This may be overridden by page types that require manual grading.

Parameters

array	$answers
object	$attempt

Return values

int

◆ format_answer()

lesson_page::format_answer	(	$answer,
		$context,
		$answerformat,
		$options = [] )

inherited

Formats the answer.

Override for custom formatting.

Parameters

string	$answer
context	$context
int	$answerformat

Return values

string Returns formatted string

Reimplemented in lesson_page_type_essay, and lesson_page_type_numerical.

◆ get_answers()

lesson_page::get_answers ( )

finalinherited

Returns the answers that are associated with this page in the database.

@final

Return values

array

◆ get_contents()

lesson_page::get_contents ( )

inherited

Returns the contents field for the page properly formatted and with plugin file url's converted.

Return values

string

◆ get_displayinmenublock()

lesson_page::get_displayinmenublock ( )

protectedinherited

Set to true if this page should display in the menu block.

Return values

bool

Reimplemented in lesson_page_type_branchtable.

◆ get_files()

lesson_page::get_files	(		$includedirs = true,
			$updatedsince = 0 )

inherited

Get files from the page area file.

Parameters

bool	$includedirs	whether or not include directories
int	$updatedsince	return files updated since this time

Return values

array list of stored_file objects

Since: Moodle 3.2

◆ get_grayout()

lesson_page::get_grayout ( )

protectedinherited

Determines if this page should be grayed out on the management/report screens.

Return values

int 0 or 1

Reimplemented in lesson_page_type_branchtable, lesson_page_type_cluster, lesson_page_type_endofbranch, and lesson_page_type_endofcluster.

◆ get_jump_name()

lesson_page::get_jump_name ( $jumpto )

finalprotectedinherited

Returns the string for a jump name.

@final

Parameters

int $jumpto Jump code or page ID

Return values

string

◆ get_jumps()

lesson_page_type_matching::get_jumps ( )

Gets an array of the jumps used by the answers of this page.

Return values

array

Reimplemented from lesson_page.

◆ get_jumptooptions()

static lesson_page::get_jumptooptions	(		$pageid,
		lesson	$lesson )

staticinherited

Returns an array of options to display when choosing the jumpto for a page/answer.

Parameters

int	$pageid
lesson	$lesson

Return values

array

Reimplemented in lesson_page_type_branchtable.

◆ get_lesson()

lesson_page::get_lesson ( )

finalprotectedinherited

Returns the lesson this page is associated with @final.

Return values

lesson

◆ get_type()

lesson_page::get_type ( )

finalprotectedinherited

Returns the type of page this is.

Not to be confused with page type @final

Return values

int

◆ get_typeid()

lesson_page_type_matching::get_typeid ( )

This method should return the integer used to identify the page type within the database and throughout code.

This maps back to the defines used in 1.x @abstract

Return values

int

Reimplemented from lesson_page.

◆ get_typestring()

lesson_page_type_matching::get_typestring ( )

This method should return the string that describes the pagetype @abstract.

Return values

string

Reimplemented from lesson_page.

◆ has_option()

lesson_page::has_option ( )

inherited

True if the page uses a custom option.

Should be override and set to true if the page uses a custom option.

Return values

bool

◆ is_unanswered()

lesson_page::is_unanswered ( $nretakes )

inherited

Checks to see if a page has been answered previously.

Parameters

int $nretakes

Return values

bool

Reimplemented in lesson_page_type_essay.

◆ is_unseen()

lesson_page::is_unseen ( $param )

inherited

Returns true if a page has been viewed before.

Parameters

array | int $param Either an array of pages that have been seen or the number of retakes a user has had

Return values

bool

Reimplemented in lesson_page_type_branchtable.

◆ load()

static lesson_page::load	(		$id,
		lesson	$lesson )

staticfinalinherited

This method loads a page object from the database and returns it as a specialised object that extends lesson_page.

@final

Parameters

int	$id
lesson	$lesson

Return values

lesson_page Specialised lesson_page object

◆ max_answers()

lesson_page::max_answers ( $default )

inherited

Returns the maximum number of answers for this page given the maximum number of answers permitted by the lesson.

Parameters

int $default

Return values

int

◆ move()

lesson_page::move	(		$nextpageid = null,
			$prevpageid = null )

finalinherited

Moves a page by updating its nextpageid and prevpageid values within the database.

@final

Parameters

int	$nextpageid
int	$prevpageid

◆ on_after_write_attempt()

lesson_page::on_after_write_attempt	(		$attempt,
			$result )

inherited

Do any post persistence processing logic of an attempt.

E.g. in cases where we need update file urls in an editor and we need to have the id of the stored attempt. Should be overridden in each individual child pagetype on a as required basis

Parameters

object	$attempt	The attempt corresponding to the db record
object	$result	The result from the 'check_answer' method

Return values

array False if nothing to be modified, updated $attempt and $result if update required.

Reimplemented in lesson_page_type_essay.

◆ option_description_string()

lesson_page_type_matching::option_description_string ( )

Get the string that describes the options of this page type.

Return values

string

Reimplemented from lesson_page.

◆ override_next_page()

lesson_page::override_next_page ( )

inherited

A callback method that allows a page to override the next page a user will see during when this page is being completed.

Return values

false|int

Reimplemented in lesson_page_type_cluster, and lesson_page_type_endofcluster.

◆ properties()

lesson_page::properties ( )

inherited

Returns the properties of this lesson page as an object.

Return values

stdClass;

Reimplemented from lesson_base.

◆ record_attempt()

moodle_database lesson_page::record_attempt ( $context )

finalinherited

Records an attempt at this page.

@final $DB

Parameters

stdClass $context

Return values

stdClass Returns the result of the attempt

◆ report_answers()

lesson_page_type_matching::report_answers	(		$answerpage,
			$answerdata,
			$useranswer,
			$pagestats,
		&	$i,
		&	$n )

Formats the answers of this page for a report.

Parameters

object	$answerpage
object	$answerdata
object	$useranswer
array	$pagestats
int	$i	Count of first level answers
int	$n	Count of second level answers

Return values

object The answer page for this

Reimplemented from lesson_page.

◆ requires_manual_grading()

lesson_page::requires_manual_grading ( )

inherited

Informs whether this page type require manual grading or not.

Return values

bool

Reimplemented in lesson_page_type_essay.

◆ rewrite_answers_urls()

static lesson_page::rewrite_answers_urls	(		$answer,
			$rewriteanswer = true )

staticinherited

Rewrite urls in response and optionality answer of a question answer.

Parameters

object	$answer
bool	$rewriteanswer	must rewrite answer

Return values

object answer with rewritten urls

◆ save_answers_files()

lesson_page::save_answers_files	(		$context,
			$maxbytes,
		&	$answer,
			$answereditor = '',
			$responseeditor = '' )

inherited

save editor answers files and update answer record

Parameters

object	$context
int	$maxbytes
object	$answer
object	$answereditor
object	$responseeditor

◆ stats()

lesson_page_type_matching::stats	(	array &	$pagestats,
			$tries )

Adds stats for this page to the &pagestats object.

This should be defined for all page types that grade

Parameters

array	$pagestats
int	$tries

Return values

bool

Reimplemented from lesson_page.

◆ update()

moodle_database lesson_page_type_matching::update	(	$properties,
		$context = null,
		$maxbytes = null )

Updates the page and its answers.

$DB @global moodle_page $PAGE

Parameters

stdClass $properties

Return values

bool

Reimplemented from lesson_page.

◆ update_form_data()

lesson_page::update_form_data ( stdClass $data )

inherited

Make updates to the form data if required.

Since: Moodle 3.7

Parameters

stdClass $data The form data to update.

Return values

stdClass The updated fom data.

Reimplemented in lesson_page_type_numerical, and lesson_page_type_shortanswer.

◆ valid_page_and_view()

lesson_page::valid_page_and_view	(	&	$validpages,
		&	$pageviews )

inherited

This method is used to determine if this page is a valid page.

Parameters

array	$validpages
array	$pageviews

Return values

int	The next page id to check

Reimplemented in lesson_page_type_cluster, lesson_page_type_endofbranch, and lesson_page_type_endofcluster.

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

mod/lesson/pagetypes/matching.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Member Function Documentation

◆ __get()

◆ __isset()

◆ __set()

◆ add_page_link()

◆ callback_on_view()

◆ check_answer()

◆ create()

◆ create_answers()

◆ delete()

◆ display()

◆ display_answers()

◆ earned_score()

◆ format_answer()

◆ get_answers()

◆ get_contents()

◆ get_displayinmenublock()

◆ get_files()

◆ get_grayout()

◆ get_jump_name()

◆ get_jumps()

◆ get_jumptooptions()

◆ get_lesson()

◆ get_type()

◆ get_typeid()

◆ get_typestring()

◆ has_option()

◆ is_unanswered()

◆ is_unseen()

◆ load()

◆ max_answers()

◆ move()

◆ on_after_write_attempt()

◆ option_description_string()

◆ override_next_page()

◆ properties()

◆ record_attempt()

◆ report_answers()

◆ requires_manual_grading()

◆ rewrite_answers_urls()

◆ save_answers_files()

◆ stats()

◆ update()

◆ update_form_data()

◆ valid_page_and_view()