Inheritance diagram for lesson_page:

Public Member Functions
	__construct ($properties, lesson $lesson)
	Constructor method.

	__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_jumps ()
	Gets an array of the jumps used by the answers of this page.

	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.

	update ($properties, $context=null, $maxbytes=null)
	Updates a lesson page and its answers within the database.

	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.

	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.

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.

int	$type = 0
	This sets the type of the page, can be one of the constants defined below.

Constructor & Destructor Documentation

◆ __construct()

lesson_page::__construct	(		$properties,
		lesson	$lesson )

Constructor method.

Parameters

object	$properties
lesson	$lesson

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 )

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 )

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::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 in lesson_page_type_branchtable, lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_multichoice, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ create()

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

staticfinal

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::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 in lesson_page_type_cluster, lesson_page_type_endofbranch, lesson_page_type_endofcluster, lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_numerical, and lesson_page_type_shortanswer.

◆ delete()

lesson_page::delete ( )

final

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

@final

Return values

bool

◆ display()

lesson_page::display	(		$renderer,
			$attempt )

abstract

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

Parameters

object	$renderer
object	$attempt

Return values

string

Reimplemented in lesson_page_type_branchtable, lesson_page_type_cluster, lesson_page_type_endofbranch, lesson_page_type_endofcluster, lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_multichoice, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ display_answers()

lesson_page::display_answers ( html_table $table )

Updates a table with the answers for this page.

Parameters

html_table $table

Return values

html_table

Reimplemented in lesson_page_type_branchtable, lesson_page_type_matching, lesson_page_type_multichoice, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ earned_score()

lesson_page::earned_score	(		$answers,
			$attempt )

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 = [] )

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 ( )

final

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

@final

Return values

array

◆ get_contents()

lesson_page::get_contents ( )

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 ( )

protected

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 )

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 ( )

protected

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 )

finalprotected

Returns the string for a jump name.

@final

Parameters

int $jumpto Jump code or page ID

Return values

string

◆ get_jumps()

lesson_page::get_jumps ( )

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

Return values

array

Reimplemented in lesson_page_type_branchtable, lesson_page_type_matching, and lesson_page_type_multichoice.

◆ get_jumptooptions()

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

static

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 ( )

finalprotected

Returns the lesson this page is associated with @final.

Return values

lesson

◆ get_type()

lesson_page::get_type ( )

finalprotected

Returns the type of page this is.

Not to be confused with page type @final

Return values

int

◆ get_typeid()

lesson_page::get_typeid ( )

abstractprotected

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 in lesson_page_type_branchtable, lesson_page_type_cluster, lesson_page_type_endofbranch, lesson_page_type_endofcluster, lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_multichoice, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ get_typestring()

lesson_page::get_typestring ( )

abstractprotected

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

Return values

string

Reimplemented in lesson_page_type_branchtable, lesson_page_type_cluster, lesson_page_type_endofbranch, lesson_page_type_endofcluster, lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_multichoice, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ has_option()

lesson_page::has_option ( )

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 )

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 )

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 )

staticfinal

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 )

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 )

final

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 )

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::option_description_string ( )

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

Return values

string

Reimplemented in lesson_page_type_matching, lesson_page_type_multichoice, and lesson_page_type_shortanswer.

◆ override_next_page()

lesson_page::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.

Return values

false|int

Reimplemented in lesson_page_type_cluster, and lesson_page_type_endofcluster.

◆ properties()

lesson_page::properties ( )

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 )

final

Records an attempt at this page.

@final $DB

Parameters

stdClass $context

Return values

stdClass Returns the result of the attempt

◆ report_answers()

lesson_page::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 in lesson_page_type_branchtable, lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_multichoice, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ requires_manual_grading()

lesson_page::requires_manual_grading ( )

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 )

static

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 = '' )

save editor answers files and update answer record

Parameters

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

◆ stats()

lesson_page::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 in lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_multichoice, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ update()

lesson_page::update	(	$properties,
		$context = null,
		$maxbytes = null )

Updates a lesson page and its answers within the database.

Parameters

object $properties

Return values

bool

Reimplemented in lesson_page_type_branchtable, lesson_page_type_essay, lesson_page_type_matching, lesson_page_type_numerical, lesson_page_type_shortanswer, and lesson_page_type_truefalse.

◆ update_form_data()

lesson_page::update_form_data ( stdClass $data )

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 )

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/locallib.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

◆ __construct()

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()