Public Member Functions
	__construct (stdClass $options)
	Construct function of comment class, initialise class members. More...

moodle_database	add ($content, $format=FORMAT_MOODLE)
	Add a new comment. More...

	can_delete ($comment)
	Returns true if the user can delete this comment. More...

	can_post ()
	Returns true if the user can add comments against this comment description. More...

	can_view ()
	Returns true if the user is able to view comments. More...

moodle_database	count ()
	Returns the number of comments associated with the details of this object. More...

	delete ($comment)
	Delete a comment. More...

	get_autostart ()
	Return autostart. More...

	get_cid ()
	Return the cid. More...

	get_cm ()
	Returns the course module associated with the comment. More...

	get_commentarea ()
	Returns the comment area associated with the commentarea. More...

	get_comments ($page='', $sortdirection='DESC')
	Return matched comments. More...

	get_component ()
	Returns the component associated with the comment. More...

	get_compontent ()
	Do not call! I am a deprecated method because of the typo in my name. More...

	get_context ()
	Returns the context associated with the comment. More...

	get_courseid ()
	Returns the course id associated with the comment. More...

	get_displaycancel ()
	Return display cancel. More...

	get_displaytotalcount ()
	Return display total count. More...

	get_fullwidth ()
	Return fullwidth. More...

	get_itemid ()
	Returns the item id associated with the comment. More...

	get_linktext ()
	Return the link text. More...

moodle_page	get_nojslink (moodle_page $page=null)
	Gets a link for this page that will work with JS disabled. More...

	get_notoggle ()
	Return no toggle. More...

stdClass	get_pagination ($page=0)
	Returns HTML to display a pagination bar. More...

	get_template ()
	Return the template. More...

	initialise_javascript (moodle_page $page)
	Initialises the JavaScript that enchances the comment API. More...

	output ($return=true)
	Prepare comment code in html. More...

core_renderer	print_comment ($cmt, $nonjs=true)
	Returns an array containing comments in HTML format. More...

	print_comments ($page=0, $return=true, $nonjs=true)
	Print comments. More...

	set_autostart ($newvalue=true)
	Sets the value of the autostart option. More...

	set_component ($component)
	Sets the component. More...

	set_displaycancel ($newvalue=true)
	Sets the displaycancel option. More...

	set_displaytotalcount ($newvalue=true)
	Sets the displaytotalcount option. More...

	set_fullwidth ($fullwidth=true)
	Make the comments textarea fullwidth. More...

	set_notoggle ($newvalue=true)
	Sets the value of the notoggle option. More...

	set_post_permission ($value)
	Determines if the user can post a comment. More...

	set_view_permission ($value)
	Determines if the user can view the comment. More...

Static Public Member Functions
static	delete_comments ($param)
	delete by context, commentarea and itemid More...

static	init (moodle_page $page=null)
	Receive nonjs comment parameters. More...

static	reset_course_page_comments ($context)
	Delete page_comments in whole course, used by course reset. More...

Protected Member Functions
	get_component_select_sql ($alias='')
	Returns an SQL fragment and param for selecting on component. More...

	validate ($params=array())
	Revoke validate callbacks. More...

Protected Attributes
bool	$autostart = false
	If set to true comments are automatically loaded as soon as the page loads.

bool	$displaycancel = false
	If set to true a cancel button will be shown on the form used to submit comments.

bool	$displaytotalcount = false
	If set to true the total count of comments is displayed when displaying comments.

bool	$fullwidth = false
	Set to true to remove the col attribute from the textarea making it full width.

bool	$notoggle = false
	If set to true then comment sections won't be able to be opened and closed instead they will always be visible.

int	$totalcommentcount = null
	The number of comments associated with this comments params.

Constructor & Destructor Documentation

◆ __construct()

comment::__construct ( stdClass $options )

Construct function of comment class, initialise class members.

Parameters

stdClass $options { context => context context to use for the comment [required] component => string which plugin will comment being added to [required] itemid => int the id of the associated item (forum post, glossary item etc) [required] area => string comment area cm => stdClass course module course => course course object client_id => string an unique id to identify comment area autostart => boolean automatically expend comments showcount => boolean display the number of comments displaycancel => boolean display cancel button notoggle => boolean don't show/hide button linktext => string title of show/hide button }

Member Function Documentation

◆ add()

moodle_database comment::add	(	$content,
		$format = `FORMAT_MOODLE`
	)

Add a new comment.

$DB

Parameters

string	$content
int	$format

Return values

stdClass

◆ can_delete()

comment::can_delete ( $comment )

Returns true if the user can delete this comment.

The user can delete comments if it is one they posted and they can still make posts, or they have the capability to delete comments.

A database call is avoided if a comment record is passed.

Parameters

int | stdClass $comment The id of a comment, or a comment record.

Return values

bool

◆ can_post()

comment::can_post ( )

Returns true if the user can add comments against this comment description.

Return values

bool

◆ can_view()

comment::can_view ( )

Returns true if the user is able to view comments.

Return values

bool

◆ count()

moodle_database comment::count ( )

Returns the number of comments associated with the details of this object.

$DB

Return values

int

◆ delete()

comment::delete ( $comment )

Delete a comment.

Parameters

int | stdClass $comment The id of a comment, or a comment record.

Return values

bool

◆ delete_comments()

static comment::delete_comments ( $param )

static

delete by context, commentarea and itemid

Parameters

stdClass | array $param { contextid => int the context in which the comments exist [required] commentarea => string the comment area [optional] itemid => int comment itemid [optional] }

Return values

boolean

◆ get_autostart()

comment::get_autostart ( )

Return autostart.

Since: 3.1

Return values

bool

◆ get_cid()

comment::get_cid ( )

Return the cid.

Since: 3.1

Return values

string

◆ get_cm()

comment::get_cm ( )

Returns the course module associated with the comment.

Return values

stdClass

◆ get_commentarea()

comment::get_commentarea ( )

Returns the comment area associated with the commentarea.

Return values

stdClass

◆ get_comments()

comment::get_comments	(	$page = `''`,
		$sortdirection = `'DESC'`
	)

Return matched comments.

Parameters

int	$page
str	$sortdirection	sort direction, ASC or DESC

Return values

array

◆ get_component()

comment::get_component ( )

Returns the component associated with the comment.

Return values

string

◆ get_component_select_sql()

comment::get_component_select_sql ( $alias = '' )

protected

Returns an SQL fragment and param for selecting on component.

Parameters

string $alias

Return values

array

◆ get_compontent()

comment::get_compontent ( )

Do not call! I am a deprecated method because of the typo in my name.

Deprecated:: since 2.9

See also: comment::get_component()

Return values

string

◆ get_context()

comment::get_context ( )

Returns the context associated with the comment.

Return values

stdClass

◆ get_courseid()

comment::get_courseid ( )

Returns the course id associated with the comment.

Return values

int

◆ get_displaycancel()

comment::get_displaycancel ( )

Return display cancel.

Since: 3.1

Return values

bool

◆ get_displaytotalcount()

comment::get_displaytotalcount ( )

Return display total count.

Since: 3.1

Return values

bool

◆ get_fullwidth()

comment::get_fullwidth ( )

Return fullwidth.

Since: 3.1

Return values

bool

◆ get_itemid()

comment::get_itemid ( )

Returns the item id associated with the comment.

Return values

int

◆ get_linktext()

comment::get_linktext ( )

Return the link text.

Since: 3.1

Return values

string

◆ get_nojslink()

moodle_page comment::get_nojslink ( moodle_page $page = null )

Gets a link for this page that will work with JS disabled.

$PAGE

Parameters

moodle_page $page

Return values

moodle_url

◆ get_notoggle()

comment::get_notoggle ( )

Return no toggle.

Since: 3.1

Return values

bool

◆ get_pagination()

stdClass comment::get_pagination ( $page = 0 )

Returns HTML to display a pagination bar.

$CFG @global core_renderer $OUTPUT

Parameters

int $page

Return values

string

◆ get_template()

comment::get_template ( )

Return the template.

Since: 3.1

Return values

string

◆ init()

static comment::init ( moodle_page $page = null )

static

Receive nonjs comment parameters.

Parameters

moodle_page $page The page object to initialise comments within If not provided the global $PAGE is used

◆ initialise_javascript()

comment::initialise_javascript ( moodle_page $page )

Initialises the JavaScript that enchances the comment API.

Parameters

moodle_page $page The moodle page object that the JavaScript should be initialised for.

◆ output()

comment::output ( $return = true )

Prepare comment code in html.

Parameters

boolean $return

Return values

string|void

◆ print_comment()

core_renderer comment::print_comment	(	$cmt,
		$nonjs = `true`
	)

Returns an array containing comments in HTML format.

$OUTPUT

Parameters

stdClass	$cmt	{ id => int comment id content => string comment content format => int comment text format timecreated => int comment's timecreated profileurl => string link to user profile fullname => comment author's full name avatar => string user's avatar delete => boolean does user have permission to delete comment? }
bool	$nonjs

Return values

array

◆ print_comments()

comment::print_comments	(	$page = `0`,
		$return = `true`,
		$nonjs = `true`
	)

Print comments.

Parameters

int	$page
bool	$return	return comments list string or print it out
bool	$nonjs	print nonjs comments list or not?

Return values

string|void

◆ reset_course_page_comments()

static comment::reset_course_page_comments ( $context )

static

Delete page_comments in whole course, used by course reset.

Parameters

stdClass $context course context

◆ set_autostart()

comment::set_autostart ( $newvalue = true )

Sets the value of the autostart option.

If set to true then the comments will be loaded during page load. Normally this happens only once the user expands the comment section.

Parameters

bool $newvalue

◆ set_component()

comment::set_component ( $component )

Sets the component.

This method shouldn't be public, changing the component once it has been set potentially invalidates permission checks. A coding_error is now thrown if code attempts to change the component.

Exceptions

coding_exception if you try to change the component after it has been set.

Parameters

string $component

◆ set_displaycancel()

comment::set_displaycancel ( $newvalue = true )

Sets the displaycancel option.

If set to true then a cancel button will be shown when using the form to post comments.

Parameters

bool $newvalue

◆ set_displaytotalcount()

comment::set_displaytotalcount ( $newvalue = true )

Sets the displaytotalcount option.

If set to true then the total number of comments will be displayed when printing comments.

Parameters

bool $newvalue

◆ set_fullwidth()

comment::set_fullwidth ( $fullwidth = true )

Make the comments textarea fullwidth.

Since: 2.8.1 + 2.7.4

Parameters

bool $fullwidth

◆ set_notoggle()

comment::set_notoggle ( $newvalue = true )

Sets the value of the notoggle option.

If set to true then the user will not be able to expand and collase the comment section.

Parameters

bool $newvalue

◆ set_post_permission()

comment::set_post_permission ( $value )

Determines if the user can post a comment.

Parameters

bool $value

◆ set_view_permission()

comment::set_view_permission ( $value )

Determines if the user can view the comment.

Parameters

bool $value

◆ validate()

comment::validate ( $params = array() )

protected

Revoke validate callbacks.

Parameters

stdClass $params addtionall parameters need to add to callbacks

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

comment/lib.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ add()

◆ can_delete()

◆ can_post()

◆ can_view()

◆ count()

◆ delete()

◆ delete_comments()

◆ get_autostart()

◆ get_cid()

◆ get_cm()

◆ get_commentarea()

◆ get_comments()

◆ get_component()

◆ get_component_select_sql()

◆ get_compontent()

◆ get_context()

◆ get_courseid()

◆ get_displaycancel()

◆ get_displaytotalcount()

◆ get_fullwidth()

◆ get_itemid()

◆ get_linktext()

◆ get_nojslink()

◆ get_notoggle()

◆ get_pagination()

◆ get_template()

◆ init()

◆ initialise_javascript()

◆ output()

◆ print_comment()

◆ print_comments()

◆ reset_course_page_comments()

◆ set_autostart()

◆ set_component()

◆ set_displaycancel()

◆ set_displaytotalcount()

◆ set_fullwidth()

◆ set_notoggle()

◆ set_post_permission()

◆ set_view_permission()

◆ validate()